Command Line Options...
Most of swingbench's parameters can be changed from the command line. This provides a more flexible approach when many runs of a load are required with minor changes to some of the parameters (i.e. the number of users/threads). Most of the core parameters can be changed from the command line or the configuration file can be used as template and only the parameters that are needed for each run are changed. To view all of the available command line options use -h. i.e.
./charbench -h
usage: parameters:
-D
-a
-be
-bg
-bs
-c
-co
-com
-cpuloc
-cpupass
-cpuuser
-cs
-debug
-debugf
-debugfine
-di
-dt
-dumptx
-dumptxdir
-en
-env
-g
-h,--help
-i
-intermax
-intermin
-ld
-max
-min
-p
-r
-rr
-rt
-s
-u
-uc
-v
-vo
-a
-be
-bg
-bs
-c
-co
-com
-cpuloc
-cpupass
-cpuuser
-cs
-debug
-debugf
-debugfine
-di
-dt
-dumptx
-dumptxdir
-en
-env
-g
-h,--help
-i
-intermax
-intermin
-ld
-max
-min
-p
-r
-rr
-rt
-s
-u
-uc
-v
-vo
use value for given environment variable
run automatically
end recording statistics after. Value is in
the form hh:mm
indicate that charbench will be run in the
background
start recording statistics after. Value is
in the form hh:mm
specify config file
specify/override coordinator in
configuration file.
specify comment for this benchmark run (in
double quotes)
specify/overide location/hostname of the
cpu monitor.
specify/overide os password of the user
used to monitor cpu.
specify/overide os username of the user
used to monitor cpu.
override connect string in configuration
file
turn on debugging. Written to standard out
turn on debugging. Witten to debug.log.
turn on finest level of debugging
disable transactions(s) by short name,
comma separated
override driver type in configuration file
(thin, oci, ttdirect, ttclient)
output transaction response times to file
directory for transaction response times
files
enable transactions(s) by short name, comma
separated
display environment configuration
distributed group identifier
print this message
run interactively (default)
override minimum inter transaction sleep
time (default = 0)
override minimum inter transaction sleep
time (default = 0)
specify/overide the logon delay
(milliseconds)
override maximum intra transaction think
time in configuration file
override minimum intra transaction think
time in configuration file
override password in configuration file
specify results file
specify/overide refresh rate for charts in
secs
specify/overide run time for the benchmark.
Value is in the form hh:mm
run silent
override username in configuration file
override user count in configuration file.
display run statistics (vmstat/sar like
output), options include (comma separated no spaces).
trans|cpu|disk|dml|tpm|tps|users|resp|vresp
output file for verbose output (defaults to
stdout)
run automatically
end recording statistics after. Value is in
the form hh:mm
indicate that charbench will be run in the
background
start recording statistics after. Value is
in the form hh:mm
specify config file
specify/override coordinator in
configuration file.
specify comment for this benchmark run (in
double quotes)
specify/overide location/hostname of the
cpu monitor.
specify/overide os password of the user
used to monitor cpu.
specify/overide os username of the user
used to monitor cpu.
override connect string in configuration
file
turn on debugging. Written to standard out
turn on debugging. Witten to debug.log.
turn on finest level of debugging
disable transactions(s) by short name,
comma separated
override driver type in configuration file
(thin, oci, ttdirect, ttclient)
output transaction response times to file
directory for transaction response times
files
enable transactions(s) by short name, comma
separated
display environment configuration
distributed group identifier
print this message
run interactively (default)
override minimum inter transaction sleep
time (default = 0)
override minimum inter transaction sleep
time (default = 0)
specify/overide the logon delay
(milliseconds)
override maximum intra transaction think
time in configuration file
override minimum intra transaction think
time in configuration file
override password in configuration file
specify results file
specify/overide refresh rate for charts in
secs
specify/overide run time for the benchmark.
Value is in the form hh:mm
run silent
override username in configuration file
override user count in configuration file.
display run statistics (vmstat/sar like
output), options include (comma separated no spaces).
trans|cpu|disk|dml|tpm|tps|users|resp|vresp
output file for verbose output (defaults to
stdout)
The following examples show how this functionality might be used
./swingbench -cs //localhost/DOM102 -dt thin
Will start swingbench using the local config file (swingconfig.xml) but overriding its connectstring and driver type. All other values in the default configuration file will be used.
./swingbench -c ../configs/ccconfig.xml -cs //localhost/orcl -dt thin
Will start swingbench using the config file ../configs/ccconfig.xml and overriding its connectstring and driver type. All other values in the configuration file will be used.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -dt thin -uc 50 -min 0 -max 100 -a
Will start minibench (a lighter weight frontend) using the config file ../configs/ccconfig.xml and overriding its connectstring and driver type. It also overrides the user count and think times. The "-a" option starts the run without any user interaction.
Author : Dominic Giles
Version : 2.4.0.876
Results will be written to results.xml.
Time Users TPM TPS User System Wait Idle
5:08:19 PM 0 0 0 0 0 0 0
5:08:21 PM 3 0 0 4 4 3 89
5:08:22 PM 8 0 0 4 4 3 89
5:08:23 PM 12 0 0 4 4 3 89
5:08:24 PM 16 0 0 8 43 0 49
5:08:25 PM 20 0 0 8 43 0 49
5:08:26 PM 20 2 2 8 43 0 49
5:08:27 PM 20 29 27 8 43 0 49
5:08:28 PM 20 49 20 53 34 1 12
Will start charbench (a character based version of swingbench) using the config file ../configs/soeconfig.xml and overriding its connectstring and driver type. It also overrides the user count and think times. The "-a" option starts the run without any user interaction. This example also connects to the cpumonitor (started previously). It uses the -v option to continually display cpu load information.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -cpuloc localhost -co localhost
Will start minibench using the config file ../configs/soeconfig.xml and overriding its connectstring. It also specifies a cpu monitor started locally on the machine and attaches to a coordinator process also started on the local machine.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -cpuloc localhost -rt 1:30
Will start minibench using the config file ../configs/soeconfig.xml and overriding its connectstring. It also specifies a cpu monitor started locally on the machine. The "-rt" parameter tells swingbench to run for 1 hour 30 minutes and then stop.
./coordinator -g
./minibench -cs //node1/RAC1 -cpuloc node1 -co localhost &
./minibench -cs //node2/RAC2 -cpuloc node2 -co localhost &
./minibench -cs //node3/RAC3 -cpuloc node3 -co localhost &
./minibench -cs //node4/RAC4 -cpuloc node4 -co localhost &
./clusteroverview
This collection of commands will first start a coordinator in graphical mode on the local machine. The following commands start four load generators with the minibench front end, they also attach to the local coordinator. Finally the last command starts clusteroverview (currently its configuration needs to be specified in its config file). Its possible to stop all of the load generators and coordinator with the following command
./coordinator -stop
Example 1.
./swingbench -cs //localhost/DOM102 -dt thin
Will start swingbench using the local config file (swingconfig.xml) but overriding its connectstring and driver type. All other values in the default configuration file will be used.
Example 2.
./swingbench -c ../configs/ccconfig.xml -cs //localhost/orcl -dt thin
Will start swingbench using the config file ../configs/ccconfig.xml and overriding its connectstring and driver type. All other values in the configuration file will be used.
Example 3.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -dt thin -uc 50 -min 0 -max 100 -a
Will start minibench (a lighter weight frontend) using the config file ../configs/ccconfig.xml and overriding its connectstring and driver type. It also overrides the user count and think times. The "-a" option starts the run without any user interaction.
Example 4.
/charbench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -dt thin -cpuloc oraclelinux -uc 20 -min 0 -max 100 -a -v users,tpm,tps,cpu
Author : Dominic Giles
Version : 2.4.0.876
Results will be written to results.xml.
Time Users TPM TPS User System Wait Idle
5:08:19 PM 0 0 0 0 0 0 0
5:08:21 PM 3 0 0 4 4 3 89
5:08:22 PM 8 0 0 4 4 3 89
5:08:23 PM 12 0 0 4 4 3 89
5:08:24 PM 16 0 0 8 43 0 49
5:08:25 PM 20 0 0 8 43 0 49
5:08:26 PM 20 2 2 8 43 0 49
5:08:27 PM 20 29 27 8 43 0 49
5:08:28 PM 20 49 20 53 34 1 12
Will start charbench (a character based version of swingbench) using the config file ../configs/soeconfig.xml and overriding its connectstring and driver type. It also overrides the user count and think times. The "-a" option starts the run without any user interaction. This example also connects to the cpumonitor (started previously). It uses the -v option to continually display cpu load information.
Example 5.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -cpuloc localhost -co localhost
Will start minibench using the config file ../configs/soeconfig.xml and overriding its connectstring. It also specifies a cpu monitor started locally on the machine and attaches to a coordinator process also started on the local machine.
Example 6.
./minibench -c ../configs/soeconfig.xml -cs //localhost/DOM102 -cpuloc localhost -rt 1:30
Will start minibench using the config file ../configs/soeconfig.xml and overriding its connectstring. It also specifies a cpu monitor started locally on the machine. The "-rt" parameter tells swingbench to run for 1 hour 30 minutes and then stop.
Example 7.
./coordinator -g
./minibench -cs //node1/RAC1 -cpuloc node1 -co localhost &
./minibench -cs //node2/RAC2 -cpuloc node2 -co localhost &
./minibench -cs //node3/RAC3 -cpuloc node3 -co localhost &
./minibench -cs //node4/RAC4 -cpuloc node4 -co localhost &
./clusteroverview
This collection of commands will first start a coordinator in graphical mode on the local machine. The following commands start four load generators with the minibench front end, they also attach to the local coordinator. Finally the last command starts clusteroverview (currently its configuration needs to be specified in its config file). Its possible to stop all of the load generators and coordinator with the following command
./coordinator -stop