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.

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>

Options

Table 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.