|
Science With the Virtual Observatory |
This page describes how to configure your Linux laptop for use with the 2005 NVO Summer School software.
We recommend Redhat 9.0, Fedora Core 3 or SuSE 9.0: if you are running an earlier version of one of these you may find that there are compatibility issues with some of the software.
You should enter commands given below into a terminal window or equivalent.
You can always check if an executable is in your path with the which command: for example, to see if the java executable is in your path:
>which java /usr/bin/java
If you want to check the value of an environment variable, you can use the printenv command with the name of the variable:
>printenv JAVA_HOME /usr/bin/java
If you need to set an environment variable, you can use the following syntax, depending on your environment:
>setenv JAVA_HOME /usr/bin/java (csh users) or >JAVA_HOME=/usr/bin/java; export JAVA_HOME (bash users)
Alternatively, if you want to set it more permanently, set it in your .bashrc, .cshrc or .tcshrc file.
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 installed, make sure that the java executable is in your path and then:
>java -version java version "1.4.2_08" Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_08-b02) Java HotSpot(TM) Client VM (build 1.4.2_08-b02, 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:
>printenv JAVA_HOME /usr/local/java/j2sdk1.4.2_08
If it is not, you should set it:
>setenv JAVA_HOME /usr/local/java/j2sdk1.4.2_08 (for csh users) or >JAVA_HOME=/usr/local/java/j2sdk1.4.2_08; export JAVA_HOME (for bash users)
Generally it's a good idea to set this in your normal environment setup script (i.e. your .cshrc, .tcshrc or .bashrc file) and then you do not have to worry about it again.
If you are interested in using Java 1.5 (the latest version of Java), check the instructions here. Note that Java 1.5 is known to have certain dependencies which can be incompatible 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:
>mysql --version mysql Ver 14.7 Distrib 4.1.13, for redhat-linux-gnu (x86_64)
The value after the Distrib keyword is actually the version number: anything later than '4.1.7' is fine.
If necessary, you can obtain an appropriate version of MySQL from here.
You should install the Standard version.
You should also set a password for the MySQL root user (note that this is different from the system root user). Start the server:
>/usr/local/mysql/bin/mysqld_safe &
and then:
>/usr/local/mysql/bin/mysqladmin -u root password "newpassword" >/usr/local/mysql/bin/mysqladmin -u root -h hostname password "newpassword"
where you should replace hostname with the name of your laptop.
If you have had to install MySQL then please make sure that the directory /usr/local/mysql/bin is in your path.
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:
>cd $NVOSS_HOME >source bin/setup.csh (csh users) or >. bin/setup.sh (bash users)
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: This is available at: Java 3D 1.3.1 for Linux.
You can develop in C# on Linux using Mono, the open source C# platform, available from here.
The recommended version of Mono is 1.1.8: to see what version, if any, is already installed, make sure that the mono executable is in your path and then:
>mono -V Mono JIT compiler version 1.1.8.1, (C) 2002-2005 Novell, Inc and Contributors. www.mono-project.com
Anything beginning '1.1.8' is fine.
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:
>idl IDL Version 6.1.1 (linux x86 m32). (c) 2004, Research Systems, Inc. IDL>
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.
The recommended version of IRAF is 2.12.2a: to see what version, if any, is already installed, make sure that the cl executable is in your path and then:
>cl NOAO PC-IRAF Revision 2.12.2a-EXPORT Wed Jul 14 20:45:34 MST 2004 This is the EXPORT version of PC-IRAF V2.12 supporting most PC systems. cl>
If necessary, you can install an appropriate version of IRAF by running the iraf/iraf_setup.csh script in the summer school software package:
>cd $NVOSS_HOME >./iraf/iraf_setup.csh
You can get an appropriate Java 1.5 distribution from Sun here.
If you are going to be developing web services in Java 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): Mac OS comes with Perl installed and to check what the current installed version is:
>perl -v This is perl, v5.8.0 built for i686-linux
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 and then:
>php -version PHP 4.3.11 (cli) (built: May 31 2005 23:41:02) Copyright (c) 1997-2004 The PHP Group Zend Engine v1.3.0, Copyright (c) 1998-2004 Zend Technologies
If necessary, you can obtain an appropriate version of PHP from here.
The recommended version of Python is 2.4.1: to see what version, if any, is already installed, make sure that the *python* executable is in your path and then:
>python -V Python 2.4.1
If necessary, you can obtain an appropriate version of Python from here.
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:
>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:
>python setup.py install
MySQL-python provides access to a MySQL database. It is available here. You should download MySQL-python-1.2.0.tar.gz. Once you have unpacked the compressed tar ball, you can install it by changing to the MySQL-python-1.2.0 directory and typing:
>python setup.py install
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 (Red Hat Linux 9.0 3.3-6)] on linux2 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.
 |
 |