JGView Installation Instructions
Usage Documentation | Installation | Usage Examples

JGView is a Java™ application. Like all Java programs, JGView executes within another program called the Java Virtual Machine (JVM), an aspect of Java software involved in Web interaction. Instead of running directly within the native operating system, a Java application is interpreted for the native operating system by the JVM. This is the mechanism by which Java platform-independence is accomplished. To install the JVM, install the platform-specific Java Runtime Environment (JRE), several of which have been included on this CD-ROM. Java software support, including JRE downloads, is available at: http://java.sun.com/ Please note that Java and the Java Coffee Cup Logo are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Click on the link for your platform and follow the instructions:
Windows | Linux/UNIX | Mac OS

Instructions for installing JGView on other operating systems and other enhancements to this document may be available from the CD-ROM technical support page at the U.S. JGOFS web site.

Using JGView in a Windows PC Environment

1.1 Installing JGView on a Windows System

These instructions are for a Windows 2000 system. The instructions for Windows 98, NT and XP are very similar with only minor changes in wording of system prompts.

For Windows operating systems, the Java Runtime Engine (JRE) is not included as part of the standard operating system. The JRE installation for Windows is included on this CD-ROM. Open the /applications/installs/ directory on the CD-ROM and:
1) Double-click on windows_jre_1_4_1.exe
2) At the License Agreement, click 'Yes'
3) We recommend that you choose the default "Typical" install which will install files to the Program Files folder.
4) Click 'Next >'
5) If asked if you want to install the Java Plug-In Control, uncheck any selections and click 'Next >'
7) The Installation will complete and you are now ready to run JGView.

1.2 Running JGView on a Windows System

There are several ways to run JGView after you have installed the JRE. You may run JGView by navigating to the /applications/Common directory and double-clicking JGView.jar. The other option is to create a shortcut to JGView.jar.

NOTE: The JGView CD must be in the CD-ROM drive for JGView to work properly.

1.2.1 Shortcut File for JGView.jar

Creating a shortcut file allows you run the JGView program more easily.
To create a shortcut file,
1) navigate to the applications/Common directory on the CD-ROM
2) Right-click on the JGView.jar file and drag it to the Desktop or any location of your choosing to which you have write access, and select 'Create Shortcut Here'
3) Double-click the shortcut file to run JGView

1.2.2 MS-DOS Command Prompt for JGView.jar

To run JGView from the command prompt,
1) Open a Command Prompt Window (usually located at Start > Programs > Accessories > Command Prompt)
2) With the JGView CD in the CD-ROM drive, type: X: (where X is the drive letter for your CD-ROM drive)
3) Press 'Enter'
4) type: cd applications\common\ (this should set the command prompt to x:\applications\common\>)
5) Press 'Enter'
6) At the command prompt, type the path to where you installed the JRE followed by the -jar option.
For example, if the JRE was installed in C:\Program Files\Java, type (including quote marks):
"C:\Program Files\Java\j2re1.4.1_02\bin\javaw.exe" -jar JGView.jar
7) Press 'Enter' to run JGView

1.2.3 JGView.exe

JGView for Windows also exists as an .exe file named JGView.exe This file is found in /applications/Common. See the JGView documentation file section about "Optimizing JGView", for an explanation of instances where running JGView.exe may be preferred over JGView.jar. Simply double-click JGView.exe to run the Program. If you would like easy access to running JGView you may create a shortcut to place on your desktop or destination of choice by right-clicking on JGView.exe, dragging it to your favorite location and selecting 'Create Shortcut'.

Using JGView in a Linux/UNIX Environment

2.1 Installing JGView on Linux/UNIX systems

Java™ 2 Runtime Environment, Standard Edition 1.4.1_02 for selected Linux/UNIX systems has been included on this CD-ROM in the applications/installs folder. Shift-Click (Netscape) or Right-Click (IE) on a link to download/copy the install file to your local disk.

Linux RPM in self-extracting file (j2re-1_4_1_02-linux-i586-rpm.bin)

Solaris™ SPARC™ 32-bit self-extracting archive (j2re-1_4_1_02-solaris-sparc_32_bit.sh)
Solaris™ SPARC™ 64-bit self-extracting file (j2re-1_4_1_02-solaris-sparcv9_64_bit.sh)
(Note: Solaris 64-bit requires users to first install 32-bit.)

SGI IRIX 6.5: Java™ 2 was probably installed as part of the OS, the Java2 suite of tools includes the Java2 Runtime Environment.

If your operating system is not listed above or you wish to install a more recent version of JRE, follow steps 1 through 4. If you are using one of the JRE files from the list above, then continue with step 5 below (installation notes).

1) The Java Runtime Environment (JRE) for other Linux/UNIX systems may be downloaded from http://java.sun.com/, the Sun Java web site.
2) From the Java home page, click 'Downloads' from the left navigation.
3) From the Standard Edition Download List, select 'All Platforms' under the latest Java Standard Edition release (You will not want download any beta versions). Click 'Go'.

4) Find your operating system on this page and download the JRE, not the SDK.
5) Java™ 2 Platform, Standard Edition (J2SE™) installation notes for all platforms are available from the Sun Java site: http://java.sun.com/j2se/1.4.2/jre/install.html
6) Note the directory to which Java is installed. This will usually be /usr/java/j2re_1.4.1_<version_number>/bin/
7) You may want to add these to your PATH, LD_LIBRARY_PATH and MANPATH respectively.

2.2 Running JGView on Linux/UNIX systems

1) First, note the directory to which Java was installed (usually /usr/java/j2re_1.4.1_<version_number>/bin/)
2) Navigate to the /applications/Common/ directory on your CD-ROM.
3) If java was installed to /usr/java/j2se_1_4_1/, to run JGView type: /usr/java/j2se_1_4_1/bin/java -jar JGView.jar
4) This command will execute the 'JGView.jar' file located in the /applications/Common directory with the program 'java' found at '/usr/java/j2se_1_4_1/bin/' with the option '-jar'

5) It may be useful to create an alias to the java runtime environment. Please contact your system administrator if additional assistance is required.

Installing JGView ~ Mac OS X

Please note: Mac OS 9 and other previous version of the Macintosh operating system do have JAVA installations, but none have proven to be reliable enough to effectively run JGView.

3.1 Installing JGView on a Mac OS X system

The JRE comes packaged with Mac OS X and so there is no need for any installation.
If there is need for additional Java support on a Macintosh system, this "Java for Mac OS X" web page may be helpful: http://developer.apple.com/java/

3.2 Running JGView on a Mac OS X system

There are two ways to run JGView:
1) Navigate to the /applications/Common directory of the CD-ROM. Double-click on JGView.jar
2) Open a Terminal window, navigate to the /applications/Common directory of the CD-ROM,
    then type: 'java -jar JGView.jar'