DipZoom

Instruction For Linux

Installation Notes

1. Make sure you have Sun Java Runtime Environment 5.0 or later installed. To install or upgrade your Java runtime, go to Sun Java J2SE 5.0, click on "download" in the "Java Runtime Environment" section, and choose the self-extracting file to download according to your system. Then, download and execute the file.


2. Download the DipZoom package and save it in the directory of your choice.


3. Extract the DipZoom package (double-click on the dipzoom.zip file in a graphic window or type "unzip dipzoom.zip" from the command line). At this point, the subdirectory called "dipzoom" is created. (The file readme.txt in this directory provides information on how to run a dipzoom client)


4. Change directory into "dipzoom/linux" (Type "cd dipzoom/linux" from the command line).


5. Run the installation script (Type "sh ./install.sh").


6. Restart your computer -or- Start the DipZoom MP (Type "/etc/init.d/dipzoom_mp start").

Uninstallation Notes

- Automatic Uninstallation -

1. Run the dipzoom_MP.jar file by double-clicking the file in a graphic window
   or typing "java -jar dipzoom_MP.jar" from command line.


2. Run the Uninstallation script (Type "sh ./uninstall.sh").

- Manual Uninstallation -

1. Delete DipZoom directory, dipzoom_mp, along with all the files in it, and DipZoom startup script, dipzoom_mp.
   
     The typical location of the "dipzoom_mp" directory is
         /usr/local/dipzoom_mp
   
     The startup script location varies from distribution to distribution. Typical examples include:
         /etc/init.d/dipzoom_mp     (Redhat, Fedora, etc.)
         /etc/rc.d/init.d/dipzoom_mp    
   
      * Location of the dipzoom_mp directory could be seen from the screen or terminal where the dipzoom_mp.jar is run -or- in the log file, dipzoom.log, located in the same directory as dipzoom_mp.jar
   
     ** If the above directory and file are not there, search for them by typing
        "locate dipzoom_mp" or
        "find / -name dipzoom_mp\* -print" in the terminal window.

2. If the DipZoom MP was configured to start automatically at boot time, checks and removes (if exist) the file "S90dipzoom_mp" from runlevel 2-5 directories.
   
         /etc/rc2.d/S90dipzoom_mp    
         /etc/rc3.d/S90dipzoom_mp    
         /etc/rc4.d/S90dipzoom_mp    
         /etc/rc5.d/S90dipzoom_mp    
   
         (For Redhat, Fedora, etc.)
   
      * If the above directory and file are not there, search for them as suggested by step 1 footnote. (FYI: the file "S90dipzoom_mp" may not exist on some systems)

Running the Client GUI application

Change directory into "dipzoom/src" and run "dipzoom_client.jar" by double-clicking the file in a graphic window or typing "java -jar dipzoom_client.jar" from command line.