|
|
This page describes how to configure your Linux laptop for use with the 2006 NVO Summer School software.
We recommend Redhat Enterprise Linux 4, Fedora Core 5 or SuSE 10: 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 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, make sure that the java executable is in your path and then:
>java -version java version "1.5.0_06" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05) Java HotSpot(TM) Client VM (build 1.5.0_06-b05, 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:
>printenv JAVA_HOME /usr/java/jdk1.5.0_06
If it is not, you should set it:
>setenv JAVA_HOME /usr/java/jdk1.5.0_06 (for csh users) or >JAVA_HOME=/usr/local/java/jdk1.5.0_06; 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.
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:
>python -V Python 2.4.1
If necessary, you can obtain an appropriate version of Python from here.
Four 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
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 Source Kit. Once you have unpacked the compressed tar ball, you can install it by changing to the Imaging-1.1.5 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 >>> 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:
>mysql --version mysql Ver 14.12 Distrib 5.0.22, for pc-linux-gnu (i686) using readline 5.0
The value after the Distrib keyword is actually the version number: anything later than '5.0.15' 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:
> mysql -u root
mysql> UPDATE mysql.user SET Password = PASSWORD('newpassword') WHERE User = 'root';
mysql> FLUSH PRIVILEGES;
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. nvoss2006 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.13: 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.13.8, (C) 2002-2005 Novell, Inc and Contributors. www.mono-project.com
Anything beginning '1.1.13' is fine.
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:
>idl IDL Version 6.2 (linux x86 m32). (c) 2005, Research Systems, Inc. IDL>
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, software 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).
Installation problems and questions may be directed tofitz@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 that the perl executable is in your path and then:
>perl -v This is perl, v5.8.7 built for i386-linux (with 1 registered patch, 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 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 NVO Summer School is made possible through the support of the National Science Foundation and the National Aeronautics and Space Administration.
 |
 |