Sun/Solaris Installation

Note that the Java Virtual Machine (and therefore Jim) will only run under Sun/Solaris Solaris 8, 9 or 10. You may first need to install the appropriate patches.

Installation of Jim under Sun/Solaris is in seven distinct stages:

1. Install the Java Runtime Environment (jre)
2. Install Java 3-D
3. Install the Jim software
4. Request a license
5. Install the license
6. Customise the installation.
7. Download some example images (optional).

1. Java Runtime Environment (JRE) Installation. JRE (J2SE) version 6.0 (also known as 1.6.0) is required for Jim Version 6. It can be downloaded from the Sun web site. Please be sure that you download and install the correct version of the jre (version 6.0 is required). Be sure to install the correct patches if you are running Solaris 8, 9 or 10.

   If you wish to do some Java Programming

   If you want to write your own Java programmes, perhaps to do some image analysis using the imaging A.P.I. supplied with Jim, then you'll need to install the Java Development Kit (JDK) instead of the JRE. Please go to the Sun web site, and be sure to download JDK 6.0.

2. Installing Java 3D. Java 3D (Version 1.5.1 or later) is required for Jim 5.0, and must be installed after you install the JRE. To install, please go to the Java 3D download page, and download the correct installer (j3d-1_X_X-solaris-sparc.bin for SPARC processor systems, and j3d-1_X_X-solaris-x86.bin for Intel processor systems). Then cd to the jre directory of your java 1.6 installation, and then execute the binary. For example, suppose Java 1.6 is installed in /usr/java/jdk1.6.0_04/ on a an Intel processor system, the commands would be:

     cd /usr/java/jdk1.6.0_04
     cd jre
     sh /path-to-download-files/j3d-1_X_X-solaris-x86.bin
     

   Note: if there is no folder called jre, the command cd jre will fail. You can ignore this: it simply means that you installed the java runtime environment (JRE) rather than the Java Development Kit (JDK).

3. Installing Jim. Once you have the JRE (or JDK) installed, you can download and install the Jim programme. The instructions are different, depending on whether your Solaris computer has a SPARC processor or an Intel processor.

   Note: If you are re-installing the same version of Jim, please copy your existing license file (license.txt) from the installation directory to a safe place, and then completely remove the contents of the installation directory. You will also need redo any customisation of shell scripts that you have previously performed.

   Note: you will probably need to do the installation as root user if you want to install Jim anywhere other than your home directory. To become root user, type:
   su - root
   and enter the super user password when prompted. If you do not know the super user password, ask your systems administrator for help.

   SPARC processor

   1. Save jinstall.bin in a temporary directory on your system as a binary file.
      Important: To download a binary file and save it under the correct name, you should click the right mouse button on the filename link, and select Save from the pop-up menu.
   2. Verify that the filename you downloaded is jinstall.bin.
      If your browser saved it with any other name, then rename it.
   3. Make sure that the correct java command is in your search path. Typing java -version should show something like:
      java version "1.6.0_04" where 1.6.0 is what is needed, and the _04 is a particular release number (any release is fine).
   4. Change directory (cd) to the directory where you saved jinstall.bin.
   5. Change the properties of jinstall.bin to executable
      (e.g., chmod 755 jinstall.bin)
   6. Type the command ./jinstall.bin to install Jim.

   Intel processor

   1. Save install.jar in a temporary directory on your system as a binary file.
      Important: to download a binary file and save it under the correct name, you should click the right mouse button on the filename link, and select Save from the pop-up menu.
   2. Verify that the filename you downloaded is install.jar.
      If your browser saved it with any other name, then rename it.
   3. Make sure that the correct java command is in your search path. Typing java -version should show something like:
      java version "1.6.0_04" where 1.6.0 is what is needed, and the _04 is a particular release number (any release is fine).
   4. Change directory (cd) to the directory where you saved install.jar.
   5. Type java -jar install.jar to install Jim.

   If you install Jim having used su to become a different user (e.g. root), you may see the (incorrect) error message:

   Error: You need Swing 1.1 or 1.2 in your classpath to run this program.
   or
   Error: A class is missing from the classpath to run this program.

   This happens when the installer GUI cannot gain access to your X-Windows display. Working as the user who owns the display, type:
   xhost +
   in a command window. Then, before you issue the command to install Jim command, set the DISPLAY environment variable to the display name. For example, if the hostname of your computer is "myhost", you would type:

   setenv DISPLAY myhost:0.0

   if you use the c-shell, or

   DISPLAY=myhost:0.0
export DISPLAY

   if you use the sh/ksh shell. (Alternatively, you can logout completely from your system, and login as root).

An installer window will now appear, and you will be asked to choose an installation directory. Please make a note of the installation directory you choose. After the installation is complete, change directory to your chosen installation directory, and make sure that all users have execute permission for the script Jim. Type, for example:
chmod 755 Jim

Note: If you follow these instructions and still experience difficulty when installing as root, we recommend that you logout out of the window system, and login again as root user.

4. License request. The easiest way to obtain the details needed to send for a license is to try starting Jim. If you have not yet received a license file, you will see a pop-up error dialog like the one shown below.

   

   You will see at the top of this dialog a message like This computer's Host ID is "0x57c580". To find out the hostid without starting Jim, open a terminal window and type the command:

   /usr/bin/hostid

   Send the hostid to , and we will then send you in return by e-mail a license file for Jim.

   Note: this is not an automated service, and there will be a delay before you receive your license file.

   In case of problems, please ask your systems administrator for help.

   If you believe that you have received and correctly installed your license file, then you can get Jim to print out more detailed messages about why licensing has failed. Press the button. This will pop up a further dialog containing detailed license debugging messages. You can use these to diagnose the problem, or e-mail the messages shown in this window to , to help us to diagnose the problem.

   If you have purchased network (floating) licenses, you can set up the connection to your license server by clicking on the . See the instructions for setting up a connection to a license server.

   Note: If you have a network of computers, installation of Jim need not be done on the same computer that you intend to use to run Jim. The hostid you send should be for the computer on which you intend to run Jim.

5. Installing the License. The license file you receive by e-mail should be saved to a text file, and copied into the directory where you installed Jim (most likely /opt/Xinapse/Jim5. Please ensure that the name of this file is "license.txt". The installation directory is the directory that also contains (amongst others) the file "xinapse5.jar".

Now see the section on customising a UNIX installation.

You may also wish to download some example images to get you going with Jim.