The Data Protector SAP R/3 configuration file parameters are normally written to the Data Protector SAP R/3 configuration file after:
• the configuration of the SAP R/3 instance in Data Protector is completed.
• a new backup specification is created.
• a backup that uses balancing by time algorithm is completed.
The util_cmd Command
You can set, retrieve, list, or delete the Data Protector SAP R/3 configuration file parameters using the util_cmd -putopt (setting a parameter), util_cmd -getopt (retrieving a parameter), or util_cmd -getconf (listing all parameters) command on the Data Protector SAP R/3 client. The command resides in the <Data_Protector_home>\bin (Windows systems), /opt/omni/lbin (HP-UX and Solaris systems), or /usr/omni/bin (other UNIX systems) directory.
Cluster-Aware Clients
In a cluster environment, the environment variable OB2BARHOSTNAME must be defined as the virtual hostname before running the util_cmd command from the command line (on the client). The OB2BARHOSTNAME variable is set as follows:
• On UNIX: export OB2BARHOSTNAME=<virtual_hostname>
• On Windows: set OB2BARHOSTNAME=<virtual_hostname>
The util_cmd Synopsis
The syntax of the util_cmd command is as follows:
util_cmd -getconf[ig] SAP <sap_instance> [-local <filename>]
util_cmd -getopt[ion] [SAP <sap_instance>] <option_name>
[-sub[list] <sublist_name>] [-local <filename>]
util_cmd -putopt[ion] [SAP <sap_instance>] <option_name>
[<option_value>] [-sub[list] <sublist_name>] [-local
<filename>]
where:
<option_name> is the name of the parameter
<option_value> is the value for the parameter
[-sub[list] <sublist_name>] specifies the sublist in the configuration file to which a parameter is written to or taken from.
[-local <filename>] specifies one of the following:
• When it is used with the -getconf[ig] option, it specifies the filename for the output of the command to be written to. If the -local option is not specified, the output is written to the standard output.
• When it is used with the -getopt[ion], it specifies the filename of the file from which the parameter and its value are to be taken and then written to the standard output. If the -local option is not specified, the parameter and its value are taken from the Data Protector SAP R/3 configuration file and then written to the standard output.
• When it is used with the -putopt[ion] option, it specifies the filename for the output of the command to be written to. If the -local option is not specified, the output is written to the Data Protector SAP R/3 configuration file.
NOTE If you are setting the option_value parameter as a number, the number must be put in single quotes, surrounded by double quotes.
Return Values The util_cmd command displays a short status message after each operation (writes it to the standard error):
• Configuration read/write operation successful.
This message is displayed when all the requested operations have been completed successfully.
• Configuration option/file not found.
This message is displayed when either an option with the specified name does not exist in the configuration, or the file specified as the -local parameter does not exist.
• Configuration read/write operation failed.
This message is displayed if any fatal errors occurred, for example:
the Cell Manager is unavailable, the Data Protector SAP R/3 configuration file is missing on the Cell Manager, etc.
Setting Parameters
To set the Data Protector OB2OPTS and the Oracle NLS_LANG parameters for the SAP R/3 instance ICE, use the following commands on the Data Protector SAP R/3 client:
Windows <Data_Protector_home>\bin\util_cmd -putopt SAP ICE OB2OPTS '-debug 1-200 INSTANCE.txt' -sublist Environment
<Data_Protector_home>\bin\util_cmd -putopt SAP ICE NLS_LANG 'AMERICAN_AMERICA.US7ASCII' -sublist Environment
<Data_Protector_home>\bin\util_cmd -putopt SAP ICE NLS_LANG "'10'" -sublist Environment
HP-UX and Solaris /opt/omni/lbin/util_cmd -putopt SAP ICE OB2OPTS '-debug \ 1-200 INSTANCE.txt' -sublist Environment
/opt/omni/lbin/util_cmd -putopt SAP ICE NLS_LANG \ 'AMERICAN_AMERICA.US7ASCII' -sublist Environment
/opt/omni/lbin/util_cmd -putopt SAP ICE BR_TRACE "'10'"
-sublist Environment
/usr/omni/bin/util_cmd -putopt SAP ICE OB2OPTS '-debug \ 1-200 INSTANCE.txt' -sublist Environment
Other UNIX /usr/omni/bin/util_cmd -putopt SAP ICE NLS_LANG \ 'AMERICAN_AMERICA.US7ASCII' -sublist Environment
/usr/omni/bin/util_cmd -putopt SAP TOR BR_TRACE "'10'"
-sublist Environment
Retrieving Parameters
To retrieve the value of the OB2OPTS parameter for the SAP R/3 instance ICE, use the following command on the Data Protector SAP R/3 client:
• On Windows: <Data_Protector_home>\bin\util_cmd -getopt SAP ICE OB2OPTS -sublist Environment
• On HP-UX and Solaris: /opt/omni/lbin/util_cmd -getopt SAP ICE OB2OPTS -sublist \ Environment
• On other UNIX: /usr/omni/bin/util_cmd -getopt SAP ICE OB2OPTS -sublist \ Environment
Listing Parameters To list all the Data Protector SAP R/3 configuration file parameters for the SAP R/3 instance ICE, use the following command on the Data Protector SAP R/3 client:
• On Windows: <Data_Protector_home>\bin\util_cmd -getconf SAP ICE
• On HP-UX and Solaris: /opt/omni/lbin/util_cmd -getconf SAP ICE
• On other UNIX: /usr/omni/bin/util_cmd -getconf SAP ICE Deleting
Parameters
To remove the value of the OB2OPTS parameter for the SAP R/3 instance ICE, use the following command on the Data Protector SAP R/3 client:
• On Windows: <Data_Protector_home>\bin\util_cmd -putopt SAP ICE OB2PTS -sublist Environment
• On HP-UX and Solaris: /opt/omni/lbin/util_cmd -putopt SAP ICE OB2OPTS -sublist Environment
• On other UNIX: /usr/omni/bin/util_cmd -putopt SAP ICE OB2OPTS -sublist Environment
Configuring the Integration
Configuration Overview
Configuring the Data Protector SAP R/3 integration consists of these steps:
1. If you intend to use the Oracle Recovery Manager to backup the SAP R/3 database files, install and configure the Data Protector Oracle integration. When the Data Protector Oracle integration is configured, it is recommended to run a test Data Protector Oracle backup using the Oracle Recovery Manager.
2. Configure the SAP R/3 user (on UNIX systems only).
3. Configure the SAP R/3 Database Server.