Oracle Fusion Middleware provides a series of scripts that you can use to move your environment, for example replicating a test environment to a production environment. The scripts enable you to copy an Oracle home and Oracle WebLogic Server domains, as well as the configuration of certain Oracle Fusion Middleware components, such as Oracle HTTP Server. This appendix explains the scripts you can use to move these entities. It also describes the move plan properties that you edit when you move your environment.
This appendix contains the following sections:
The movement scripts copy the binary files of an Oracle home and the configuration of a domain and its components from a source environment and paste them at the target environment.
Use these scripts in conjunction with the procedures described in Chapter 19.
Oracle Fusion Middleware uses the following jar file to execute the scripts necessary to move the binary and configuration files:
(UNIX) ORACLE_COMMON_HOME/jlib/cloningclient.jar (Windows) ORACLE_COMMON_HOME\jlib\cloningclient.jar
Table A-1 shows the scripts you use to move an Oracle home or a domain and its components.
TO: | Script | See: |
---|---|---|
Copy the binary files of the source Oracle home |
(UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh (Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd |
|
Apply the copied Oracle home to the target |
(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh (Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd |
|
Copy a WebLogic Server domain and component configuration |
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd |
|
Copy a standalone domain and component configuration |
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd |
|
Copy the Node Manager configuration |
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd |
|
Extract a move plan from the domain or component |
(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh (Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd |
|
Apply the copied configuration for the WebLogic Server domain and component configuration to the target |
(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd |
|
Apply the copied standalone domain and component configuration to the target |
(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd |
|
Apply the copied configuration for the Node Manager to the target |
(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd |
|
Generate a file containing an obfuscated password |
(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh (Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd |
To view the help on any of these scripts, use the -help option. For example:
./pasteConfig.sh -javaHome /scratch/oracle/jdk1.7.0_17 -help
Note that the help shows the UNIX version of the parameter values. For other platforms, such as Windows, change the parameter values for the platform.
Note:
During the copyConfig and pasteConfig operations, the following parameters, which specific the maximum heap size and the maximum permanent generation space, are set:-Xmx512m -XX:MaxPermSize=256m
You can override these values using the T2P_JAVA_OPTIONS argument, as described in the following text.
To specify additional Java options, define the T2P_JAVA_OPTIONS environment variable and specify the options in the variable definition. The following examples set the value for the Java temp directory:
On Linux or UNIX:
setenv T2P_JAVA_OPTIONS "-Djava.io.tmpdir=/home/t2p/temp" export T2P_JAVA_OPTIONS
On Windows:
set T2P_JAVA_OPTIONS="-Djava.io.tmpdir=c:\home\t2p\temp"
Note:
A Universal Uniform Naming Convention (UNC) path is not supported on Windows. For example, the following is not supported:
\\host_name\oracle\java\win64\jdk6\jre\bin\java
The following topics describe the syntax of the movement scripts. The options are described in the tables that follow the syntax.
Note:
All movement scripts ask if you want to continue whenever you specify the -silent false
option. To continue, you must type yes
, which is not case sensitive. Any words other than yes
causes the script to abort. Also note that, in silent mode, the scripts generate an error if you do not provide passwords where they are needed.
Most options have shortcut names, as described in the tables later in this chapter.
The value of options must not contain a space. For example, on Windows, you cannot pass the following as a value to the -archiveLoc option:
C:\tmp\Archive Files
However, the value of the JavaHome option can contain a space.
On Windows, unless the command prompt uses MKS or another application to support Unix commands, and if the values contain a Windows-specific delimiter, such as an equals sign (=) or comma (,) you must wrap the entire value in double quotation marks ("). For example:
-additionalParams "search.encrypt.key=C:\T2P\encrypt.txt"
The vendor and version of Java used in the javaHome option must match the vendor and version of the JAVA_HOME property defined in the following file (note the period (.) before the filename):
ORACLE_HOME/wlserver/.product.properties
Creates an archive file of the source Oracle home, by copying the binary files of that Oracle home, including its WebLogic Server home, into the archive file.
The copyBinary script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh (Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd
The syntax is:
copyBinary -javaHome path_of_jdk -archiveLoc archive_location -sourceOracleHomeLoc ORACLE_HOME_location [-logDirLoc log_dir_path] [-silent {true | false}] [-ignoreDiskWarning {true | false}]
The following example shows how to create an archive of an Oracle home on Linux:
copyBinary.sh -javaHome /scratch/oracle/jdk1.7.0_17 -archiveLoc /tmp/oh_copy.jar -sourceOracleHomeLoc /scratch/oracle/Oracle_home1
Note:
When you execute the script, you must specify a matching Java home. That is, if the Oracle homes are 64 bit, you must specify a 64-bit Java home. If the Oracle homes are 32 bit, you must specify a 32-bit Java home.Table A-2 describes the options for the copyBinary script.
Table A-2 Options for the copyBinary Script
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file to be created with the copyBinary script. The archive location must not exist. Ensure that the archive location is not within the Oracle home structure. |
Mandatory |
-sourceOracleHomeLoc |
-soh |
The absolute path of the Oracle home to be archived. You can only specify one Oracle home. In previous releases, this option was sourceMWHomeLoc. That option is deprecated. |
Mandatory |
-invPtrLoc |
-ipl |
This option is deprecated. If you specify it, it will be ignored. On UNIX and Linux, the absolute path to the Oracle Inventory pointer. |
Ignored |
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
-ignoreDiskWarning |
-idw |
Specifies whether the operation ignores a warning that there is not enough free space available. The default is false. You may need to use this flag if the target is NFS mounted or is on a different file system, such as Data ONTAP. |
Optional |
Applies the archive to the target destination, by pasting the binary files of the source Oracle home to the target environment. You can apply the archive to the same host or a different host.
Before you execute this script, see Section 19.2.3 for information about steps you may need to take to prepare your target environment.
The pasteBinary script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh (Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd
The syntax is:
pasteBinary -javaHome path_of_jdk -archiveLoc archive_location -targetOracleHomeLoc target_Oracle_Home_location [-targetOracleHomeName Oracle_home_name] [-ouiParam key1=value], key2=value] [-ohAlreadyCloned {true | false}] [-executeSysPrereqs {true | false}] [-invPtrLoc Oracle_InventoryLocation] [-logDirLoc log_dir_path] [-silent {true | false}] [-ignoreDiskWarning {true | false}]
The following example shows how to apply the archive to the directory /scratch/oracle/Oracle_home_prod, on Linux:
pasteBinary.sh -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/oh_copy.jar -targetOracleHomeLoc /scratch/oracle/Oracle_home_prod -targetOracleHomeName Oracle_home_prod
Table A-3 describes the options for the pasteBinary script.
Table A-3 Options for the pasteBinary Script
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file created with the copyBinary script. The location must exist. This option is mutually exclusive with the -ohAlreadyCloned option. |
Mandatory |
-targetOracleHomeLoc |
-toh |
The absolute path of the target Oracle home. It will be used to configure the domain. Ensure that the Oracle home directory does not exist at that location, or if it does, it is an empty directory. Otherwise, the script returns an error message. The -targetOracleHomeLoc cannot be inside another Oracle home. |
Mandatory |
-targetOracleHomeName |
-tohn |
The name for the Oracle home. This name is used to register the Oracle home with Oracle Inventory, |
Optional |
-ouiParam |
-op |
Additional variables to be passed to Oracle Universal Installer, which is run as part of this script. You must pass the variables as key=value pairs. Separate multiple variables with commas. On Windows, surround the entire value pair with double quotation marks ("). |
Optional |
-ohAlreadyCloned |
-ohac |
A flag specifying that the script reconfigure an already existing Oracle home that was created using a storage-level cloning tool. If this flag is set to true, then the target Oracle home should exist and it should contain Oracle home binaries. Valid values are You cannot use this option when you use the -archiveLoc option. |
Optional |
-executeSysPrereqs |
-esp |
Specifies whether the pasteBinary operation checks the prerequisites of the Oracle home. The default is that it checks the prerequisites. To specify that it does not check the prerequisites, specify this option with the value |
Optional |
-invPtrLoc |
-ipl |
On UNIX and Linux, the absolute path to the Oracle Inventory pointer. Use this option if the inventory location is not in the default location, so that the operation can register the Oracle homes with the central Oracle inventory specified in the Oracle Inventory pointer file. If the oraInst.loc is not present at default location, you must create this file either at default location as a root user or at any other location as a root or normal user. The following shows an example of the contents of the file: inventory_loc=/scratch/oraInventory If the directory specified as the inventory_loc does not exist, the operation will create it. You must have write permission to the inventory location. On AIX and Linux, the default location is /etc/oraInst.loc. In other UNIX platforms, the default location is /var/opt/oracle/oraInst.loc This parameter is only supported on UNIX. On Windows, if you specify this parameter, the script returns an error. |
Optional, if the inventory is in the default location. Otherwise, it is mandatory on Linux. |
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
-ignoreDiskWarning |
-idw |
Specifies whether the operation ignores a warning that there is not enough free space available. The default is false. You may need to use this flag if the target is NFS mounted or is on a different file system, such as Data ONTAP. |
Optional |
Creates a configuration archive that contains the snapshot of the configuration of a WebLogic Server domain. The underlying components of a WebLogic Server domain retain their configuration information in different data stores, such as a file system, Oracle Metadata Services (MDS), LDAP, or a database.
You must run the copyConfig script for each WebLogic Server domain in the source environment. A configuration archive is created for each source domain.
The Administration Server and all Managed Servers in the domain must be started when you run the script.
The copyConfig script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd
The syntax is:
copyConfig -javaHome path_of_jdk -archiveLoc archive_location -sourceDomainLoc domain_location -sourceOracleHomeLoc Oracle_home_location -domainHostName domain_host_name -domainPortNum domain_port_number -domainAdminUserName domain_admin_username -domainAdminPasswordFile domain_admin_password_file [-mdsDataExport {true | false}] [-opssDataExport {true | false}] [-trustKeyStoreLoc custom_trust_keystore_path [-additionalParams property1=value1[, property2=value2] [-logDirLoc log_dir_path] [-silent {true | false}]
The following example copies the configuration of a WebLogic Server domain:
copyConfig.sh -javaHome /scratch/oracle/jdk1.7.0_17 -archiveLoc /tmp/a.jar -sourceDomainLoc /scratch/oracle/config/domains/WLS_domain -sourceOracleHomeLoc /scratch/oracle/Oracle_home1 -domainHostName myhost.example.com -domainPortNum 7001 -domainAdminUserName weblogic -domainAdminPasswordFile /home/oracle/password_file.txt
Table A-4 describes the options for the copyConfig script for Oracle WebLogic Server domains.
Table A-4 Options for the copyConfig Script for a Oracle WebLogic Server Domains
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file to be created by the copyConfig script. |
Mandatory |
-sourceDomainLoc |
-sdl |
The absolute path of the source domain containing the Java component. Note that on Windows, you should not include a backslash at the end of the path. |
Mandatory |
-sourceOracleHomeLoc |
-soh |
The absolute path of the source Oracle home. |
Mandatory |
-domainHostName |
-dhn |
The name of the host on which the domain is configured. |
Mandatory |
-domainPortNum |
-dpn |
The port number of the Administration Server for the domain. |
Mandatory |
-domainAdminUserName |
-dau |
The name of the administrative user for the domain. |
Mandatory |
-domainAdminPasswordFile |
-dap |
The absolute path of a secure file containing the password for the administrative user for the domain on the source environment. You must provide a password file, even if you are not changing the configuration. |
Mandatory |
-mdsDataExport |
-mde |
Specifies whether to export the application MDS metadata to the archive so that it can be imported into the target. The default is true. Specify false if you do not want to export the application MDS metadata. If this option is set to true, the subsequent pasteConfig script that copies the component to the target imports the application MDS metadata to the target. |
Optional |
-opssDataExport |
-ode |
Specifies whether to export the Oracle Platform Security Services data. The default is true. If this option is set to true, the subsequent pasteConfig script that copies the component to the target imports the Oracle Platform Security Services data to the target. Note: If this option is set to true, you must set the following environment variable before you run the pasteConfig script: CONFIG_JVM_ARGS "-Xmx2048M -Xms2048M" |
Optional |
-trustKeyStoreLoc |
-tkl |
The absolute path of the trust keystore location. Use this parameter if the domainPortNum is an SSL port and the server is configured with custom identity and custom trust keystores. |
|
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-additionalParams |
-ap |
An additional parameter and its value to be passed to the script. You must pass the variables as key=value pairs. Separate multiple variables with commas. On Windows, surround the entire value pair with double quotation marks ("). |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Creates a configuration archive that contains the snapshot of the configuration of a standalone domain. The underlying components of the domain retain their configuration information in different data stores, such as a file system or a database.
You must run the copyConfig script for each domain in the source environment. A configuration archive is created for each source domain.
The copyConfig script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd
The syntax is:
copyConfig -javaHome path_of_jdk -archiveLoc archive_location -sourceDomainLoc domain_location -sourceOracleHomeLoc Oracle_home_location [-additionalParams property1=value1[, property2=value2] [-logDirLoc log_dir_path] [-silent {true | false}]
The following example copies the configuration of a standalone domain:
copyConfig.sh -javaHome /scratch/oracle/jdk1.7.0_17 -archiveLoc /tmp/a.jar -sourceDomainLoc /scratch/oracle/config/domains/base_domain -sourceOracleHomeLoc /scratch/oracle/Oracle_home1/
Table A-4 describes the options for the copyConfig script for standalone domains.
Table A-5 Options for the copyConfig Script for Standalone Domains
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file to be created by the copyConfig script. |
Mandatory |
-sourceDomainLoc |
-sdl |
The absolute path of the source domain containing the component. Note that on Windows, you should not include a backslash at the end of the path. |
Mandatory |
-sourceOracleHomeLoc |
-soh |
The absolute path of the source Oracle home. |
Mandatory |
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-additionalParams |
-ap |
An additional parameter and its value to be passed to the script. You must pass the variables as key=value pairs. Separate multiple variables with commas. On Windows, surround the entire value pair with double quotation marks ("). |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Creates a configuration archive that contains the snapshot of the configuration of Node Manager.
You must run the copyConfig script for each Node Manager in the source environment. A configuration archive is created for each source Node Manager.
The copyConfig script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd
The syntax is:
copyConfig -javaHome path_of_jdk -archiveLoc archive_location -sourceNMHomeLoc source_Node_Manager_Home_location [-logDirLoc log_dir_path] [-silent {true | false}]
The following example shows how to create a copy of the source Node Manager configuration located in /scratch/oracle/Oracle_home1/wlserver/common/nodemanager:
copyConfig.sh -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/nm.jar -sourceNMHomeLoc /scratch/oracle/Oracle_home1/wlserver/common/nodemanager
Table A-6 describes the options for the copyConfig script for Node Manager.
Table A-6 Options for the copyConfig Script for Node Manager
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
|
None |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
|
|
The absolute path of the archive location. Use this option to specify the location of the archive file to be created by the copyConfig script. |
Mandatory |
|
|
The absolute path of the source Node Manager home. |
Mandatory |
|
|
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
|
None |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Extracts configuration information from the archive into a move plan. It also extracts any needed configuration plans. Then, you edit the move plan, specifying properties for the target environment.
The extractMovePlan script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh (Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd
The syntax is:
extractMovePlan -javaHome path_of_jdk -archiveLoc archive_location -planDirLoc move_plan_directory [-optimizationHints fusionApps,sameSchemaNameSinglePassword, rpdDataSource} [-logDirLoc log_dir_path]
The following example extracts the plans from the archive j2ee.jar:
extractMovePlan.sh -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/j2ee.jar -planDirLoc /scratch/oracle/t2p_plans
The extractMovePlan script extracts the move plan to the specified directory. Depending on the type of component that you are moving, the extractMovePlan script may also extract other configuration plans. For example, it might extract the following:
/scratch/oracle/t2p_plans/moveplan.xml /scratch/oracle/t2p_plans/composites/configplan1.xml /scratch/oracle/t2p_plans/composites/configplan2.xml /scratch/oracle/t2p_plans/adapters/deploymentplan1.xml /scratch/oracle/t2p_plans/adapters/deploymentplan2.xml
Table A-7 describes the options for the extractMovePlan script:
Table A-7 Options for the extractMovePlan Script
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file created by the copyConfig script. |
Mandatory |
-planDirLoc |
-pdl |
The absolute path to a directory to which the move plan, along with any needed configuration plans, is to be extracted. The directory must not exist or, if it exists, it is empty. |
Mandatory |
-optimizationHints |
-opth |
Specifies the configuration values to auto-populate based on the topology on the target environment. These values are omitted from the move plan. Use of the hints is recommended if they apply to your environment. This option takes the following arguments:
|
Optional |
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
For information about the properties in the move plans, and which properties you should edit, see Section A.2.
Applies the copied configurations from the source environment to the target environment. Inputs for the script include the location of the configuration archive created with the copyConfig script for the domain and the location of the modified move plan. The pasteConfig script re-creates the configuration information for the Oracle WebLogic Server domain in the target environment. It also merges the move plan property values for the target environment.
The pasteConfig script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd
The syntax is:
pasteConfig -javaHome path_of_jdk -archiveLoc archive_location -targetDomainLoc trgt_domain_path -targetOracleHomeLoc trgt_Oracle_Home_path -movePlanLoc move_plan_path -domainAdminPasswordFile domain_admin_password_file [-appDir WLS_application_directory] [-logDirLoc log_dir_path] [-silent {true | false}]
The following example shows how to apply the archive of the domain to the Oracle home Oracle_home1:
pasteConfig.sh -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/java_ee_cl.jar -targetDomainLoc /scratch/oracle/config/domains/dom_cl -targetOracleHomeLoc /scratch/oracle/Oracle_home1 -movePlanLoc /scratch/oracle/java_ee/move_plan.xml -domainAdminPasswordFile /scratch/pwd_dir/pass.txt -logDirLoc /tmp/log
Note:
Table A-8 describes the options for the pasteConfig script for Oracle WebLogic Server domains.
Table A-8 Options for the pasteConfig Script for Oracle WebLogic Server Domains
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file created by the copyConfig script. |
Mandatory |
-targetDomainLoc |
-tdl |
The absolute path of the target domain. The directory must not exist or, if it exists, it must be empty. The domain directory may be located outside of the directory structure of the Oracle home. |
Mandatory |
-targetOracleHomeLoc |
-toh |
The absolute path of the target Oracle home. It will be used to configure the domain. |
Mandatory |
-movePlanLoc |
-mpl |
The absolute path of the updated version of the move plan that was extracted from the source. |
Mandatory |
-domainAdminPasswordFile |
-dap |
The absolute path of a secure file containing the password for the administrative user for the domain on target environment. You must provide a password file, even if you are not changing the configuration. Note that the password is based on the authentication provider for the domain. For example, the authenticator can be an embedded LDAP or an external LDAP. |
Mandatory. |
-appDir |
-ad |
The absolute path of the Oracle WebLogic Server application directory on the target. |
Optional |
-logDirLoc |
-ldl |
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Applies the copied configurations from the source environment to the target environment. Inputs for the script include the location of the configuration archive created with the copyConfig script for the domain and the location of the modified move plan. The pasteConfig script re-creates the configuration information for the standalone domain in the target environment. It also merges the move plan property values for the target environment.
The pasteConfig script is located in:
(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd
The syntax is:
pasteConfig -javaHome path_of_jdk -archiveLoc archive_location -targetDomainLoc trgt_domain_path -targetOracleHomeLoc trgt_Oracle_Home_path -movePlanLoc move_plan_path [-logDirLoc log_dir_path] [-silent {true | false}]
The following example shows how to apply the archive of the domain to the Oracle home Oracle_home1:
pasteConfig.sh -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/java_ee_cl.jar -targetDomainLoc /scratch/oracle/config/domains/dom_cl -targetOracleHomeLoc /scratch/oracle/Oracle_home1 -movePlanLoc /scratch/oracle/java_ee/move_plan.xml -logDirLoc /tmp/log
Table A-8 describes the options for the pasteConfig script for standalone domains.
Table A-9 Options for the pasteConfig Script for Standalone Domains
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
-javaHome |
NA |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
-archiveLoc |
-al |
The absolute path of the archive location. Use this option to specify the location of the archive file created by the copyConfig script. |
Mandatory |
-targetDomainLoc |
-tdl |
The absolute path of the target domain. The directory must not exist or, if it exists, it must be empty. The domain directory may be located outside of the directory structure of the Oracle home. |
Mandatory |
-targetOracleHomeLoc |
-toh |
The absolute path of the target Oracle home. It will be used to configure the domain. |
Mandatory |
-movePlanLoc |
-mpl |
The absolute path of the updated version of the move plan that was extracted from the source. |
Mandatory |
-logDirLoc |
-ldl |
The location of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
-silent |
NA |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Applies the copied configurations of Node Manager from the source environment to the target environment. Inputs for the script include the location of the configuration archive created with the copyConfig script for the Oracle WebLogic Server Node Manager and the location of the modified move plan. The pasteConfig script re-creates the configuration information for Node Manager in the target environment. It also merges the move plan property values for the target environment.
Note:
All the domains that are to be managed by Node Manager should be moved before applying the copy of Node Manager to the target environment. In addition, the Administration Server must be running.You must run the pasteConfig script for each Node Manager in the target environment.
The syntax is:
pasteConfig -javaHome path_of_jdk -archiveLoc archive_location -targetNMHomeLoc trgt_Node_Manager_Home_path -targetOracleHomeLoc trgt_Oracle_Home_path -movePlanLoc move_plan_path [-logDirLoc log_dir_path] [-silent {true | false}]
The following example shows how to apply the copy of Node Manager to the Node Manager home located in /scratch/Oracle_home1/wlserver/common/nodemanager:
pasteConfig -javaHome /scratch/oracle/jdk1.7.7.0_17 -archiveLoc /tmp/nm.jar -targetNMHomeLoc /scratch/oracle/Oracle_home1/wlserver/common/nodemanager -targetOracleHomeLoc /scratch/oracle/Oracle_home1 -movePlanLoc /scratch/oracle/t2pplans/nm/moveplan.xml
Table A-10 describes the options for the pasteConfig script for Node Manager.
Table A-10 Options for the pasteConfig Script for Node Manager
Options | Shortcut | Description | Mandatory or Optional |
---|---|---|---|
|
None |
The absolute path of the Java Developer's Kit. The script detects if the operating system is 64 bit and passes the -d64 option to the scripts in the command line. |
Mandatory |
|
|
The absolute path of the archive location. Use this option to specify the location of the archive file created by the copyConfig script. |
Mandatory |
|
|
The absolute path of the target Node Manager. |
Mandatory |
|
|
The absolute path of the target Oracle home that will be used to configure Node Manager. |
Mandatory |
|
|
The absolute path of the modified move plan in the target environment. |
Mandatory |
|
|
The absolute path of a directory. The directory may or may not exist. A new log file is created in the directory. The default is the system Temp location. |
Optional |
|
None |
Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation does not prompt for confirmation. To specify that it does prompt for confirmation, specify this option with the value of |
Optional |
Generates a file that contains the obfuscated password. In the scripts and in the move plans, you often need to provide files containing passwords. The script prompts you to enter the password and the location where the password file is to be written.
The syntax is:
(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh (Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd
When you move Oracle Fusion Middleware components, you run the extractMovePlan script to create a move plan for the entity that you are moving. The extractMovePlan script extracts configuration information from the archive into a move plan. It also extracts any needed configuration plans. Before you apply the archive to the target, you must edit the move plan to reflect the values of the target environment.
You can modify properties with the scope of READ_WRITE. Do not modify the properties with the scope of READ_ONLY.
Notes:
Do not add, comment, or remove any section of a move plan.
You must generate a move plan using the extractMovePlan script each time you create an archive, even if you have made no changes to the move plan. If you use a move plan that was created with a different archive, the archive will not be accepted and the pasteConfig script will fail.
This section provides the following topics:
Most move plans contain multiple configGroup elements. When a property is associated with a particular configGroup element, the tables listing the properties group the properties by configGroup element. For example, Table A-13, which shows the properties for the move plan for Java components, shows multiple configGroup elements, such as SERVER_CONFIG and MACHINE_CONFIG.
The following example shows a portion of the move plan for Java components, with portions of the SERVER_CONFIG and MACHINE_CONFIG configGroup elements:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <movePlan> <movableComponent> <componentType>J2EEDomain</componentType> <moveDescriptor> <StartupMode>PRODUCTION</StartupMode> <configGroup> <type>SERVER_CONFIG</type> <configProperty id="Server1"> <configProperty> <name>Server Name</name> <value>AdminServer</value> <itemMetadata> <dataType>STRING</dataType> <scope>READ_ONLY</scope> </itemMetadata> </configProperty> . . . </configGroup> <configGroup> <type>MACHINE_CONFIG</type> <configProperty id="Machine1"> <configProperty> <name>Machine Name</name> <value>LocalMachine</value> <itemMetadata> <dataType>STRING</dataType> <scope>READ_WRITE</scope> </itemMetadata> </configProperty> <configProperty> <name>Node Manager Listen Address</name> <value>example.com</value> <itemMetadata> <dataType>STRING</dataType> <scope>READ_WRITE</scope> </itemMetadata> </configProperty> . . . </configGroup>
The tables in this section describe the move plan properties you can customize for Oracle Fusion Middleware entities and components.
Note:
Many move plan properties require that you provide the location of a file containing a password. If you want to use obfuscated passwords, you can use the obfuscatePassword script, as described in Section A.1.1.10.The properties that you edit differ depending on the type of component. Table A-11 provides pointers to the appropriate list of properties for each component.
Table A-11 Move Plan Properties for Components
Component | Where to find the list of properties: |
---|---|
Node Manager |
|
All Java components |
|
Oracle ADF connections |
|
Oracle Coherence |
|
Oracle HTTP Server |
|
Oracle Web Services Manager |
|
Oracle Data Integrator |
|
Oracle User Messaging Service |
|
Table A-12 describes the move plan properties that you can change for Node Manager. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
Table A-12 Move Plan Properties for Node Manager
Property | Description | Sample Value |
---|---|---|
Properties in the NODE_MANAGER_PROPERTIES configGroup: |
Node Manager configuration |
|
Node Manager Home |
The absolute location of Node Manager |
/scratch/oracle/domains/base_domain/nodemanager |
Listen Address |
The Listen address of Node Manager. |
example.com |
Listen Port |
The number of the Listen port of Node Manager. |
5557 |
Custom Identity KeyStore File |
The absolute path of the custom identity keystore file location. This property is present in the move plan only if the source environment is configured with SSL. |
/scratch/oracle/Oracle_home1/wlserver/server/lib/example_identity.jks |
Custom Identity Private Key Alias |
The value of the identity key store alias. This property is present in the move plan only if the source environment is configured with SSL. |
mykey |
Custom Identity Private Key Passphrase File |
The absolute path to the secure file containing the private key used when creating a certificate. This property is present in the move plan only if the source environment is configured with SSL. |
/scratch/oracle/key_passwd |
Custom Identity Keystore Passphrase File |
The absolute path to the secure file containing the custom identity keystore password. If source environment uses DemoTrust, these properties are optional. If left blank, the pasteConfig script shows a warning message and proceed. If source environment uses Custom, these parameters are mandatory. |
/scratch/oracle/i_passwd.txt |
Java Standard Trust Keystore Passphrase File |
The absolute path of the Java standard trust keystore file location. |
|
Properties in the DOMAINS configGroup: |
Oracle WebLogic Server domain configuration |
|
Domain Name |
The name of the domain. |
WLS_domain |
Domain Location |
The absolute path of the domain location. |
/scratch/oracle/config/domains/WLS_domain |
AdminServer Listen Address |
The Listen address of the Administration Server. |
example.com |
AdminServer Listen Port |
The number of the Listen port of the Administration Server. |
7001 |
AdminServer User Name |
The administration user name. |
weblogic |
AdminServer Password |
The absolute path to the secure file containing the administration user's password. |
/scratch/oracle/admin_passwd |
Node Manager User Name |
The Node Manager user name. |
weblogic |
Node Manager Password |
The absolute path to the secure file containing the Node Manager user's password. |
/scratch/oracle/nm_passwd |
Table A-13 describes the move plan properties that you can change for Java components. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
Table A-13 Common Move Plan Properties for Java Components
Property | Description | Sample Value |
---|---|---|
Startup Mode |
The startup mode of an Oracle WebLogic Server domain. Valid values are:
The default is PRODUCTION. |
PRODUCTION |
Properties in the SERVER_CONFIG configGroup: |
Common Java component properties |
|
Administration Port |
The port number for the Administration Server. |
7001 |
Listen Address |
The Listen address of the WebLogic Server. Set it to the host name or set it to |
All Local Addresses |
Listen Port |
The number of the Listen port. If you do not provide a port number or if the port number you provide is not available, the operation returns an error. |
8001 |
SSL Listen Port |
The number of the SSL Listen port. This property is present in the move plan if SSL is enabled. |
7002 |
Frontend Host |
The host name of the HTTP Server. This property is present in the move plan only if the HTTP Server is set as the frontend to the server. |
example.com |
Frontend HTTP Port |
The number of the HTTP Server port. This property is present in the move plan only if the HTTP Server is set as the frontend to the server. |
10605 |
Frontend HTTPS Port |
The number of the HTTPS Server port. This property is present in the move plan only if the HTTP Server is set as the frontend to the server. |
10666 |
KeyStore Type |
The type of keystore. |
JKS |
Custom Identity Keystore File |
The absolute path of custom identity keystore file location. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. The same type of store will be created in the target environment. If the Startup Mode is PRODUCTION and SSL is enabled in the source environment (regardless of whether you use DemoTrust or CustomTrust), you must provide a value for this parameter. |
/scratch/oracle/Oracle_home1/wlserver/server/lib/example_identity.jks |
Custom Identity Keystore Passphrase File |
The absolute path to the secure file containing the custom identity keystore password. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. If the Startup Mode is PRODUCTION and SSL is enabled in the source environment (regardless of whether you use DemoTrust or CustomTrust), you must provide a value for this parameter. |
/scratch/oracle/i_passwd |
Custom Trust Keystore File |
The absolute path of custom trust keystore file location. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. If the Startup Mode is PRODUCTION and SSL is enabled in the source environment (regardless of whether you use DemoTrust or CustomTrust), you must provide a value for this parameter. |
/scratch/Oracle/Middleware/wlserver/server/lib/example_trust.jks |
Custom Trust Keystore Passphrase File |
The absolute path to the secure file containing the custom trust keystore password. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. If the Startup Mode is PRODUCTION and SSL is enabled in the source environment (regardless of whether you use DemoTrust or CustomTrust), you must provide a value for this parameter. |
/scratch/oracle/key_passwd |
Custom Identity Private Key Alias |
The private key alias. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. If the Startup Mode is PRODUCTION and SSL is enabled in the source environment (regardless of whether you use DemoTrust or CustomTrust), you must provide a value for this parameter. |
fmw_key |
Custom Identity Private Key Passphrase File |
The absolute path to the secure file containing the custom identity private key password. If the Startup Mode is DEVELOPMENT and the source environment uses DemoTrust as the keystore, you can leave this parameter blank. The same type of store will be created in the target environment. If the Startup Mode is DEVELOPMENT and the source environment uses CustomTrust as the keystore, you must provide a value for this parameter. |
/scratch/oracle/i_passwd |
Properties in the CLUSTER_CONFIG configGroup: |
Oracle WebLogic Server Cluster configuration properties |
|
Messaging Mode |
The cluster messaging mode. Acceptable values are |
multicast |
Cluster Address |
The cluster address. |
localhost |
Unicast Channel |
The name of the unicast channel. |
MyMulticastChannel |
Multicast Address |
The multicast address. |
239.192.0.0 |
Multicast Port |
The port number of the multicast address. |
8899 |
Frontend Host |
The name or IP address of the front-end host for the cluster. |
example.com |
Frontend HTTP Port |
The HTTP port number for the front-end host for the cluster. |
7008 |
Frontend HTTPS Port |
The HTTPS port number for the front-end host for the cluster. |
7009 |
Properties in the MACHINE_CONFIG configGroup: |
Machine configuration properties |
|
Machine Name |
The name of the machine. |
example.com |
Node Manager Listen Address |
The Listen address of the machine running Node Manager. |
example.com |
Node Manager Listen Port |
The port number of the Listen address of the machine running Node Manager. |
5556 |
Property in the DEPLOYMENT_PLAN_CONFIG configGroup: |
Deployment plans |
|
Application Name |
The name of the application. |
helloWorldEar |
Deployment Plan |
The location where an application's deployment plan is to be extracted. The location is relative to the location of the move plan. |
deploy_plans/helloWorldEar_plan.xml |
Properties in the AUTHENTICATORS configGroup: |
Authenticator configuration |
|
Host Name |
The LDAP server host name. |
example.com |
Port |
The LDAP server port number. |
3060 |
Principal |
The administration user for the LDAP server. |
cn=orcladmin |
Password File |
The absolute path of a secure file containing the password for the LDAP user. You must provide a password file, even if you are not changing the configuration. |
/scratch/oracle/ldap_passwd.txt |
User Base DN |
The user base distinguished name (DN). |
cn=users,dc=us,dc=oracle,dc=com |
User Object Class |
The user object class. |
person |
Group Base DN |
The group base distinguished name (DN). |
cn=groups,dc=us,dc=oracle,dc=com |
GUID Attribute |
The global unique identifier. |
orclguid |
Properties in the DATASOURCE configGroup: |
Data source configuration |
|
Driver Class |
The driver class of the data source. Refer to "Using JDBC Drivers with WebLogic Server" in the Administering JDBC Data Sources for Oracle WebLogic Server to choose the appropriate class. |
oracle.jdbc.OracleDriver |
Url |
The URL of the database for the data source. It contains the host name, the database port number, and SID. It has the following format: jdbc:oracle:thin:@Db_host:Db_port:Db_SID |
jdbc:oracle:thin:@host.examplecom:1521:orcl |
User |
The schema name of the data source. |
OFM_MDS |
Password File |
The absolute path to the secure file containing the password of the database schema. You must provide a password file, even if you are not changing the configuration of the data source. |
/scratch/oracle/ds_passwd.txt |
ONS Node List |
The list of Oracle Notification Service (ONS) hosts and ports, in the following format: ons_host1:port1,ons_host2:port2 |
myhost1:6100,myhost2:6101 |
ONS Wallet File |
The absolute path to the credential store file, which contains keys and certificates. This property is configured only if SSL is enabled. |
/scratch/wallet |
ONS Wallet Password File |
The absolute path to the file containing the password for the wallet. |
/scratch/ons_pass.txt |
Properties in the OPSS_SECURITY configGroup, in the configProperty with the ID of LDAP. |
LDAP-based policy and credential store configuration. If the source is a file-based store, these properties, as well as the LDAP-based and database-based Policy and Credential Store properties are present in the move plan. When you configure the move plan, you can change from a file-based to an LDAP or database-based store. If the source is LDAP-based, only the LDAP properties are present in the move plan. You cannot change it to a different type, but you can change the LDAP endpoints. If the source is database-based, only the database properties are present in the move plan. You cannot change it to a different type, but you can change the database-based endpoints. You can only use one type of store. To use one, uncomment the section in the move plan and ensure the other is commented. |
|
Password File |
The absolute path to the secure file containing the password of the LDAP Server Administrative user. You must provide a password file, even if you are not changing the configuration of the LDAP Server. |
/scratch/oracle/ldap_passwd.txt |
LDAP User |
The LDAP Server administrative user name. |
cn=orcladmin |
Jps Root |
The LDAP Server context root. |
cn=jpsRoot |
Domain |
The name of the domain. |
WLS_domain |
LDAP Url |
The URL of the LDAP connection. It contains the host name and port number of the LDAP store. |
ldap://example.com:3060 |
Properties in the OPSS_SECURITY configGroup, in the configProperty with the ID of DB: |
Database-based policy and credential store configuration. If the source is a file-based store, these properties are present in the move plan. (The LDAP-based store is not present and you cannot move from a database-based to an LDAP-based store.) When you configure the move plan, you can change from a file-based to an LDAP or database-based store. You can only use one type of store. To use one, uncomment the section in the move plan and ensure the other is commented. If the source is database-based, only the database properties are present in the move plan. You cannot change it to a different type, but you can change the database-based endpoints. |
|
Password File |
The absolute path to the secure file containing the password of the OPSS schema owner. You must provide a password file, even if you are not changing the configuration. |
/scratch/oracle/ldap_passwd.txt |
DataSource Name |
The name of the data source. The name cannot contain a slash (/). |
opssds |
DataSource Jndi Name |
The JNDI name of the data source. |
jdbc/opss |
Jps Root |
The LDAP Server context root. |
cn=jpsRoot |
Domain |
The name of the domain. |
WLS_domain |
Driver Class |
The driver class of the data source. Refer to "Selecting a JDBC Driver" in the Administering JDBC Data Sources for Oracle WebLogic Server to choose the appropriate class. |
oracle.jdbc.OracleDriver |
Url |
The URL of the database for the data source. It contains the host name, the database port number, and SID. It has the following format: jdbc:oracle:thin:@Db_host:Db_port:Db_SID |
jdbc:oracle:thin:@host.example.com:1521:orcl |
User |
The name of the OPSS schema owner of the data source. |
DEV_OPSS |
Properties in the RDBMS Security Store configGroup: |
Database-based security store configuration |
|
URL |
The URL of the database for the data source. It contains the host name, the database port number, and SID. It has the following format: jdbc:oracle:thin:@Db_host:Db_port:Db_SID |
jdbc:oracle:thin:@host.example.com:1521:orcl |
Driver Class |
The driver class of the RDBMS Security Store connection. Refer to "Using JDBC Drivers with WebLogic Server" in the Administering JDBC Data Sources for Oracle WebLogic Server to choose the appropriate class. |
oracle.jdbc.OracleDriver |
User |
The name of the schema owner. |
admin |
Password File |
The absolute path to the secure file containing the password of the security store schema owner. You must provide a password file, even if you are not changing the configuration. |
/scratch/oracle/rbms_passwd.txt |
Property in the ADAPTER configGroup: |
Resource adapter configuration |
|
Deployment Plan |
The path to the deployment plan to be used during movement to the target. The path can be absolute, or relative to the location of the move plan. The deployment plan is extracted by the extractMovePlan script. |
/scratch/adapters/adapters.xml |
Table A-14 describes the move plan properties that you can change if you are using Oracle ADF connections. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment. The table is divided by component. For some components, the description column lists the OBJECT_NAME_PROPERTY type. You can search for the type to locate the relevant section.
Table A-14 Move Plan Properties for Oracle ADF Connections
Property | Description | Sample Value |
---|---|---|
Oracle ADF URL Connection |
OBJECT_NAME_PROPERTY type is URLConnProvider |
|
Port |
The port number used for the URL connections. |
7000 |
URL |
The URL used for the connection. |
example.com |
Oracle ADF Business Components Service Connection |
OBJECT_NAME_PROPERTY type is ADFBCServiceConnection |
|
ServiceEndpointProvider |
The Business Components service endpoint provider. |
ADFBC |
JndiFactoryInitial |
The JNDI initial factory class. |
com.sun.java.jndi.InitialFactory |
JndiProviderUrl |
The URL of the JNDI provider. |
t3://example.com:7101 |
JndiSecurityPrincipal |
The JNDI security principal name. |
weblogic |
WebServiceConnectionName |
The Web service connection name. |
test |
Oracle Enterprise Scheduler |
OBJECT_NAME_PROPERTY type is EssConnection |
|
NotificationServiceURL |
The Oracle Enterprise Scheduler notification service URL. |
http://localhost:8001 |
RequestFileDirectory |
The path of the directory where request logs for jobs from OES ConcurrentProcessor (CP) extension is to be created. |
/tmp/ess/requestFileDirectory |
SAMLTokenPolicyURI |
The SAML Policy URI to be used by CP extension. |
oracle/wss11_saml_token_with_message_protection_service_policy |
EssCallbackClientSecurityPolicyURI |
The security policy to be used in the WS-Security headers for Web service invocations from Oracle Enterprise Scheduler for Web service callbacks. |
oracle/wss11_saml_token_with_message_protection_client_policy |
Oracle Essbase |
OBJECT_NAME_PROPERTY type is EssbaseConnProvider |
|
Host |
The host name for the Oracle Essbase server. |
example.com |
Cluster |
The name of the cluster of which the Oracle Essbase server is a member. |
esbCluster |
Port |
The Listen port number of the Oracle Essbase server. |
1423 |
Username |
The user name. |
user3 |
Oracle Web Services |
OBJECT_NAME_PROPERTY type is WebServiceConnection |
|
WsdlUrl |
The URL for the WSDL. |
http://example.com:port/MyWebService1?WSDL
|
Oracle Web Services |
OBJECT_NAME_PROPERTY type is Port |
|
AddressUrl |
The service endpoint URL. |
http://example.com:port/MyWebService1
|
ProxyHost |
The name of the host on which the proxy server is running. |
example.com |
ProxyPort |
The port number to which the proxy server is listening. |
80 |
Table A-15 describes the move plan properties that you can change for Oracle Coherence. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
Table A-15 Move Plan Properties for Oracle Coherence
Property | Description | Example |
---|---|---|
Properties in the COHERENCE_SERVER_CONFIG configGroup |
The configuration of Oracle Coherence servers. |
|
Unicast Listen Address |
The unicast listen address. This property is not present in the move plan if the value is localhost or a loopback address or the value is empty. |
10.240.98.232 |
Unicast Listen Port |
The unicast listen port. |
7036 |
Properties in the COHERENCE_CLUSTER_CONFIG configGroup |
The configuration of Oracle Coherence clusters. |
|
Custom Cluster Configuration File |
An external custom configuration file used to configure this cluster. |
/scratch/external_custome_config.xml |
Unicast Listen Address |
The unicast listen address. If the clustering mode is unicast, the properties Unicast Listen Address and Unicast Listen Port are present in the move plan. However, This property is not present in the move plan if the value of Unicast Listen Address is localhost or a loopback address or the value is empty. |
10.240.98.232 |
Unicast Listen Port |
The unicast listen port. This property is present in the move plan if the clustering mode is unicast. |
7036 |
Multicast Listen Address |
The multicast listen address. If the clustering mode is not unicast, this property is present in the move plan. |
224.12.1.0 |
Multicast Listen Port |
The multicast listen address. This property is present in the move plan if the clustering mode is not unicast. |
12100 |
Listen Address |
The listen address for the Well Known Address Name configuration property. |
|
Listen Port |
The listen port for the Well Known Address Name configuration property |
|
Properties in the SERVER_TEMPLATES_CONFIG configGroup: |
Server templates configuration properties. These properties are visible in the move plan if the Coherence cluster configuration is overridden in server templates. |
|
Unicast Listen Address |
The unicast listen address. |
10.240.98.232 |
Unicast Listen Port |
The unicast listen port. |
7036 |
Table A-16 describes the move plan properties that you can change for Oracle User Messaging Service. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
Table A-16 Move Plan Properties for Oracle User Messaging Service
Property | Description | Sample Value |
---|---|---|
Properties for the componentType UMS: |
These properties apply to all driver types. |
|
DefaultSenderAddress |
The default address of the sender. |
SMS:1234 |
SenderAddresses |
The list of sender addresses that the driver supports. |
SMS:1234 |
Properties in the EmailDriver componentType: |
These properties apply to email drivers. |
|
IncomingMailServer |
The host name of the incoming mail server. |
usmdemo.example.com |
IncomingMailServerPort |
Port number of IMAP4 (that is, 143 or 993) or POP3 (that is, 110 or 995) server. |
110 |
IncomingUserIDs |
The list of user names of the mail accounts from which the driver instance is polling. Each name must be separated by a comma, for example, user1,user2. |
username.pop3@umsdemo.example.com
|
IncomingMailIDs |
The email addresses corresponding to the user names. Each email address is separated by a comma and must reside in the same position in the list as its corresponding user name appears on the usernames list. |
username.pop3@umsdemo.example.com
|
IncomingUserPasswords |
The absolute path of a secure file containing the password. You must provide a password file, even if you are not changing the configuration. The file contains a list of passwords corresponding to the user names. Each password is separated by a comma and must reside in the same position in the list as their corresponding user name appears on the usernames list. |
/scratch/oracle/ums_in_passwd.txt |
OutgoingMailServer |
The name of the SMTP server. |
usmdemo.example.com |
OutgoingMailServerPort |
The port number of the SMTP server. |
25 |
OutgoingDefaultFromAddr |
The default FROM address (if one is not provided in the outgoing message). |
username.pop3@umsdemo.example.com
|
OutgoingUsername |
The user name used for SMTP authentication. |
username.pop3@umsdemo.example.com
|
OutgoingPassword |
The absolute path of a secure file containing the password used for SMTP authentication. This is required only if SMTP authentication is supported by the SMTP server. You must provide a password file, even if you are not changing the configuration. The file includes the type of password (choose from Indirect Password/Create New User, Indirect Password/Use Existing User, and Use Cleartext Password) and Password. |
/scratch/oracle/ums_out_passwd.txt |
Properties in the ExtensionEndpoint configGroup: |
These properties apply to extension drivers. |
|
EndpointURL |
Remote endpoint listener URL |
http://hostname:7001/integrationtest-war/extension |
mappedDomain |
The extension endpoint used to deliver messages where the domain part of the recipient URI matches this value. |
test |
Properties in the SMPPDriver componentType: |
These properties apply to SMPP drivers. |
|
SmsAccountId |
The Account Identifier on the SMS-C. |
myusername |
SmsServerHost |
The name (or IP address) of the SMS-C server. |
example_host |
TransmitterSystemId |
The account ID that is used to send messages. |
myusername |
ReceiverSystemId |
The account ID that is used to receive messages. |
myusername |
TransmitterSystemType |
The type of transmitter system. |
Logica |
ReceiverSystemType |
The type of receiver system. |
Logica |
ServerTransmitterPort |
The TCP port number of the transmitter server. |
9001 |
ServerReceiverPort |
The TCP port number of the receiver server. |
9001 |
TransmitterSystemPassword |
The absolute path of a secure file containing the password of the transmitter system You must provide a password file, even if you are not changing the configuration. The file contains the type of password (choose from Indirect Password/Create New User, Indirect Password/Use Existing User, and Use Cleartext Password) and Password. |
/scratch/oracle/ums_trans_passwd.txt |
ReceiverSystemPassword |
The absolute path of a secure file containing the password of the receiver system You must provide a password file, even if you are not changing the configuration. The file contains the type of password (choose from Indirect Password/Create New User, Indirect Password/Use Existing User, and Use Cleartext Password) and Password. |
/scratch/oracle/ums_rec_passwd.txt |
Property in the WorklistDriver componentType: |
This property applies to the Worklist drivers. |
|
BPELConnectionURL |
The URL of the BPEL server to connect to. The format is 'http://bpel-host:bpel-port'. The default behavior, if this property is not set, is to use the local container's HTTP connection URL. |
http://host.example.com:port
|
Properties in the XMPPDriver componentType: |
These properties apply to XMPP drivers. |
|
IMServerHost |
The Jabber/XMPP server host name. |
example.domain.com |
IMServerPort |
The corresponding Jabber/XMPP server port. The default is 5222. |
5222 |
IMServerUsername |
The Jabber/XMPP user name with which you log in. You may also enter a complete Jabber ID if its domain name is different from the Jabber/XMPP server host name. |
myUserName@xmpp-domain
|
IMServerPassword |
The absolute path of a secure file containing the corresponding password for the IMServerUsername. You must provide a password file, even if you are not changing the configuration. The file contains the type of password (choose from Indirect Password/Create New User, Indirect Password/Use Existing User, Use Cleartext Password) and Password. |
/scratch/oracle/ums_im_passwd.txt |
Table A-17 describes the move plan properties that you can change for Oracle HTTP Server. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
For Oracle HTTP Server, there are many configGroup elements in the move plan. Each configGroup element is associated with one Oracle HTTP Server configuration file. As a result, there may be more than one instance of a particular property, such as User.
Table A-17 Move Plan Properties for Oracle HTTP Server
Property | Description | Sample Value |
---|---|---|
Listen |
The Listen address. It can include the host name and port or just the port. |
orcl3.example.com:8888 or 8888 |
User |
The Oracle HTTP Server administration user. |
admin_user
|
Group |
The group for the user. |
admin_group1
|
ServerAdmin |
The administrator's email address. |
Webmaster@example.com |
ServerName |
The name of the server for Oracle HTTP Server. If the host does not have a registered DNS name, use the IP address. |
orcl1.example.com |
WebLogicHost |
The name of the host on which Oracle WebLogic Server is listening for requests. |
orcl2.example.com |
WebLogicPort |
The port number that Oracle WebLogic Server uses to listen for requests. |
9002 |
WebLogicCluster |
The name of the host on which an Oracle WebLogic Server cluster is running and its port number. |
orcl3.example.com:9003 |
VirtualHost |
The name of the virtual host. The port number listed should also be listed in the Listen directive. |
*.8888 |
PlsqlDatabasePassword |
Specific to the PLSQL module, the name of a secure file containing the password. You must provide a password file, even if you are not changing the configuration. |
/scratch/orcl/plsql_passwd.txt |
PlsqlDatabaseConnectString |
Specific to the PLSQL module, the service name of the database. |
orcl.example.com:1521:orcl1 |
PlsqlNLSLanguage |
Specific to the PLSQL module, the NLS_LANG variable for the database access descriptor (DAD). |
America_America.UTF8 |
ORAConnectSN |
Specific to the oradav module, the Oracle database to which to connect. |
db_host:db_port:db_service_name
|
ORAUser |
Specific to the oradav module, the database user (schema) to use when connecting to the service specified by the ORAConnectSN property. |
db6175_PORTAL |
ORACRYPTPASSWORD |
Specific to the oradav module, the absolute path to the secure file containing the password for oradav. You must provide a password file, even if you are not changing the configuration. |
/scratch/oracle/dav_passwd.txt |
SSLWallet |
The location of the SSL wallet, if the wallet is not in the default location. |
/scratch/oracle/base_domain/config/fmwconfig/components/OHS/ohs_1/keystores/mywallets |
DocumentRoot |
The directory that stores the main content for the Web site. |
/scratch/oracle/base_domain/config/fmwconfig/components/OHS/instances/ohs_1/htdocs |
Alias |
The location of the alias, if it is not in the default location. Note that you change the value within the double quotation marks. |
/icons/"/scratch/orcl/icons/" |
ScriptAlias |
The location of the script alias, if it is not in the default location. Note that you change the value within the double quotation marks. |
/cgi-bin/"/scratch/oraclcgi-bin/" |
WebGateInstalldir |
The location of the WebGate installation directory, as specified in the webgate.conf file. |
/scratch/oracle/oh_home/Oracle_OAMWebGate1/webgate/ohs |
primaryOAMServerHost |
The primary Oracle Access Manager server host. Note that the configuration for the secondary Oracle Access Manager server host is updated automatically the first time that WebGate communicates with the primary server. |
primary_oam_server_host.example.com
|
primaryOAMServerPort |
The port number for the Oracle Access Manager primary host. |
5575 |
Table A-18 describes the move plan properties that you can change for Oracle Web Services Manager. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment. Do not edit the value of the configProperty id.
Table A-18 Move Plan Properties for Oracle Web Services Manager
Property | Description | Sample Value |
---|---|---|
Properties in the bootstrap.configmanager componentType |
The bootstrap properties used by the Oracle Web Services Manager agent to connect to the Oracle Web Services Manager Policy Manager. |
|
pm.url |
The URL of the policy manager. If you are using the same policy manager in the target environment as in the source environment, you do not need to modify this property. |
t3://example.com:7003 |
keystore.path |
The keystore path. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
/scratch/oracle/domains/domain_name/config/fmwconfig/default-keystore.jks
|
truststore.path |
The truststore path. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
/scratch/oracle/domains/domain_name/config/fmwconfig/default-keystore.jks
|
Properties in the wsm.respository componentType |
The Oracle Web Services Manager repository configuration in the move plan if the Policy Manager is installed in the domain. However, if you set the -mdsDataExport parameter of the copyConfig script to false, this component type will not be present in the move plan. This component will not be present if wsm-pm is not installed in the domain. |
|
Properties in the configurations configGroup |
The domain configuration. This configGroup is present in the move plan if applications or domains are registered in the source environment or domain configuration documents are created on the source environment. There is one configGroup per domain. |
|
domain |
The domain name of the context for which a configuration document is created in the repository. This property is present in the move plan when you have made changes to the default configuration for a particular context. If you do not modify this property, the configurations properties will have same context as on source environment. |
domain1 |
KerberosLoginModule:principal |
The name of the principal to be used. |
HOST/localhost@example.com |
KerberosLoginModule:key.tab |
The path to the keytab to get the secret key for the principal. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
./mylocation/krb5.keytab |
ConfigManager:pm.url |
The URL that specifies the location of the policy accessor. |
t3://host.example.com:7003 |
ConfigManager:keystore.path |
The path to the keystore. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
./mylocation/mykeystore.jks |
ConfigManager:truststore.path |
The truststore path relative to the domain configuration directory. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
/mylocation/mykeystore.jks |
KeystoreConfig:location |
The location of the keystore used for message protection. This can be an absolute path or a path relative to the DOMAIN_HOME/config/fmwconfig directory. |
mycustomlocation/key.tab |
Properties in the policysets configGroup |
The configuration of policy sets. This configGroup is present in the move plan if policy sets have been created in the source environment. |
|
attach To |
The scope of the policy sets. If the attachTo expression scope is DOMAIN or DOMAIN term, this property is present in the move plan. However, an exception is if it is |
domain1 |
Properties in the policies configGroup |
The configuration of policies. This configGroup is present in the move plan if policies with assertions have been modified in the source environment.There can be multiple configGroups, one for each policy. The ID attribute is the name of the policy for which configGroup is created. |
|
wsdl-uri |
The actual endpoint URI of the WSDL. |
http://host:port/sts?wsdl
|
port-uri |
The actual endpoint URI of the STS port. |
http://host:port/sts-service |
sts.auth.service.principal.name |
The name of the principal that should be used by the service. |
HOST/localhost@EXAMPLE.COM |
sts.auth.keytab.location |
The location of the client's keytab file. This property is present when Security Token Service (STS) is configured with Kerberos tokens. |
mycustomlocation/key.tab |
sts.auth.caller.principal.name |
Client's principal name. |
testuser |
service.principal.name |
The name of the principal that should be used by the service. |
HOST/localhost@EXAMPLE.COM |
caller.principal.name |
Client's principal name. |
testuser |
keytab.location |
The location of the client's keytab file. |
mycustomlocation/key.tab |
Table A-19 describes the move plan properties that you can change for Oracle Data Integrator. Edit all properties, such as host names, port numbers, listen addresses, that have different values in the target environment.
Table A-19 Move Plan Properties for Oracle Data Integrator
Property | Description | Sample Value |
---|---|---|
Properties in the Master Repository configGroup: |
Master repository configuration |
|
Url |
JDBC URL for connecting to the master repository. |
jdbc:oracle:thin:@localhost:1522:orcl |
Schema name |
The name of the schema in the target database where the target ODI repository will be created. |
odi_master_12c |
Schema password file |
The absolute path of a secure file that contains the password for the schema. |
/scratch/oracle/odi_schema_passwd.txt |
SUPERVISOR user |
The name of the ODI user SUPERVISOR. |
SUPERVISOR |
SUPERVISOR password file |
The absolute path of a secure file that contains the password for the ODI user SUPERVISOR. |
/scratch/oracle/odi_passwd.txt |
Properties in the Physical Data Servers configProperty: |
Data servers configuration |
|
Schema name |
The name of the schema for the database data servers or the directory location for file type data servers. |
FG_Dir_Schema |
Work Schema |
The name of the Work schema for the database data servers or the directory location for file type data servers. |
/tmp/FG_Dir_Schema |
Url |
JDBC URL for connecting to the data server. |
jdbc:oracle:thin:@localhost:1521/example.com |
User |
User name for the physical data servers connection. |
username |
Password File |
The absolute path of a secure file that contains the password for the user for the physical data servers connection. |
/scratch/oracle/rpd_ds_conn_passwd.txt |
Properties in the Agents configProperty: |
Agents configuration |
|
Host name |
The Agent host name. |
localhost |
Host port |
The Agent host port number. |
12311 |
Properties in the Work Repositories configProperty: |
Work repositories configuration |
|
Url |
JDBC URL for connecting to the work repository. |
jdbc:oracle:thin:@localhost:1521/example.com |
User |
User name for connecting to the work repository. |
username |
Password File |
The absolute path of a secure file that contains the password for the user for the physical data servers connection. |
/scratch/oracle/odi_pds_passwd.txt |