Linux Installation

Installation of Jim under Linux is in seven distinct stages:

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

Java Runtime Environment (JRE) Installation. JRE (J2SE) version 6.0 (also known as 1.6.0) is required for Jim Version 5. It can be downloaded directly from the Sun web site. Please be sure that you download and install the correct version of the JRE (version 6.0 is required).
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 and install JDK 6.0.
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-linux-i586.bin for 32-bit Linux systems, and j3d-1_X_X-linux-amd64.bin for 64-bit 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 32-bit Linux system, the commands would be: cd /usr/java/jdk1.6.0_04 cd jre sh /path-to-download-files/j3d-1_5_2-linux-i586.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).
Installing Jim. Once you have the JRE (or JDK) and Java3D installed, download and install the Jim programme.
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. The c-shell script file Jim has changed from previous releases and will need to be re-customised.
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. 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 then super user password, ask your systems administrator for help. If you do su - root, don't forget that you will need to cd again to the location of jinstall.bin, and ensure that the java command is in your search path.
7. Type ./jinstall.bin 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.
  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 ./jinstall.bin 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.
8. 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
License Request. Note that in order to run a trial (demo) of Jim, your computer must have a network card installed and working. Jim can use the network card hardware address as the unique ID of your computer for licensing purposes.
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.
If, at the top of this dialog, you see a message like This computer's Host ID is "00123FDB5B8C" then your computer has only one network card. If, however, you see more than one Host ID (as above), then your computer has more than one network adapter and you need to choose which HostID to send. If you send the Host ID corresponding to a removable adapter, and remove the adapter, then Jim will stop working.
To find out more about your network adapters, open a terminal window and type the command:
/sbin/ifconfig -a
You can use the output shown to decide which hardware address to send. The hardware addresses are shown on lines that looks like:
HWaddr 00:20:AF:AB:E7:5C
The string of digits and numbers separated by colons is the Ethernet hardware address used to license Jim. If you do not see a line like this, please ask your systems administrator for help.
Send the hardware address 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.
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 hardware address you send should be for the computer on which you intend to run Jim.
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.
Install the License. The license file you will receive by e-mail should be saved to a text file, and copied into the directory where you installed Jim (normally /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".
The first thing to check if licensing fails on a Linux system is that the command:
/sbin/ifconfig eth0
gives a result similar to the one below, containing the line with the HWaddr:
```
    eth0      Link encap:Ethernet  HWaddr 00:20:AF:AB:F6:7A
              BROADCAST MULTICAST  MTU:1500  Metric:1
	      RX packets:0 errors:0 dropped:0 overruns:0 frame:0
              TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
              collisions:0 txqueuelen:100 
              Interrupt:10 Base address:0x300
    
```
If this is not the case, please ask your systems administrator for help.
Now see the section on customising a UNIX installation.
You may also wish to download some example images to get you going with Jim.

Jim Home

Linux Installation

If you wish to do some Java Programming