Installation Instructions

The evaluation versions of JBlitz are distributed in different installation formats:

• Distribution as a Windows installation package. Installation instructions.
• Distribution as a ZIP file for all platforms. Installation instructions.
• Distribution as a TAR GZIP file for Unix / Linux. Installation instructions.

1. Download and run one of the installation executables for JBlitz Professional. This will guide you through the installation and create a short-cut for you. The installation process configures JBlitz with a set of default options including memory settings and classpath entries.
2. Double click on the short-cut to run JBlitz.

If you're using the JBlitz customization API to install a plug in module or customization module, you may need to edit the classpath. If you're planning to run a large number of virtual users, you may need to give JBlitz more memory. To change these or other settings, see below, otherwise, the default settings should be sufficient.

The file JBlitz Pro.ini in the installation folder contains memory, classpath and output redirection settings. Read the following instructions to change these settings when running JBlitz:

• memory settings: Find the line beginning Virtual Machine Parameters. This specifies memory settings and other VM flags for JBlitz. The following is suitable for normal use:
  Virtual Machine Parameters=-XX:NewSize=32m -XX:MaxNewSize=32m -Xmx192m -XX:SurvivorRatio=2

  However, if using large numbers of virtual users, we recommend that you increase the memory given to JBlitz by increasing the figure '192m'. A rule of thumb is to allow a basic 100 MB plus 1 MB for each virtual user.

• classpath: Find the line beginning Class Path. This specifies JBlitz's classpath. The following is suitable for normal use:
  Class Path=<app_path>/jblitz.jar;<app_path>/lib/customization_samples.jar;<app_path>/lib/custom.jar

  where <app_path> is the full path to your installation folder. If using the customization API, you can either package your classes up into the file 'custom.jar' and place it in the lib subfolder, or you can add in extra entries. Entries are separated by semicolons.

• viewing standard output and error output: Standard output can be captured to a file by adding the following entries to the [Application] section:
  Output File=<output file>
  Error File=<error file>

  where <output file> and <error file> specify the full path and file names for the redirected output to go to.

NOTE: be careful when editing this file. Make a backup copy of the original before saving changes.

Command line arguments: These cannot be specified via the ini file. To specify these, you'll need to edit the short-cut you're using to launch JBlitz and specify the desired arguments there. Alternatively, you can specify them directly from a command prompt by invoking the launch executable and appending the arguments after. For instance, open a command prompt, move to the installation folder and type:

"JBlitz Pro.exe" -console ArtGallery.xml

to run JBlitz in console mode using the test configuration 'ArtGallery.xml'. Valid arguments are listed here.

1. Download and unzip the ZIP file for JBlitz Professional to a folder of your choice.
2. Open a console window or shell. Move to the directory that JBlitz has been unzipped to. Verify the version of java you are using by typing 'java -version' on the command line. JBlitz 5.x supports the use of either the 1.4.2, 1.5.0 or 1.6.0 JVMs from Sun Microsystems (with 1.4.2 being the minimum requirement). After verifying the java version, you'll need a command line in the following form to run JBlitz Pro:

   java <memory settings> <classpath> com.clan.jblitz.app.Pro <command line arguments>

See the following section for details on how to specify the memory settings, classpath and command line arguments for JBlitz.

1. Download and unzip the TAR GZIP file using gunzip. Untar using tar -xvf.
2. Open a console window or shell. Move to the directory that JBlitz has been untarred to. Verify the version of java you are using by typing 'java -version' on the command line. JBlitz 5.x supports the use of either the 1.4.2, 1.5.0 or 1.6.0 JVMs from Sun Microsystems (with 1.4.2 being the minimum requirement). After verifying the java version, you'll need a command line in the following form to run JBlitz Pro:

   java <memory settings> <classpath> com.clan.jblitz.app.Pro <command line arguments>

See the following section for details on how to specify the memory settings, classpath and command line arguments for JBlitz.

These settings can be passed in on the command line. Read the following instructions to change these settings when running JBlitz:

• memory settings: We recommend that you use the following for regular testing:
  -XX:NewSize=32m -XX:MaxNewSize=32m -Xmx192m -XX:SurvivorRatio=2

  We recommend that you increase the memory given to JBlitz by increasing the figure '192m' when using large numbers of virtual users. A rule of thumb is to allow a basic 100 MB plus 1 MB for each virtual user.

• classpath: The following classpath is suitable for normal use:
  -classpath jblitz.jar;lib/customization_samples.jar

  If using the customization API, you'll need to add in extra entries for your custom code

• command line arguments: Specify any command line arguments you require. A list of valid arguments is available.

The JRE is the environment in which a Java^TM application runs. The primary benefit from the use of such an environment is the implicit cross-platform support it gives.

Once a JRE is installed for your machine, you can run any Java^TM application in it, be it JBlitz, or one of the thousands of others available at sites such as Jars.com, FileTransit.com or JavaBoutique.com.

Running an application inside a JRE also adds another level of protection to your system environment. Java^TM performs internal verification routines to ensure the application image has not been corrupted and to ensure the application does not attempt to make any calls that could crash your system.

The JREs are available free. We recommend using either version 1.6.0, version 1.5.0 (Java 5, section titled 'JRE') or version 1.4.2 (section titled 'JRE') - all available from Sun's Java Website.