SPEC JVM Client98 Suite

JVM Client98 Suite

Release 1.0 8/98

These benchmarks are used to measure the SPECjvm98 performance metric. They contain licensed software from SPEC, Fraunhofer IIS, Sandia Corporation, and Sun Microsystems. You must read and agree to the licenses (located in the License subdirectory) before you can use or install this software. See benchmark information and credits for acknowledgement of contributors to this suite.

A Java Virtual Machine compatible with JDK1.1 or later is required. See System Requirements and Common Problems in the Users Guide.

Installation

If you are reading this from the CD-ROM, follow the steps below to install the suite. If you are reading this from a hard disk or web server, then someone has already installed the suite.

The benchmark suite is normally installed on a web server using InstallShield Java(tm) Edition. For reportable results you must install the SPEC JVM Client98 software on a web server accessible to your client system. This may be the same system as the client, or it may be a different system. For test purposes where results are not reported, you may run the benchmarks without a web server. See the run rules (located in the doc subdirectory) for more infomation.

You have several choices to install the software:

Basic Java Installation
From the command line, change into the top level directory on the CD-ROM and execute the Java class file install.class. Examples:
```
    java install

    jview install
   
```
On many systems with graphical file browsers, you may also open the top level directory on the CD-ROM and double click on the Java class file install.class. Note that some systems may not by default show the file extension .class so you double click on the file named install.
This is the preferred method of installation if you have a Java Development Kit (JDK or SDK), Java Runtime Environment (JRE), or otherwise have a Java Virtual Machine which can run applications on your web server.
Windows Self-Extracting exe
Open My Computer and then the CD-ROM. Double click on the install icon.

This is the preferred method of installation on Windows computers if you aren't sure whether you have a suitable Java Virtual Machine, or where it is located. InstallShield will search your machine for a JVM suitable to perform the installation.
Applet Installation
Open install.html in your web browser.

This is the preferred method of installation if you have a JVM that is accessible only from within a web browser. InstallShield will search your machine for a JVM suitable to perform the installation, and may offer you the option to download a JVM. If you download one JVM to perform the installation but plan to test performance of a different JVM, make sure that you run the benchmarks with the JVM you intend to use. SPEC does not recommend or endorse any particular JVM.
UNIX self-extracting archive From the command line, change into the top level directory on the CD-ROM and execute the shell script install.sh.
On many systems with graphical file browsers, you may also open the top level directory on the CD-ROM and double click on the shell script file install.sh.

This is the preferred method of installation on UNIX computers if you aren't sure whether you have a suitable Java Virtual Machine, or where it is located.
gzip tar archive - For experts only. Use this method only if you are familiar with UNIX tar archives, and the Gnu gzip compression utility. Change to the location where you want to install the software and extract the archive, into a new directory jvm98.
```
    gzip <path_to_cdrom/install.tar.gz | tar -xvf -
   
```
This is an installation method you may use if you have a UNIX computer, or other computer with UNIX and Gnu utilities, and are familiar with their use. Beware that some MS-DOS and MacOS utilities for UNIX tar archives may modify text files by changing the line termination characters; this will corrupt your installation and cause all benchmark validation to fail. If this happens you must re-install.
Mount the CD-ROM directly on the web server
The benchmarks may be run directly from the CD-ROM without installation; however this will probably give lower performance than could be obtained otherwise.

First read the software licenses and be sure that you agree to their terms. Load the CD-ROM on your web server system, and make it accessible to clients of that web server. Then from your client, open

http://yourserver/install_location/SpecApplet.html

This is the fastest and easiest method of (non) installation for reportable results.
Execute the benchmarks directly from the CD-ROM
For non-reportable test execution as an applet you may simply open SpecApplet.html in your web browser or applet viewer.

For non-reportable test execution as an application, you may double click on the Run icon (Windows 95) or double click on the run.sh icon (UNIX) in a file manager window. Or run the command from the command line:
```
        $ run.sh          UNIX (Don't type the $ prompt)
        H:> RUN.BAT   Windows (Don't type the H:> prompt)
    
```
This is the fastest and easiest method of (non) installation to try out the benchmarks, though your results may not be reported.

Documentation

The latest documentation and technical support answers may be found on the SPEC web site at http://www.spec.org/osg/jvm98/ Documentation is included with this benchmark suite in the doc subdirectory:

Users Guide and Help
Programmers' Reference, class documentation