JWeb : Installation on Linux

INTRODUCTION

JWeb is a point-and-click interface for display and interaction with SPIDER images and data written by Dr. Bimal Rath. JWeb is written in Java was developed and tested on Linux, SGi Irix & Windows computers.

LOADING JWeb
(Probably has already been done if you have installed SPIDER)

1. Download SPIDER/Web and place it in an appropriate directory: PARENT-DIR.
   The compressed SPIDER/Web distribution takes about 180 Mb of disk space. The uncompressed whole distribution will take about 850Mb but includes libraries and executables for several different systems some of which can be discarded.
2. Uncompress the tar archive e.g.
   gunzip spiderweb.tar.gz
3. Unpack the tar archive e.g.
   tar -xvf spiderweb.tar

The following JWeb related files will be created under: PARENT-DIR/web/jweb

File	Contents
src directory	Jweb source code
linux/j2re-1_4_2_06-linux-i586.bin	JRE install script
linux/jai-1_1_2_01-lib-linux-i586-jre.bin	JAI install script
linux/linux.WEB.jar	Linux Jweb Java archive
linux/font.properties	Linux Jweb fonts
linux/jweb.cshrc	Jweb 'C' shell environment variables

INSTALLATION

Most Linux distributions install a Java Run Time Environment (JRE) by default. However only a few Linux distributions install the Java Advanced Imaging Run Time Environment (JAI) which is needed by Jweb. You could add JAI to your Java installation but due to various issues it is often simpler to install a second JRE containing JAI as described here.

1. Access your Jweb directory:
   cd spider/web/jweb/linux
2. Install the JRE included with JWeb by executing:
   j2re-1_4_2_06-linux-i586.bin
   
3. Install JAI in the new Java directory:
   cd j2re1.4.2_06
   ../jai-1_1_2_01-lib-linux-i586-jre.bin
   Return to the Jweb directory:
   cd ..
   
4. Set necessary environment variables and alias for Jweb usage under Java.
   If you are using the 'C' shell, edit the first non-comment line in: jweb.cshrc and create a $JWEB_DIR environment variable specifying location for JWeb on your system i.e.:
   setenv   JWEB_DIR   Enter_path_of_your_JWeb_directory_here
   Then place the edited contents of jweb.cshrc in the .cshrc startup file in your home directory.
   

5. The previous step will also create alias, 'jweb', for starting JWeb with a maximum amount -Xmx512m of memory allowed. You may adjust this amount to suit your computer.
   
6. If you are not using a 'C' shell then you will have to alter the last two steps as appropriate for your shell.

TESTING

Test JWeb :

jweb

USE MOUSE TO SELECT MENU ITEMS FROM PULL-DOWN MENUS

Further information on the use of JWeb is given in the JWeb manual.

If you get an error message like: Exception in thread "GtkMain" java.lang.UnsatisfiedLinkError: gtkInit ... ....

You are not using the Java run time environment packaged with JWeb. The GNU environment that you are trying to use is probably defective.

BUGS, SUGGESTIONS

Send any bug reports or suggestions to: spider@wadsworth.org