Appendix A. Environment Variables

Appendix A. Environment Variables
Prev		Next

This appendix lists the environment variables for IRIX NetWorker BusinesSuite Module for Oracle, their default values, and valid options.

NetWorker Database Module for Oracle

The BusinesSuite Module for Oracle allows for configuration of environment options to activate certain features of NetWorker. The database module helps the Enterprise Backup Utility and NetWorker interact during backups and restores. This ensures restoration of a database file to the correct Oracle7 Server instance and compiles a history of the objects backed up for that instance.

See Appendix B, “Error Messages” for a description of error messages associated with a BusinesSuite Module for Oracle session.

Changing BusinesSuite Module for Oracle Variables

To change a value for a BusinesSuite Module for Oracle (DMO) variable that does not appear in the default nsrdmo script:

Copy the template file /etc/nsrdmo.sh to the directory where the NetWorker binaries are installed.
Add the DMO environment variable and its assigned value to the script.

Add the DMO environment variable to the list of variables exported.

export_environment_variables()
{
export NSR_VOLUME_POOL
...
export new_NSR_variable 
}

Save the edited script with a descriptive filename.
In the nwadmin Clients window, select the Oracle7 Server instance and enter the filename of the customized nsrdmo script in the Backup command field.

Default Values and Valid Options

This section contains tables for each of the BusinesSuite Module for Oracle environment variables that you can modify by customizing the nsrdmo script.

NSR_CLIENT


Definition	The NSR_CLIENT environment variable indicates the NetWorker client resource to use for the recover session.
Default Value	Host from which the session is initiated, as indicated by getlocalhost().
Possible Values	This value is used only when recovering data that was backed up by another client. Since the client name is an arbitrary string, the value for NSR_CLIENT is not checked directly. An incorrect value may cause an authentication or system error in NetWorker.

NSR_COMPRESSION


Definition	The NSR_COMPRESSION environment variable indicates whether to compress the backup data as it is sent to the NetWorker server.
Default Value	FALSE.
Possible Values	Setting NSR_COMPRESSION to a value of TRUE means the standard compression technique for NetWorker is performed on the data backed up. Setting NSR_COMPRESSION to a value of FALSE means that compression is not performed. Note: Compressing data from the database server may speed backups, as long as the database server is able to send data to the backup server fast enough to keep the tape drive streaming. Data compression during backup will affect CPU usage on the backup server, but will reduce the amount of data sent to the NetWorker server.

Definition

The NSR_COMPRESSION environment variable indicates whether to compress the backup data as it is sent to the NetWorker server.

Default Value

FALSE.

Possible Values

Setting NSR_COMPRESSION to a value of TRUE means the standard compression technique for NetWorker is performed on the data backed up.

Setting NSR_COMPRESSION to a value of FALSE means that compression is not performed.

Note: Compressing data from the database server may speed backups, as long as the database server is able to send data to the backup server fast enough to keep the tape drive streaming. Data compression during backup will affect CPU usage on the backup server, but will reduce the amount of data sent to the NetWorker server.

NSR_DATA_VOLUME_POOL


Definition	The NSR_DATA_VOLUME_POOL environment variable indicates the volume pool to which datafiles should be backed up.
Default Value	BusinesSuite Module does not set a pool by default—if none is specified, the pool is selected by the NetWorker server based on its pool resources configuration.
Possible Values	Any valid NetWorker pool name of 1024 characters or less. This value is set in the NetWorker pools resource and can be explicitly assigned in a shell script.

NSR_DEBUG_FILE


Definition	The NSR_DEBUG_FILE environment variable indicates the full pathname and filename of the file where BusinesSuite Module for Oracle messages should be written. Message logs for BusinesSuite Module are separated from regular NetWorker messages. BusinesSuite Module for Oracle debug messages have the following format: `(pid) OBK-sbt: debug: <function>: <type>: <message> pid` is the process ID and `function` is an internally-defined function name.
Default Value	None.
Possible Values	Any valid pathname and filename.

NSR_NO_BUSY_ERRORS


Definition	The NSR_NO_BUSY_ERRORS environment variable indicates whether the savegroup should wait for a busy NetWorker server or fail immediately.
Default Value	FALSE. Wait for the NetWorker server to accept the connection.
Possible Values	Setting NSR_NO_BUSY_ERRORS to a value of TRUE causes the backup to fail immediately when the NetWorker server is busy. A network error message describing the reason for the failure is written to dmo.messages.

NSR_SAVESET_EXPIRATION


Definition	The NSR_SAVESET_EXPIRATION environment variable sets the date (in getdate(3) format) when this save set will expire. By default, no explicit save set expiration date is used.
Default Value	None.
Possible Values	Any valid time in the future.

NSR_SERVER


Definition	The NSR_SERVER environment variable indicates the hostname of the server BusinesSuite Module for Oracle should use for a save session.
Default Value	The most appropriate server, based on the index name and client name for the session. See also NSR_CLIENT.
Possible Values	The server name defined by the NSR_SERVER environment variable is checked, using `gethostbyname()`.

Prev	Table of Contents	Next
Chapter 6. Restoring Data		Appendix B. Error Messages