IOMeter Command Line Interface
Version 1.00
Author: Jarvis Wang jarvis@iomark.co.cc
Update: 2011-10-26
USAGE:
IOMeterCLI [iometer_ip]
ALL COMMANDS:
config: generate IOMeter config file
config -f [file_str] -t [time_str] -c [cases]
-m [manager_str] -m [manager_str] -m ...
[file_str] -- file to save the config to
[time_str] -- [run_time],[rampup_time],[update_interval]
[run_time] -- hh:mm:ss
[rampup_time] -- ss
[update_interval] -- ss
[cases] -- [case_str]|[case_str]|...
[case_str] -- [case_name]$[access_str]$[access_str]$...
[access_str] -- [block_size(B)],[%access],[%read],
[%random],[delay],[burst],[align],[reply]
[manager_str] -- [manager_name],[manager_ip]$[worker_str]$[worker_str]$...
[worker_str] -- [worker_name],[outstanding],[max_sector],[start_sector],
[case_name]|[case_name]|...,[target]|[target]|...
load: load IOMeter configuration file
load [icf_file_path]
sample: sample results
sample [sample_type] [file_to_save] [interval(s)] [times]
[sample_type] -- all / noManagers / noWorkers / noTargets
start: start all tests
start [result_file_path]
stop: stop current test
stopall: stop all tests
state: view the iometer running state (idle/preparing/opening/rampingUp/recording/rampingDown)
quit/exit: quit IOMeter cli and gui
help/?: print this help
Start IOMeterCLI
If IOMeterCLI.exe and IOMeter.exe are running on the same host, click IOMeterCLI.exe directory
If IOMeterCLI.exe is running on a different host with IOMeter.exe, start IOMeterCLI.exe with a
parameter of the Host IP Adress on witch IOMeter.exe is running, for example:
IOMeterCLI.exe 129.22.240.31
Create a test configration
Use "config" command to create a IOMeter configuration file. There're four parameters for "config"
command:
-f xxx.icf
Set configuration file to create, it is recommended to set the suffix to .icf
-t HH:MM:SS,SS,SS
Set run time, rampup time and update interval, which are separated by ','
HH - hour
MM - minute
SS - second
-c CN$BS,AC,RD,RND,DLY,BST,ALN,RPL$ANOTHER_SPECIFICATION$...|ANOTHER_CASE|...
Set test cases
Test cases are separated by '|'
The name and specifications of the case are separated by '$'
The attributes of the specification are separated by ','
CN - test case name, can be any string with out '|', '$' or ','
BS - block size
AC - access percent
RD - read percent
RND - random percent
DLY - delay, time between issuing I/O
BST - burst, number of I/O each time issuing
ALN - align, I/O alignment
RPL - reply size
-m MN,MA$WN,OS,MS,SS,CN|CN|...,TG|TG|...$ANOTHER_WORKER$...
Set manager, you can set up more managers by giving more '-m' parameters
The manager's attributes and the workers' attributes are separated by '$'
The attributes if the worker are separated by ','
The test cases' name (CN) are separated by '|'
The targets (TG) ares separated by '|'
MN - manager name
MA - manager ip address
WN - worker name
OS - outstanding
MS - max sector
SS - start sector
CN - case name
TG - target
For example:
two managers, each with two workers, run two case: Sequential 1MB 100% Write and Random 4KB 100% Read (aligned 4KB):
config -f iometer.icf
-t 00:10:00,300,1
-c SW1M$1048576,100,0,0,0,1,0,0|RR4K$4096,100,100,100,0,1,4096,0
-m MN1,192.168.0.1$WK1,32,0,0,SW1M|RR4K,sdb|sdc$WK1,32,0,0,SW1M|RR4K,sdd|sde
-m MN2,192.168.0.2$WK1,32,0,0,SW1M|RR4K,sdb|sdc$WK1,32,0,0,SW1M|RR4K,sdd|sde
load a test configuration file
Use "load" command to load a test configuration file, for example:
load xxx.icf
sample updating performance data
Use "sample" command to sample the runtime performance data.
There're four parameters for sample command:
sample level, file to save, sample interval, sample count
There're four sample levels: all, noManagers, noWorkers, noTargets
The sample interval must be equal to the performance counter update interval, if your configuration is configured in GUI,
please set the update interval correctly.
For exmaple:
sample all perf.csv 1 1000
start test
Issue "start" directly if you want save the result file to the default path.
Issue "start filepath" if you want set the path of the result file.
stop a case
Issue "stop" to stop the current case
stop all cases
Issue "stop all" to stop all the cases
check the IOMeter running state
Issue "state" to check the running status of IOMeter
quit from IOMeterCLI and IOMeter GUI
Issue "quit" will quit from CLI and also GUI