|
Science With the Virtual Observatory |
This page describes how to configure your Windows laptop for use with the 2005 NVO Summer School software.
We recommend Windows XP. If you are running an earlier version, you may find that t here 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.2
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 wi ndows and not to any currently open.
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 s electing Extract All... from the menu options that a right mouse click brings up. I f you have a utility such as WinZip installed then this might unpack the zip fil e for you automatically.
The basic setup is just two system components: Java 1.4 and MySQL.
The recommended version of Java is 1.4.2: to see what version, if any, is already ins talled:
C:\>java -version java version "1.4.2" Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2-b28) Java HotSpot(TM) Client VM (build 1.4.2-b28, mixed mode)
If necessary, you can get an appropriate Java SDK from Sun here.
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 ab ove.
If you are interested in using Java 1.5 instead, check the instructions here. Note that Java 1.5 is known to have certain dependencies which can be i ncompatible with current VO software.
The recommended version of MySQL is 4.1.13: 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.7 Distrib 4.1.13, for Win32 (ia32)
The value after the Distrib keyword is actually the version number: anything later than '4.1.7' is fine.
If necessary, you can get an appropriate version of MySQL from here.
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 t he 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 chec ked before finishing the Setup Wizard.
The MySQL Server Instance Configuration Wizard will launch automatically and y ou 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 4.1 - 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 d ifferent from the system administrator). If you are have logged into MySQL with the Command Line Client then:
mysql>set password for 'root'@'localhost' = PASSWORD('newpassword');
mysql>set password for 'root'@'%' = PASSWORD('newpassword');
otherwise type:
C:\>mysqladmin -u root password "newpassword" C:\>mysqladmin -u root -h "hostname" password "newpassword"
where you should replace hostname with the name of your laptop. You will need to remember the password for future database operations.
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. nvoss2005 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 s ource C# platform, from here.
You should select a Full installation.
The recommended version of Mono is 1.1.8: to see what version, if any, is already ins talled, 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 t hen:
C:\>mono -V Mono JIT compiler version 1.1.8, (C) 2002-2005 Novell, Inc and Contributors. www.mono -project.com
Anything beginning '1.1.8' 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 Microsoft here.
The recommended version of IDL is 6.1: 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.1.1, Microsoft Windows (Win32 x86 m32) (c) 2004, Research Systems, Inc.
Anything beginning '6.1' is fine.
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.
IRAF is not available under Windows. However, if you want to develop with IRAF, accou nts on a remote IRAF server will be available at the summer school.
You can get an appropriate Java SDK from Sun here.
If you are going to be developing web services in Java 1.5, you should probably also install Tomcat 5.5.9 which is available from Apache here.
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 recommended version of Python is 2.4.1: to see what version, if any, is already i nstalled, 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.
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
You should also set the %PYTHONPATH% environment variable to include %NVOSS_HOME%\python\lib and %NVOSS_HOME%\python\sample.
The NVO Summer School is made possible through the support of the National Science Foundation and the National Aeronautics and Space Administration.
 |
 |