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
-
On the SAP on Oracle Agent host, run the qlogin command to log on to the CommServe computer.
-
Download the CreateInstance_Template.xml file to the computer where you will run the command.
-
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.
-
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/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>
Examples
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'