https://sourceforge.net/p/iometercli/home/Program%2520Usage/Recent changes to Program UsageenThu, 03 Nov 2011 14:27:07 -0000https://sourceforge.net/p/iometercli/home/Program%2520Usage/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 1. 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 2. 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 3. load a test configuration file Use "load" command to load a test configuration file, for example: load xxx.icf 4. 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 5. 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. 6. stop a case Issue "stop" to stop the current case 7. stop all cases Issue "stop all" to stop all the cases 8. check the IOMeter running state Issue "state" to check the running status of IOMeter 9. quit from IOMeterCLI and IOMeter GUI Issue "quit" will quit from CLI and also GUI Jarvis WangThu, 03 Nov 2011 14:27:07 -0000https://sourceforge.netdb8930c1b7d4df702b07b009c2c26e36ffabd6d0