COM.volano.Test

COM.volano.Test runs VolanoTest™, the test driver for the VolanoChat server.

SYNOPSIS

java COM.volano.Test [ options ]

DESCRIPTION

VolanoTest simulates VolanoChat clients for testing the VolanoChat server and the Java virtual machine on which it runs. It creates a number of test users which can be instructed to repeatedly:

connect with the server,
request access to the server,
get the list of rooms in the server,
get the list of users in a room,
enter a room,
send chat messages to those in the room,
send an audio alert to itself,
enter a private chat session with itself,
send private chat messages to itself,
exit the private chat session,
exit the room, and
disconnect from the server.

Upon completion it reports the elapsed time for the test.

The VolanoChat server must be up and running before starting VolanoMark. To start the VolanoChat server, change to your vmark2.0.0 installation directory and enter the command:

java COM.volano.Main

where java is the name of your Java interpreter. It might have a different name on your system, such as jview, guava, kaffe, or sc10java.

Note that to find the class COM/volano/Main.class, you'll need either to have no CLASSPATH defined or to have the current working directory (".") included in the definition of your CLASSPATH environment variable.

To run the VolanoTest application with its default values, change to the vmark2.0.0 directory and enter the command:

java COM.volano.Test

You should use the same Java virtual machine to run VolanoTest as you do for the VolanoChat server. The values used by default are shown below, creating 5 rooms with 20 test users in each room for a total of 100 chat connections. Each user performs all the test functions 10 times without reconnecting between each test loop. After the 10 loops are complete, the test users disconnect and exit the test.

file  = vtest200.log
host  = localhost
port  = 8000
start =    1
rooms =    5
users =   20
level =    4
loops =   10
recon = false

The test should take anywhere from a few minutes to an hour when running with these default values, depending on your Java virtual machine, operating system, and hardware platform. When it completes, you should see the results printed like the following:

Running the test ...
Test complete.

VolanoTest Version = 2.0.0
Elapsed time       = 303 seconds

OPTIONS

-help

Prints a usage message.

-version

Prints the version information.

-jvm

Prints the Java virtual machine environment, as shown by the following example:

java.vendor        = Sun Microsystems Inc.
java.vendor.url    = http://www.sun.com/
java.version       = 1.1.5
java.class.version = 45.3
os.name            = Windows NT
os.version         = 4.0
os.arch            = x86

where:

java.vendor: is the vendor-specific identifier string
java.vendor.url: is the vendor's Web site address
java.version: is the version of the Java interpreter
java.class.version: is the version of the Java API
os.name: is the name of the host operating system
os.version: is the version of the host operating system
os.arch: is the host hardware architecture

-file string

Specifies the name of the output file, with a default value of vtest200.log. The output file contains the Java virtual machine environment and the VolanoTest test results.

-host string

Specifies the name of the host running the VolanoChat server, with a default value of localhost. Note that the publicly available version of VolanoTest requires the host name to be localhost, and must therefore be run locally on the same machine running the VolanoChat server.

-port integer

Specifies the port number at which the VolanoChat server accepts chat connections, with a default value of 8000.

-start integer

Specifies a starting room number for the test users to enter, with a default value of 1. This option allows you to run multiple VolanoTest applications against the same VolanoChat server without interference between them. For example, you could instruct the first VolanoTest application to create 10 rooms starting with room number 1 and the second VolanoTest application to create 10 rooms starting with room number 11. The first would create test users in rooms 1 through 10, and the second would create test users in rooms 11 through 20.

-rooms integer

Specifies the number of rooms to create in the VolanoChat server, with a default value of 5.

-users integer

Specifies the number of test users to create in each room, with a default value of 20.

-level integer

Specifies the depth level of the test as a number 1 through 4, with a default value of level 4. The level determines how deep into the VolanoChat server each test users goes, shown by the hierarchy below:

(1) connect to the server
(1) request access to the server
- (2) get the list of rooms in the server
- (2) get the list of users in a room
  - (3) enter a room
  - (3) send chat messages into the room
  - (3) send an audio alert to itself
    - (4) enter a private chat session with itself
    - (4) send private chat messages to itself
    - (4) exit the private chat session
  - (3) exit the room
(1) disconnect from the server

-loops integer

Specifies the number of loop iterations to make at the indicated level, with a default of 10 test loops.

-recon

Specifies whether to disconnect and reconnect to the VolanoChat server before performing another test loop, with a default value of false. Specifying this option sets the value to true.

ENVIRONMENT VARIABLES

CLASSPATH

Used to provide the system a path to user-defined classes. Directories are separated by semicolons on Windows and colons on UNIX. For example, on UNIX you might have:

.:/usr/local/java/lib/classes.zip

while on Windows, you might specify:

.;C:\jdk1.1.5\lib\classes.zip

COM.volano.Test

SYNOPSIS

DESCRIPTION

OPTIONS

ENVIRONMENT VARIABLES

SEE ALSO