|
|
This page describes how to configure your Windows laptop for use with the 2006 NVO Summer School software.
We recommend Windows XP. If you are running an earlier version, you may find that there are compatibility issues with some of the software.
You should enter commands given below into a Command Prompt window or equivalent.
If you have installed the Microsoft SDK or Visual Studio .NET, you can use the where command to check if an executable is in your path; otherwise you will have examine the directories in your path: for example, to see if the java executable is in your path:
C:\>where java C:\WINDOWS\system32\java.exe
or
C:\>set path Path=C:\j2sdk1.4.2\bin:... C:\>dir C:\j2sdk1.4.2\bin Directory of C:\j2sdk1.4.2\bin ... 07/22/2003 09:36 AM 24,670 java.exe ...
If you want to check the value of an environment variable, you can just use the set command with the name of the variable:
C:\>set JAVA_HOME JAVA_HOME=C:\j2sdk1.4.2
If you need to set an environment variable, you can just use set with the name of the variable and its value:
C:\>set JAVA_HOME=C:\WINDOWS\j2sdk1.4.2Note that if the value of the environment variable contains spaces, you should not enclose it in quotation marks.
Alternatively, if you want to set it more permanently, go to Control Panel->System, click on the Advanced tab and the bottom you will see a button marked Environment Variables. Clicking on this will open a window where you can add or edit variables for the system or for your account. Note that these changes will only apply to new windows and not to any currently open.
Please note that although Windows may seem case insensitive with regard to environment variables, it is still important that any environment variables specified in these instructions are set as written, i.e. all in caps.
All the files that you might need to download are packaged as zip files. By default, a zipped file on your laptop should appear as a zipped icon and you can unzip it by selecting Extract All... from the menu options that a right mouse click brings up. If you have a utility such as WinZip installed then this might unpack the zip file for you automatically.
The basic setup is just three system components: Java 1.5, Python 2.4.3 and MySQL 5.0.
The recommended version of Java is 1.5.0: to see what version, if any, is already installed:
C:\>java -version java version "1.5.0" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0-b12) Java HotSpot(TM) Client VM (build 1.5.0-b12, mixed mode, sharing)
If necessary, you can get an appropriate Java SDK from Sun here (download JDK 5.0 Update 8).
You should also make sure that the environment variable JAVA_HOME is pointing at the location of your current Java installation:
C:/>set JAVA_HOME JAVA_HOME=C:\WINDOWS\j2sdk1.4.2
If it is not, you should set it:
C:/>set JAVA_HOME='location of your current Java installation'
Generally it's a good idea to set this in your normal environment setup using the Control Panel->System->Advanced->Environment Variables route mentioned above.
The recommended version of Python is 2.4.3 (although 2.4.0 or greater is acceptable): to see what version, if any, is already installed, make sure that the python executable is in your path and then:
C:\>python -V Python 2.4.1
If necessary, you can obtain an appropriate version of Python from here.
You should install with the default settings.
Python provides both a command line interface and a GUI interface.
Three additional Python modules are required for the summer school:
fpconst provides constants and functions to deal with IEEE754 double-precision special values. It is available here. Once you have unpacked the compressed tar ball, you can install it by changing to the fpconst directory and typing:
C:\>python setup.py install
SOAPpy provides client-server libraries for web programming using SOAP and related protocols. It is available here. You should actually download v0.11.6 (available under the Latest official release (0.11.5) link). Once you have unpacked the compressed tar ball, you can install it by changing to the SOAPpy-0.11.6 directory and typing:
C:\>python setup.py install
MySQL-python provides access to a MySQL database. It is available here. You should download MySQL-python-1.2.0.win32-py2.4.zip which contains an installer.
The Python sample code in python/voAgent requires the Python Imaging Library. It is available here.You should download Python Imaging Library 1.1.5 for Python 2.4 which contains an installer.
You should also set the %PYTHONPATH% environment variable to include %NVOSS_HOME%\python\lib and %NVOSS_HOME%\python\sample.
To test that your Python installation is correctly setup:
>python Python 2.4.1 (#8, Apr 7 2005, 17:15:16) [GCC 3.3 20030304 (Apple Computer, Inc. build 1666)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import SOAPpy >>> import fpconst >>> import MySQLdb >>> import Image
You should also set the %PYTHONPATH% environment variable to include %NVOSS_HOME%\python\lib and %NVOSS_HOME%\python\sample.
The recommended version of MySQL is 5.0.22: to see what version, if any, is already installed, make sure that the mysql executable is in your path and then:
C:\>mysql --version mysql Ver 14.12 Distrib 5.0.22, for Win32 (ia32)
The value after the Distrib keyword is actually the version number: anything later than '5.0.15' is fine.
If necessary, you can get an appropriate version of MySQL from here (select the Windows (x86) package).
You should Save the downloaded file to somewhere suitable on your laptop. Once the download is complete, you can start the Setup Wizard by double clicking on the downloaded file icon. You should select a Typical setup and Skip Sign-Up after the install. You should also make sure Configure the MySQL Server now is checked before finishing the Setup Wizard.
The MySQL Server Instance Configuration Wizard should launch automatically (if it does not, the zip file contains a setup.exe which you should double click on) and you should select a Standard Configuration. Make sure that Include Bin Directory in Windows PATH is checked. You should then check Create An Anonymous Account and uncheck Modify Security Settings - you will need to do these in this order. You can then Execute and exit the Configuration Wizard.
MySQL provides a Command Line Client - look under All Programs->MySQL->->MySQL Server 5.0 - when prompted for the password, just hit Return. Of course, you can also just use the mysql executable from any Command Prompt window.
It is recommended to set a password for the MySQL root user (note that this is different from the system administrator). If you are have logged into MySQL with the Command Line Client then:
mysql> UPDATE mysql.user SET Password = PASSWORD('newpassword') WHERE User = 'root';
mysql> FLUSH PRIVILEGES;
otherwise type:
C:\> mysql -u root
mysql> UPDATE mysql.user SET Password = PASSWORD('newpassword') WHERE User = 'root';
mysql> FLUSH PRIVILEGES;
where you should replace "hostname" with the name of your laptop. You will need to remember the password for future database operations.
Note that the MySQL JDBC driver may require that the SystemRoot be specified when it is called from a CGI script. If you have set up Windows with System root as something other than C:\WINDOWS, then you will need to fix scripts accordingly.
Now you are ready to install the software package.
You will need to set the environment variable NVOSS_HOME to the top level directory of the software tree, e.g. nvoss2006 in your home directory and then run the setup script:
C:\>cd %NVOSS_HOME% C:\>bin\setup
To verify the installation, change to the java subdirectory and type:
>ant
You should then see:
Buildfile: build.xml
init:
[mkdir] Created dir: ...\test\classes
compile:
[echo] building
[javac] Compiling 1 source file to ...\test\classes
test:
[junit] Testsuite: sumsch.TestInstall
[junit] Tests run: 3, Failures: 0, Errors: 0, Time elapsedL 0.375 src
clean:
[delete] Deleting directory ...test\classes
BUILD SUCCESSFUL
You are all ready to go now.
Note: If you want to use VOPlot3D then you will need to install the Java3D package. This is available at: Java 3D 1.3.1 for Windows
You can obtain the .NET Framework SDK for C# development from Microsoft here.
If you would prefer a platform independent distribution, you can use Mono, the open source C# platform, from here.
The recommended version of Mono is 1.1.13: to see what version, if any, is already installed, make sure that the mono executable is in your path (Mono comes with its own version of Command Prompt which has the necessary environment variables set) and then:
C:\>mono -V Mono JIT compiler version 1.1.13, (C) 2002-2005 Novell, Inc and Contributors. www.mono -project.com
Anything beginning '1.1.13' is fine.
If you want to develop C# code with .NET to access MySQL, you will also need to download the MySQL Connector/Net AB from MySQL here.
If you want to use MySQL with Mono, you will need to download the MySQL Connector/NET from MySQL here.
The recommended version of IDL is 6.2 or 6.3: to see what version, if any, is already installed, make sure the idl executable is in your path and then:
C:\>idlde IDL Version 6.2, Microsoft Windows (Win32 x86 m32) (c) 2004, Research Systems, Inc.
Anything beginning '6.2' or '6.3' is fine. 6.1 should also work.
If necessary, you can obtain an appropriate version of IDL from RSI here, although you will need to register first. However, distribution CDs and an appropriate licence will be available at the summer school.
The 2006 NVOSS uses a highly customized distribution of IRAF to simplify the installation process for students, and as a temporary means of distributing new software. Users who already have an IRAF system on their machine are encouraged to, at least for the duration of the NVOSS, rename the root /iraf link (or directory) to preserve their current installation and use the setup script provided to install the NVOSS distribution as their default system while in Aspen.
The recommended version of IRAF is 2.13: to see what version, if any, is already installed, make sure that the cl command is in your path and then:
You can install the appropriate version of IRAF by running the $NVOSS_HOME/iraf/iraf_setup.csh script in the summer school software package from the directory in which you wish to install the IRAF tree. This may be the iraf directory in the $NVOSS_HOME itself. For instance:
>cd $NVOSS_HOME/iraf >csh -f ./iraf_setup.csh
Once the system has been installed you can verify that the 'cl' startup command refers to the proper version using the commands:
cl> =cl.version IRAF V2.13 Aug 2006 cl> head hlib$motd nl=2 IRAFNET PC-IRAF Revision 2.13-BETA3 Fri Aug 18 14:22:14 MST 2006 This is the IRAFNET version of IRAF V2.13 supporting PC systems.
Note that approximately 500Mb of free space is required for the full IRAF release (including various external packages installed as part of the distribution).
NOTE FOR WINDOWS XP USERS: The IRAF release used for NVOSS is available for Windows XP systems running Cygwin (www.cygwin.com). The default Cygwin installation is sufficient for running the system, a C-shell and X11 environment are required and should be part of the base cygwin system.
Installation problems and questions may be directed to fitz@noao.edu
The recommended version of Perl is 5.8 (although 5.6 or greater is acceptable): to see what version, if any, is already installed, make sure that the perl executable is in your path and then:
>perl -v This is perl, v5.8.7 built for MSWin32-x86-multi-thread (with 7 registered patches, see perl -V for more detail)
If necessary, you can obtain an appropriate distribution of Perl from here.
The recommended version of PHP is 5 (although 4.3 or later is acceptable): to see what version, if any, is already installed, make sure that the php executable is in your path:
C:\>php -version PHP 5.0.4 (cli) (built:31 Mar 2005 02:45:48) Copyright (c) 1997-2004 The PHP Group Zend Engine v2.0.4-dev, Copyright (c) 1998-2004 Zend Technologies
If necessary, you can obtain an appropriate version of PHP here.
The NVO Summer School is made possible through the support of the National Science Foundation and the National Aeronautics and Space Administration.
 |
 |