Solaris

On Solaris we distribute these tools on a CDROM as a pre-installed directory which can be copied directly to the /opt/isis directory on your hard disk.

The first step is to create a directory named /opt/isis on your hard disk. Usually you will need root privileges to do that.

	$ su
	Password: ultra-secure
	# mkdir /opt/isis

If the directory already exists, you should make sure that it is empty before installing the Isis software. Note: as long as you have write permission in the /opt/isis directory, you will not need root priveleges.

The next step is to mount the CDROM. On many Solaris systems, the CDROM is automatically mounted as soon as you put it into the drive. In this case a window usually pops up, and the contents of the CDROM are available in the directory /cdrom/cdrom0. If this is not the case, then you must mount the CDROM manually; usually this requires root priveleges. In the example below, the mount point is shown as /cdrom/cdrom0, but you can use another mount point if you prefer; note that you may have to mkdir the mount point as an empty directory first.

	# mount /dev/sr0 /cdrom/cdrom0
	; this step may not be necessary

Now that you have mounted the CDROM, you should use the cd to change your directory to the directory on the CDROM that you want to install on the hard disk. That directory will be named something like /cdrom/cdrom0/sparc-sun-solaris2.6 depending on the CDROM mount point and the version of Solaris that you want to install to. We currently provide installation for Solaris 2.6 and Solaris 2.8. If you have any version of Solaris before 2.8, then we recommend the 2.6 install.

	# cd /cdrom/cdrom0/sparc-sun-solaris2.6

Note: There should be an index.html file at the toplevel which will point to an online version of this manual.

To recursively copy the contents of the current directory on the CDROM to the /opt/isis directory on the hard disk, you can use the following tar command:

	# tar cf - . | (cd /opt/isis; tar xvf -) 

Unfortunately we have found that the tar that is usually installed on Solaris machines may be broken. If you find that to be the case, you can use the working /cdrom/cdrom0/sparc-sun-solaris2.6/tools/bin/tar executable that we have supplied on the CDROM.

Before you can run Genie, you need to set a few environment variables.

To begin with, if you are going to be using Genie with IDL, which is how Genie is usually used, you need to make sure you have a complete IDL installation with a valid license. In particular, you should have a PATH and IDL_PATH set so that when you type idl on the command prompt, you get a working IDL session.

If you are using the C-shell, then type the following:

	$ setenv LD_LIBRARY_PATH /opt/isis/lib:/opt/isis/tools/lib:$LD_LIBRARY_PATH
	$ setenv IDL_PATH +/opt/isis/share/genie/pro::$IDL_PATH
        $ setenv PATH /opt/isis/bin:/opt/isis/tools/bin:$PATH 

If you use one of the Bourne shells (sh or bash), then type this instead:

	$ LD_LIBRARY_PATH=/opt/isis/lib:/opt/isis/tools/lib:$LD_LIBRARY_PATH
	$ IDL_PATH=+/opt/isis/share/genie/pro::$IDL_PATH
        $ PATH=/opt/isis/bin:/opt/isis/tools/bin:$PATH 
        $ export LD_LIBRARY_PATH IDL_PATH PATH 

There is a further issue with 64-bit Solaris operating systems. You will prefer to run a 32-bit version of IDL, this can usually be achieved with the command idl -32. If that doesn't work, you should install the 32-bit version of IDL. You will want to use --IDL='idl -32' with Genie; this can be set on the command line or in an options file, as explained in the chapter called Quick Start Guide to Using Genie.

If you do not have a 32 bit version of IDL, then can use the --avoidCallExternal=+ with Genie, which will reduce the set of operators you can use, but will still provide a functioning Genie.

By the way, (seemingly) independent of the 32/64 bit issue, it is sometimes helpful to use --IDL='/full/path/to/idl' if Genie is having trouble finding idl.