Software for the Summer School

We have bundled up development and applications software for you to install prior to coming to Aspen. We hope you have a chance to download, install, and try out a few things before arrival.

The software download includes AXIS (Java web services), ANT (Java-based software build tool), and several VO applications (Mirage, Topcat, VOPlot), and sample data files.

WebServices and Web Applications are fairly language neutral for the client. We have decided to do our examples in Java as this is freely available and works on most platforms.

Presentations on how to use the application software is available through the Summer School Course Notes page.

The examples etc below are written using DOS notation - on UNIX you will use $ for variables not % and the / will be \. All scripts are duplicated for UNIX - we aim to have this tried and tested on Linux, Mac/OSX and windows.

There will be WIFI at the course and some cable linkups.

System Software

We strongly recommnd that students install these versions of software packages even if they already have some of this software. Although you may use other JDK/tomcat installations by settig environment variable - we have tested only with these versions.

• Mac OS-X users on JDK/Tomcat start here*

• Java SDK 1.4.2_XX - you may get this from Sun (you want the one on the left with NetBeans) or here is the windows installer - if you get a slightly different version you will need to change set JAVA_HOME in your environment before running setupjava script or rename the directory it is installed in. NOTE: This requires 150Mb swap on Linux to install

• NOTE: If you did the above and put on NetBeans then you already have Tomcat so skip this. Otherwise install tomcat v5.0.xx. Get this from http://jakarta.apache.org/site/binindex.cgi search in the page for "Tomcat 5.0.27" then take the approriate one in the list. Once you install this (i.e. unpack to your favorite location) you need to set CATALINA_HOME to point to the top level of the unpacked diretctory.

• A DBMS would be useful but not essential. If you have one you understand already installed that will do - make sure you have JDBC drivers for it. If you do not have a DBMS then MySQL is free and runs on most platforms.

• If you wish to use voplot 3d you need java3d get it from http://java.sun.com/products/java-media/3D/ or for linux form http://www.blackdown.org/java-linux/java2-status/java-3d-status.html. This is also the only thing in summerschoolP3 different to summerschoolP2.

• The Summer school zip contains AXIS, ANT, many VO packages and several useful scripts simply unzip it - if you do that at c: or your HOME on unix and install the jsdk in the default dir (on windows) or in HOME (on unix) then you are all set. SummerschoolFull.zip This is the Date stamp for this file you will find this in VERSION.txt of your nvoss dorectory. If it does not extis or is older than this one you need a new one.

NOTE MAC USERS Do not just click on the above link to download the zip; rather press CTRL and click on the above link and select "Download Linked File As...", then just save the file as named (XXX.zip) in the directory above your nvoss directory. You will then need to use command line unzip to unpack it.

c:\> unzip SummerschoolFull.zip 

Next setup the paths by running the setup script - if you did not put this in the c: (under your home dir on unix) then set VO_HOME to the directory you did put it in, in your environment before running setupjava. As pointed out above you may also set JAVA_HOME and CATALINA_HOME in this manner to point to other than the default installation.

c:\> nvoss\bin\setupjava
   or on unix cshell
source nvoss/bin/setupjava.csh 
   or on unix bourne shell
. nvoss/bin/setupjava.sh 

now you have scripts like wsdl2java all set up

Test the installation

After running setupjava go into the root of the directory and simply type :

> ant

you should see 
Buildfile: build.xml

init:
    [mkdir] Created dir: C:\java\test\classes

compile:
     [echo] building
    [javac] Compiling 1 source file to C:\java\test\classes

test:
    [junit] Testsuite: sumsch.TestInstall
    [junit] Tests run: 3, Failures: 0, Errors: 0, Time elapsed: 0.375 sec


clean:
   [delete] Deleting directory C:\java\test\classes

BUILD SUCCESSFUL

bin

the bin directory contains lots of useful scripts.

mirage	will start voenabled mirage
topcat	will start topcat
wsdl2java	will execute AXIS wsdl2java to generate stubs - pass url or filename on commandline
adminclient	Runs the apache axis admin client
starttomcat stoptomcat	start and stop tomcat webserver on default port 8080. Assumes netbeans install but catalinahome in setupjava.cmd so may point to another install
bouncetomcat	just stop tomcat then start it
voplot	starts voplot plotting tool
vi.exe	Just for windows users the popular vi editor
downloadmanager	Starts the download manager allows queries of Cone/Siap services and file download
demofits	runs the demofits java module on the given fits file

dev

This contains many eamples which will be used during the course if you want to try one look at readvotable.

readvotable

Under dev there is readvotable. This is a very simple java program which list the first line of a VOTable and all its fields. There is an example table in the dir. Build it simply with with 'ant' or type it in (assuming setup is OK):

javac ReadVotable.java

'ant test' will run this , or type:

java readvotable.ReadVotable ..//..//data//GSC2.2-RA_180.0-Dec_-1.0-Radius_0.25.xml

Notes possible problems

tomcat

For whatever reason the setupclasspath.bat in the tomcat bin dir has an 'exit' at the end if anything goes wrong this line is hit and causes the dos window to close - delete it.

If you think something should have deployed to tomcat but it looks like it did not then just 'bouncetomcat' it does not always pick up changes.

To set an environment variable in Windows on a dos promtp simply type set VAR=value. To do this more permanently go to Conrol Panel->System click the Advanced tab at the bottom you will see a button "Environment Variables" click it. you may then add or edit variables for the system or your account. These do not effect any open Dos Prompt windows you have to open new ones.

MAC OS apparently you need OS 10.3 to install JDK1.4.2_X.