Loading...

Adding SAP on Oracle Database Instances Using the SnapProtect Command Line Interface

Use XML to add SAP on Oracle database instances. Run the operation from the command line, or automate configuration by combining command line operations in a script.

You can include the XML parameters in the xml file, or you can specify them on the command line when they frequently change. For more information on command line parameters and XML elements, see Command Line - Syntax.

Procedure

  1. On the SAP on Oracle Agent host, run the qlogin command to log on to the CommServe computer.
  2. Download the CreateInstance_Template.xml file to the computer where you will run the command.
  3. Open the CreateInstance_Template.xml file, add your specific parameters, and save the file.

    For information on supported instance XML parameters, see SAP for Oracle XML Instance Parameters.

  4. On the command line, go to Software_Installation_Directory/Base and type the command.

    qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' -clientName 'client_name' -instanceName 'instance_name' -oracleHome 'oracle_home_path' -sapDataPath 'sap_data_path' -sapExeFolder 'sap_exe_path' -oracleUser/domainName 'domain_name' -oracleUser/userName 'user_name' -oracleUser/password 'password' -sqlConnect/domainName 'oracle_service_name' -sqlConnect/userName 'sql_user_name' -sqlconnect/password 'sql_password' -commandLineStoragePolicy/storagePolicyName 'command_line_storage_policy' -logBackupStoragePolicy/StoragePolicyName 'log_storage_policy' -dataArchiveGroup/storagePolicyName 'data_storage_policy' -blockSize <block_size> -useSAPSecureStore <true_false>

    UNIX

    qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' --clientName 'client_name' -instanceName 'instance_name' -oracleHome 'oracle_home_path' -sapDataPath 'sap_data_path' -sapExeFolder 'sap_exe_path' -oracleUser/userName 'user_name' -oracleUser/password 'password' -sqlConnect/userName 'sql_user_name' -sqlConnect/domainName 'oracle_service_name' -sqlConnect/userName 'sql_user_name' -sqlconnect/password 'sql_password' -commandLineStoragePolicy/storagePolicyName 'command_line_storage_policy' -logBackupStoragePolicy/StoragePolicyName 'log_storage_policy' -dataArchiveGroup/storagePolicyName 'data_storage_policy' -blockSize <block_size> -useSAPSecureStore <true_false>

  5. Run the qlogout command to log off the CommServe computer.

Examples

Expand All

Creating an Instance with '/' as the Connect String

To create an instance with '/' as the database connect string, set the sqlConnect parameter in the following command:

On Windows Client

qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' -clientName client1 -instanceName instance1 -oracleHome 'D:\app\admin\product\11.2.0\dbhome_1' -sapDataPath 'D:\app\CER' -sapExeFolder 'D:\app\CER\sys\exe\run' -oracleUser/userName 'oracle' -oracleUser/password 'oracle' -sqlConnect/domainName 'CER' -sqlConnect/userName '/' -sqlconnect/password 'sys' -commandLineStoragePolicy/storagePolicyName 'Sap_sp' -logBackupStoragePolicy/StoragePolicyName 'RTM_TEST' -dataArchiveGroup/storagePolicyName 'Sap_sp' -numberOfArchiveLogBackupStreams '3'

On UNIX Client

qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' -clientName client1 -instanceName instance1 /database/oracle114/app/oracle/product/11.2.0/dbhome_1' -sapDataPath '/database/oracle114/app/oracle/product/11.2.0/dbhome_1/CER' -sapExeFolder '/usr/sap/CER.11/SYS/exe/run' -oracleUser/userName 'oracle' -oracleUser/password 'oracle' -sqlConnect/domainName 'CER' -sqlConnect/userName '/' -sqlconnect/password 'sys' -commandLineStoragePolicy/storagePolicyName 'Sap_sp' -logBackupStoragePolicy/StoragePolicyName 'RTM_TEST' -dataArchiveGroup/storagePolicyName 'Sap_sp' -numberOfArchiveLogBackupStreams '3'

Creating an Instance with sys as the Connect String and Uses the blockSize, numberOfArchiveLogBackupStreams and useSAPSecureStore Parameters

To create the instance,  set the following parameters:

Parameter Value
sqlConnect 'sys
useSAPSecureStore 'true'
blockSize The block size (in this example, '65536')
numberOfArchiveLogBackupStreams The number of streams to use for an archive log backup (n this example, '3').

On Windows Client

qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' -clientName client1 -instanceName CER -oracleHome 'D:\app\admin\product\11.2.0\dbhome_1' -sapDataPath 'D:\app\CER' -sapExeFolder 'D:\app\CER\sys\exe\run' oracleUser/userName 'oracle' -oracleUser/password 'oracle' -sqlConnect/domainName 'CER' -sqlConnect/userName 'sys' -sqlconnect/password 'sys' -commandLineStoragePolicy/storagePolicyName 'Sap_sp' -logBackupStoragePolicy/StoragePolicyName 'RTM_TEST' -dataArchiveGroup/storagePolicyName 'Sap_sp' -numberOfArchiveLogBackupStreams '3' -blockSize '65536' -useSAPSecureStore 'true'

On UNIX Client

qoperation execute -af CreateInstance_Template.xml -appName 'SAP for Oracle' -clientName 'dbserveaix4' -instanceName 'CER' -oracleHome '/u01/app/112/dbhome' -sapDataPath '/u01/app/112/dbhome/CER' -sapExeFolder '/usr/sap/CER.10/SYS/exe/run' -oracleUser/userName 'oracle' -oracleUser/password 'oracle' -sqlConnect/domainName 'CER' -sqlConnect/userName 'sys' -sqlconnect/password 'sys' -commandLineStoragePolicy/storagePolicyName 'Sap_sp' -logBackupStoragePolicy/StoragePolicyName 'RTM_TEST' -dataArchiveGroup/storagePolicyName 'Sap_sp' -numberOfArchiveLogBackupStreams '3' -blockSize '65536' -useSAPSecureStore 'true'