14 rastat Utility Reference

This chapter provides details on the rastat utility. You use rastat to generate statistics to help you evaluate the performance of Recovery Appliance.

You can find the utility, rastat.pl, in the /opt/oracle.RecoveryAppliance/client/ directory of a Recovery Appliance compute server.

14.1 rastat Command Syntax

perl rastat.pl --test=<options> --rasys=<string> --catalog=<string> 
--filesize=<size>M --chunksize=<size>M --diskgroup=<string> --parms=<string> 
--oracle_home=<string> --oracle_sid=<string>

14.2 Options

Table 14-1 rastat Options

Option	Description
`-h, --help`	Displays help information.
`--test`	Specifies which of the following atomic tests to run: `[NETBACKUP\|NETRESTORE\|ASMREAD\|ASMWRITE\| CONTAINERREAD\|CONTAINERWRITE\|CONTAINERALLOC\|ALL]` `NETBACKUP`: Measures the network performance of a protected database sending backup byte streams to the Recovery Appliance. Requires `--catalog`; `--filesize` is optional. `--parms` is also optional if it is already configured for the RMAN client. `NETRESTORE`: Measures the network performance of a protected databases receiving backup byte streams from the Recovery Appliance. Requires `--catalog`; `--filesize` is optional. `--parms` is also optional if it is already configured for the RMAN client. `ASMREAD`: Measures the disk I/O performance of the Recovery Appliance reading from an ASM disk group. Requires `--diskgroup` and `--rasys`. `--filesize` and `--chunksize` are optional. `ASMWRITE`: Measures the disk I/O performance of the Recovery Appliance writing to an ASM disk group. Requires `--diskgroup` and `--rasys`. `--filesize` and `--chunksize` are optional. `CONTAINERREAD`: Measures the disk I/O performance of the Recovery Appliance reading from container files. Requires `--diskgroup` and `--rasys`. `--filesize` and `--chunksize` are optional. `CONTAINERWRITE`: Measures the disk I/O performance of the Recovery Appliance writing to container files. Requires `--diskgroup` and `--rasys`. `--filesize` and `--chunksize` are optional. `CONTAINERALLOC`: Measures the Recovery Appliance container file allocation rate. Requires `--diskgroup` and `--rasys`. `--filesize` and `--chunksize` are optional. `ALL`: Performs all of the tests. All of the required options must be set.
`--rasys`	The connection string for the Recovery Appliance SYS account. Required for all I/O tests.
`--catalog`	The connection string for the Recovery Appliance virtual private catalog (VPC) account. Required for `NETBACKUP` and `NETRESTORE` tests.
`--filesize`	Optional. The file size in megabytes for the utility to use for the test. Setting the appropriate file size for your test requirements is highly recommended. The default file size is 1024M.
`--chunksize`	Optional. The chunk size in megabytes for the utility to use for the `CONTAINERREAD` or `CONTAINERWRITE` test. The default is the system configured chunk size.
`--diskgroup`	The name of the disk group the I/O test should read from or write to. For example, `--diskgroup=+DISK1` specifies an ASM disk group and `--diskgroup=/:DELTA` specifies a container group. Required for all I/O tests.
`--parms`	Optional if already configured in RMAN. The PARMS setting in RMAN to use for a `NETBACKUP` or `NETRESTORE` test. This parameter must specify the location of libra.so and the wallet information. For example, `--parms='SBT_LIBRARY=/u01/oracle/lib/libra.so, ENV=(RA_WALLET=location=file:/u01/oracle/dbs/ra credential_alias=ra-scan:1521/zdlra5:dedicated)'`.
`--oracle_home`	Optional. The `$ORACLE_HOME` environment variable. Use this option to set the variable or to override the current setting.
`--oracle_sid`	Optional. The `$ORACLE_SID` environment variable. Use this option to set the variable or to override the current setting.