Chapter 2. Installation

Application Installation

  1. Download the file (for release x.x) to the desired installation directory ($install_dir).

  2. Expand the zip file (using `unzip' on Linux or WinZip or similar on Windows).

  3. To launch, double-click on the "Janocchio.jar" icon (Windows), or at the command line type "java -jar $install_dir/janocchio-x.x/Janocchio.jar"

Applet Installation

Web server administrators wishing to install the applet should follow these instructions. Applet users do not need to follow any installation process on their PC's, they only need to navigate to the correct web page.

  1. Download and expand the file as above.

  2. It is necessary to sign all the jar files used by Janocchio, so that the applet can access files on the user's computer (the 'client').

    1. Create a keystore (if you do not have one already). At the command line, issue 'keytool -genkey -alias myalias', where myalias is defines the name you will use to access the keystore, and follow the instructions.
    2. On the command line, change directory to $install_dir/janocchio-x.x, and issue 'jarsigner -signedjar Janocchio_Signed.jar Janocchio.jar myalias'. Change directory to $install_dir/janocchio-x.x/lib, and issue the equivalent command for each of the other jar files.

    More information on keystores and signed jars is available here.

  3. Copy these signed jar files to the required directory on the webserver. In the same directory, create a valid html file containing the following code:
       <APPLET code="" archive="Jmol_Signed.jar, Janocchio_Signed.jar, cdk-20050826_Signed.jar, swing-layout_1.0_Signed.jar, json_Signed.jar" width=900 height=550>\</APPLET> 
  4. Navigating to this html page will now start the Janocchio applet. The user must accept the signing certificate.

Software Dependencies

A Java Runtime Environment (JRE). Janocchio has been tested on Sun JRE 1.4.2 and 1.5.0, under both Windows XP and Red Hat Linux operating systems.

The following freely-available libraries are required as .jar files:

  • Jmol 11.0

  • CDK 20050826

  • Matisse GUI Builder (swing_layout_1.0)

  • JSON

They are distributed with the application zip file as described above.