          ----- Installing VisualRoute -----  
Change to the directory in which you wish to create the VisualRoute directory 
hierarchy. The file vr50a.tar.Z must be placed into this directory 
(for simplicity).

1.) Login as root.

2.) Uncompress or gunzip the file 'vr50a.tar.Z':

     # gunzip vr50a.tar

3.) Untar the file 'vr50a.tar':

     # tar -xf vr50a.tar

4.) You must have root privilige to install, but not to run VisualRoute.
    To run VisualRoute as non root the ping executables need to
    be changed with chmod. To achieve this, type as root:

     # cd vr5/exe
     # chmod 4755 vrping0

    Be aware of the potential security implications of suid root files on your
    system. For more information, see the chmod manual page or your system
    documentation."


         ----- Running VisualRoute -----
1.) Change to the directory 'vr' in the just created hierarachy.


2.) Make sure the current directory ('.') is in the PATH environment
variable. 
     PATH=$PATH:.; export PATH

3.) There are two ways to start VisualRoute.

From the vr directory enter the command:

     java vr

to begin VisualRoute.  If you have multiple versions of Java,
you must make sure that you execute the correct version to start
VisualRoute.  If, when you start VisualRoute, you do not have a
correct version of the Java Runtime Environment once
'Run' or 'Run as trial' is selected in the initial display,
nothing else will happen.

4.) Or,you may also execute the Java Runtime Envrionment directly.
From the vr directory, enter the command:

     jre -cp . vr

Note that this assumes that the jre executable is in your PATH.
If this is not the case, change the path accordingly.  See the jre
man page for any questions regarding jre.

5.) The VisualRoute is written in Java and as such on Unix, requires a GUI.
 A character based interface is just not capable of presenting the data 
 obtained in a usable form. On Unix it sometimes desirable (and with some 
 servers, a necessity) for processes to be started at system boot that in 
 themselves require GUI capabilities.
    For VisualRoute to be set up on Unix the user will need to install 
 the X virtual frame buffer software. This software provides a virtual 
 terminal without the need for a hardware console nor even if the console 
 is present, a sign on as this maybe construed a security issue.
    VisualRoute 5 has been tested with the Xvfb software on Solaris 2.6(Sparc),
 Solaris7(Sparc) and Linux Redhat 6.1 (Intel). The install files for 
 Solaris(Sparc) can be found at 
 	http://tmap.pmel.noaa.gov/home/ferret/FAQ/graphics/Solaris_Xvfb.html.
 for Solaris Intel the option is to download the X source and recompile.
 This can be obtained from
 	http://www.x.org/download.html
    The Linux Redhat Xvfb rpm can be obtained from
 	http://www.rpmfind.net
    For SuSe the Xvfb is facilitated in a re-compile. Refer to 'man Xvfb'.

    There is provided a shell script for the placing in /etc/rc2.d on Solaris 
 and /etc/rc.d/rc2.d on Linux. Basically the script has four environment 
 variables at the beginning that the user may want to review before going 
 any further. They are
	1) DISPLAY, this is required by the X software and VisualRoute.

	2) PATH, this needs three things to be present in its many directories.
	   i) the jre directory for the Java Runtime Environment executable.
	  ii) the location of the directory for the X executables
	 iii) the current directory for VisualRoute to find the ping executable

	3) HOME, 	the home location of the root account
	4) VRHOME,	the installed directory of VisualRoute.

	Once these have been changed the script can be saved, named as 
 S95Visual and copied over to the boot directory. Please ensure that this 
 will start AFTER the X font server software at boot.
