20 Using the Movement Scripts

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 a Middleware home and the Oracle homes and Oracle WebLogic Server domains, as well as certain Oracle Fusion Middleware components, such as Oracle SOA Suite, Oracle HTTP Server, Oracle Internet Directory and Oracle Virtual Directory. This chapter explains the scripts you can use to move these entities.

This chapter includes the following topics:

See:

Chapter 21, "Moving from a Test to a Production Environment" for detailed instructions about using these scripts to move Oracle Fusion Middleware from one environment to another.

20.1 Introduction to the Movement Scripts

The movement scripts minimize the amount of work that would otherwise be required to reapply all the customization and configuration changes made in one environment to another. You can use these scripts to:

  • Create a Middleware home that is a copy of a production, test, or development environment. The scripts create a new Middleware home with all patches applied to all of the Oracle homes and the WebLogic Server home in a single step. This is in contrast to separately installing and applying any patches to the WebLogic Server home and separate Oracle homes.

  • Preparing a "gold" image of a patched Middleware home and deploying it to many hosts.

  • Move the Middleware home, WebLogic Server home, Oracle homes, as well as the components from one environment to another.

You can move the following, to the same host or a different host. The source and target environments must share the same operating system and the same platform architecture (in terms of number of bits).

  • Middleware home: You can copy the Middleware home, the Oracle WebLogic Server home, and all of the Oracle homes within the Middleware home. (You can copy a Middleware home that contains no Oracle homes, but you need to have the cloningclient.jar file and movement scripts that are compatible with the version of the Middleware home you want to copy.)

    You can apply the copy of the Middleware home to the same host or a different host.

  • Java components: You can copy the configuration of a domain containing Java components, such as Oracle SOA Suite and Oracle Business Activity Monitoring to the same or a different Middleware home, on the same host or a different host.

  • System components: You can copy the configuration of a domain containing system components, such as Oracle HTTP Server and Oracle Internet Directory, to the same or a different Oracle instance, to the same or a different Middleware home, on the same host or a different host.

See Also:

Chapter 21 for information about moving from a test environment to a production environment

20.2 Understanding the Movement Process

When you move an entity of Oracle Fusion Middleware, the scripts take a snapshot of the information required for the movement. The following topics describe the movement process:

20.2.1 Understanding the Movement of a Middleware Home

When you move a Middleware home, you create an archive of the source Middleware home and use the archive to create the copy of the Middleware home:

  1. At the source, you run the copyBinary script, specifying the Middleware home that you want to copy. The script prepares the source and creates an archive. It also records the file permissions of the Middleware home and the Oracle homes within the Middleware home.

    The archive contains the Oracle WebLogic Server home and all of the Oracle homes in the Middleware home.

  2. At the destination, you run the pasteBinary script, specifying a destination for the Middleware home. The script checks to see that the prerequisites are met at the destination. It extracts the files from the archive file, registers the Oracle homes with the Oracle inventory and registers the WebLogic Server home with the Middleware home.

    The script then restores the file permissions and relinks any files if that is necessary.

Note the following:

  • The copyBinary and pasteBinary scripts do not carry over all the dependencies of the source Middleware home, WebLogic Server home, and Oracle homes, such as loadable modules or application-specific libraries to the target home, because the scripts proceed by copying the Middleware home and the entire source WebLogic Server home and Oracle homes to the destination Middleware home. Any files outside the source WebLogic Server or Oracle home are not automatically copied. Hence, any applications that refer to files outside the source WebLogic Server or Oracle home may not work properly in the target home.

    The Oracle home that is copied as a part of the Middleware home contains only the binary files.

  • When you copy a Middleware home, only the read-only portions of the Middleware home are copied. Any user configuration files, such a the user_projects directory, are excluded from the archive. The WebLogic Server domain is not copied. (Use the copyBinary and pasteBinary scripts to copy the domain.)

  • You cannot move a Middleware Home if its path is a symbolic link.

See Section 21.3.3 for detailed information about these steps.

20.2.2 Understanding the Movement of Components

When you move Oracle Fusion Middleware components, you create an archive of the source component's configuration and use the archive to create the component at the target. You use the following:

  • For Java components, such as Oracle SOA Suite, you use the copyConfig, extractMovePlan, and pasteConfig scripts to copy the configuration, including the domain, the Administration Server, and the Managed Servers.

  • For Node Manager, you use the copyConfig, extractMovePlan, and pasteConfig scripts to copy the configuration.

  • For some system components, such as Oracle HTTP Server, you use the copyConfig, extractMovePlan, and pasteConfig scripts to copy the configuration, including the Oracle instance.

Note:

The scripts replicate the topology of the source. For example, if the source domain contains Managed Servers server_1 and server_2 on Host A and Managed Servers server_3 and server_4 on Host B, you must specify a similar relationship between Managed Servers and hosts at the target. (You specify the hosts for each Managed Server in the move plan.)

To move components, you take the following general steps:

  1. You move the Middleware home, as described in Section 20.2.1.

  2. At the source, make sure that the Administration Server and all Managed Servers are started.

  3. At the source, you run the copyConfig script, specifying the source component that you want to copy. The script creates a configuration archive file that contains a snapshot of the configuration of an Oracle WebLogic Server domain or system component instance.

  4. You extract a move plan from the source using the extractMovePlan script. A move plan contains configuration settings of the source environment. You can edit the move plan, specifying properties for the target environment.

  5. At the target, you run the pasteConfig script, specifying the destination for the component and the move plan. The script checks to see that the prerequisites are met at the target. It extracts the files from the archive file and uses the information in the move plan to modify the configuration on the target. Then, it restores the file permissions.

    In addition, the pasteConfig scripts starts the Administration Server.

Note that you must ensure that components, such as Oracle WebLogic Server and Oracle Coherence, are installed in the directory structure of the source Middleware home.

See Section 21.3.4 and Section 21.3.5 for detailed information about these steps.

20.3 Movement Scripts

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

You use the following scripts to move a Middleware home or component:

  • To copy the binary files of the source Middleware home:

    (UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh
    (Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd
    

    See Section 20.3.1.1 for the syntax of the script.

  • To apply the copied Middleware home to the target:

    (UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
    (Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd
    

    See Section 20.3.1.2 for the syntax of the script.

  • To copy the source component configuration:

    (UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
    (Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd
    

    See Section 20.3.1.3, Section 20.3.1.4, Section 20.3.1.5 for the syntax of the script.

  • To extract a move plan from the source component:

    (UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
    (Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd
    

    See Section 20.3.1.6 for the syntax of the script.

  • To apply the copied component configuration to the target:

    (UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
    (Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd
    

    See Section 20.3.1.7, Section 20.3.1.8, and Section 20.3.1.9 for the syntax of the script.

To view the help on any of these scripts, use the -help option. For example:

./pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jdk160_21 -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.

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:

If you are applying the archive of a Middleware home on a host that does not yet have Oracle Fusion Middleware installed, note the following:
  • The host must have JDK 1.6.04 or higher installed. In addition, ensure that the PATH, CLASSPATH, and JAVA_HOME environment variables point to the JDK.

  • Copy the pasteBinary script from the following location in the source host to the target host:

    (UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
    (Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd
    
  • Copy the following file from the following location in the source host to the target host:

    (UNIX) ORACLE_COMMON_HOME/jlib/cloningclient.jar
    (Windows) ORACLE_COMMON_HOME\jlib\cloningclient.jar
    
  • If you run the pasteBinary script from a different location than ORACLE_COMMON_HOME/bin, then the pasteBinary script and the cloningclient.jar file must be in the same directory.

    If you are running pasteBinary on a host that has no prior Oracle Fusion Middleware installations, ORACLE_COMMON_home/bin will not exist prior to running pasteBinary, and therefore the pasteBinary script and cloningclient.jar must be in the same directory.

  • Ensure that the files have execute permission.

20.3.1 Movement Scripts Syntax

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 do not specify the -silent true option. To continue, you must type yes, which is not case sensitive. Any words other than yes causes the script to return an error. 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 the following sections.

  • The value of options must not contain a space. For example, on Windows, you cannot pass the following as a value to the -javaHome option:

    C:\Program Files\jdk
    
  • The value of the javaHome option must use the JAVA HOME that is defined in the following file (note the period (.) before the filename):

    MW_HOME/wlserver_n/.product.properties
    

20.3.1.1 copyBinary Script

Creates an archive file of the source Middleware home, by copying the binary files of that Middleware home, including all of its Oracle homes and its WebLogic Server home, into the archive file. The syntax is:

copyBinary -javaHome path_of_jdk
           -archiveLoc archive_location 
           -sourceMWHomeLoc MW_HOME   
            [-invPtrLoc Oracle_InventoryLocation]
            [-logDirLoc log_dir_path]
            [-silent {true | false}]
            [-ignoreDiskWarning {true | false}]

The following example shows how to create an archive of a Middleware home on Linux:

copyBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18 
              -archiveLoc /tmp/mw_copy.jar
              -sourceMWHomeLoc /scratch/Oracle/Middleware1 
              -invPtrLoc /scratch/oracle/oraInst.loc

Note:

Before you execute the copyBinary script, ensure that all Oracle homes in the Middleware home are either 32 bit or 64 bit. The operation does not support a mix of 32-bit and 64-bit Oracle homes.

When you execute the command, 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 20-1 describes the options for the copyBinary script.

Table 20-1 Options for the copyBinary Script

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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, but its parent directory must exist and have write permission.

Ensure that the archive location is not within the Middleware home structure.

Mandatory

-sourceMWHomeLoc

-smw

The absolute path of the Middleware home to be archived. You can only specify one Middleware home.

Mandatory

-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 read the Oracle homes present in the inventory.

You must have write permission to the inventory location.

On UNIX and Linux, the default location is /etc/oraInst.loc.

On Windows, if you specify this parameter, the script ignores it.

In previous releases, the shortcut was -invLoc, but that shortcut is now deprecated.

Optional, if the inventory is in the default location. Otherwise, it is mandatory on Linux.

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

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


20.3.1.2 pasteBinary Script

Applies the archive to the target destination, by pasting the binary files of the source Middleware home to the target environment. You can apply the archive to the same host or a different host. The syntax is:

pasteBinary -javaHome path_of_jdk
            -archiveLoc archive_location
            -targetMWHomeLoc target_MW_Home_location
            [-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/MW_Home_prod, on Linux:

pasteBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
               -archiveLoc  /tmp/mw_copy.jar 
               -targetMWHomeLoc /scratch/oracle/MW_Home_prod 

Table 20-2 describes the options for the pasteBinary script.

Table 20-2 Options for the pasteBinary Script

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the source Middleware home was installed with the JDK and Oracle JRockit outside of the Middleware home, the path you specify is used to configure the Middleware home.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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.

In previous releases, this option was named archiveLocation, but that name is now deprecated.

Mandatory

-targetMWHomeLoc

-tmw

The absolute path of the target Middleware home.

Ensure that the Middleware home directory does not exist at that location. If it does exist, the script returns an error message.

The targetMWHomeLoc cannot be inside another Middleware home.

In previous releases, this option was named targetLocation, but that name is now deprecated. In previous releases, the shortcut was -tl, but that shortcut is now deprecated.

Mandatory

-executeSysPrereqs

-esp

Specifies whether the pasteBinary operation checks the prerequisites of the Oracle homes. The default is that it checks the prerequisites. To specify that it does not check the prerequisites, specify this option with the value false.

In previous releases, the shortcut was -exsysprereqs, but that shortcut is now deprecated.

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 read the Oracle homes present in the inventory.

You must have write permission to the inventory location.

On UNIX and Linux, the default location is /etc/oraInst.loc.

On Windows, if you specify this parameter, the script ignores it.

In previous releases, the shortcut was -invLoc, but that shortcut is now deprecated.

Optional, if the inventory is in the default location. Otherwise, it is mandatory on Linux.

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

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


20.3.1.3 copyConfig Script for Java Components

Creates a configuration archive that contains the snapshot of the configuration of an Oracle WebLogic Server domain. The underlying components of an Oracle WebLogic Server domain persist their configuration information in different data stores, such as a file system, Oracle Metadata Service (MDS), LDAP, or a database.

You must run the copyConfig script for each Oracle 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 syntax is:

copyConfig  -javaHome path_of_jdk
            -archiveLoc archive_location 
            -sourceDomainLoc domain_location
            -sourceMWHomeLoc Middleware_home_location
            -domainHostName domain_host_name
            -domainPortNum  domain_port_number 
            -domainAdminUserName domain_admin_username
            -domainAdminPassword domain_admin_password_file 
            [-mdsDataImport {true | false}]
            [-logDirLoc log_dir_path]
            [-silent {true | false}]

The following example copies the configuration of a domain containing Java components:

copyConfig.sh -javaHome /scratch/jrockit_160_20_D1.1.0-18 
               -archiveLoc /tmp/a.jar
               -sourceDomainLoc /scratch/mw_home1/user_projects/domains/WLS_SOAWC 
               -sourceMWHomeLoc /scratch/work/mw_home1/
               -domainHostName myhost.example.com 
               -domainPortNum 7001
               -domainAdminUserName weblogic 
               -domainAdminPassword /home/oracle/p.txt 
               -silent true

Table 20-3 describes the options for the copyConfig script for Java components.

Table 20-3 Options for the copyConfig Script for Java Components

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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.

Mandatory

-sourceMWHomeLoc

-smw

The absolute path of the source Middleware 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.

In previous releases, this option was named domainPortNo, but that name is now deprecated. In previous releases, the shortcut was -domainport, but that shortcut is now deprecated.

Mandatory

-domainAdminUserName

-dau

The name of the administrative user for the domain.

In previous releases, the shortcut was -domainuser, but that shortcut is now deprecated.

Mandatory

-domainAdminPassword

-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.

In previous releases, the shortcut was -domainpass, but that shortcut is now deprecated.

Mandatory

-mdsDataImport

-mdi

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

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional


20.3.1.4 copyConfig Script for System Components

Creates a configuration archive that contains the snapshot of the configuration of an Oracle instance. The underlying system components, such as Oracle HTTP Server or Oracle Internet Directory, persist their configuration information in different data stores, such as a file system, Oracle Metadata Service (MDS), LDAP, or a database.

The copyConfig script supports moving the following system components:

  • Oracle HTTP Server

  • Oracle Internet Directory

  • Oracle Virtual Directory

You must run the copyConfig script for each Oracle instance in the source environment. A configuration archive is created for each Oracle instance.

The Administration Server and all Managed Servers in the domain must be started when you run the script.

The syntax is:

copyConfig  -javaHome path_of_jdk
            -archiveLoc archive_location 
            -sourceInstanceHomeLoc src_instance_path
            -sourceComponentName src_component_name
            [-logDirLoc log_dir_path]
            [-silent {true | false}]

The following example shows how to create an archive of the Oracle Virtual Directory instance named ovd1 in the Oracle instance located in /scratch/Oracle/Middleware/im_1 on Linux:

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
               -archiveLoc /tmp/ovd1.jar
               -sourceInstanceHomeLoc /scratch/Oracle/Middleware1/im_1
               -sourceComponentName ovd1

Table 20-4 describes the options for the copyConfig script for system components.

Table 20-4 Options for the copyConfig Script for System Components

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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.

In previous releases, this option was named archiveLocation, but that name is now deprecated.

Mandatory

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional

-sourceComponentName

-scn

The name of the component to be copied. For example, if your Oracle Internet Directory component is named oid1, specify oid1.

Mandatory

-sourceInstanceHomeLoc

-sih

The absolute path of the Oracle instance for the source component.

Mandatory


20.3.1.5 copyConfig Script for Node Manager

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 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/Middleware/wlserver_10.3/common/nodemanager:

copyConfig.sh -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
              -archiveLoc /tmp/nm.jar
              -sourceNMHomeLoc /scratch/Oracle/Middleware/wlserver_10.3/common/nodemanager
              -silent true

Table 20-5 describes the options for the copyConfig script for Node Manager.

Table 20-5 Options for the copyConfig Script for Node Manager

Options Shortcut Description Mandatory or Optional

-javaHome

None

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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

-sourceNMHomeLoc

-snh

The absolute path of the source Node Manager home.

Mandatory

-logDirLoc

-ldl

The location of an existing directory. A new log file is created in the directory. The default is the system Temp location.

Optional

-silent

None

Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional


20.3.1.6 extractMovePlan Script

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 syntax is:

extractMovePlan -javaHome path_of_jdk
                -archiveLoc archive_location
                -planDirLoc move_plan_directory
               [-logDirLoc log_dir_path]

The following example extracts the plans from the archive j2ee.jar:

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
                  -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 Java components, such as Oracle SOA Suite, it may extract the following:

/scratch/Oracle/t2p_plans/moveplan.xml
/scratch/Oracle/t2p_plans/composites
/scratch/Oracle/t2p_plans/composites/configplan1.xml
/scratch/Oracle/t2p_plans/composites/configplan2.xml
/scratch/Oracle/t2p_plans/adapters
/scratch/Oracle/t2p_plans/adapters/deploymentplan1.xml
/scratch/Oracle/t2p_plans/adapters/deploymentplan2.xml

For system components, such as Oracle Internet Directory and Oracle Virtual Directory, it may extract the following:

/scratch/Oracle/t2p_plans/moveplan.xml

Table 20-6 describes the options for the extractMovePlan script:

Table 20-6 Options for the extractMovePlan Script

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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.

Mandatory

-logDirLoc

-ldl

The location of an existing directory. 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 20.4.

20.3.1.7 pasteConfig Script for Java Components

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 Oracle WebLogic Server domain and the modified move plan. The pasteConfig script recreates 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 syntax is:

pasteConfig  -javaHome path_of_jdk 
             -archiveLoc archive_location
             -targetDomainLoc trgt_domain_path 
             -targetMWHomeLoc trgt_Middleware_Home_path
             -movePlanLoc move_plan_path 
             -domainAdminPassword 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 Middleware home MW_home1:

pasteConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
            -archiveLoc /tmp/java_ee_cl.jar
            -targetDomainLoc /scratch/oracle/MW_home1/user/projects/domains/dom_cl
            -targetMWHomeLoc /scratch/oracle/MW_home1 
            -movePlanLoc /scratch/oracle/java_ee/move_plan.xml
            -domainAdminPassword /scratch/pwd_dir/pass.txt 
            -logDirLoc /tmp/log

Table 20-8 describes the options for the pasteConfig script for Java components.

Table 20-7 Options for the pasteConfig Script for Java Components

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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 domain location must not exist for the specified Middleware home.

The domain directory may be located outside of the directory structure of the Middleware home.

Mandatory

-targetMWHomeLoc

-tmw

The absolute path of the target Middleware home in which the domain is to be copied.

Mandatory

-movePlanLoc

-mpl

The absolute path of the move plan extracted from the source.

Mandatory

-domainAdminPassword

-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.

In previous releases, the shortcut was -domainpass, but that shortcut is now deprecated.

Mandatory.

-appDir

-ad

The absolute path of the Oracle WebLogic Server application directory on the target.

Optional

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional


20.3.1.8 pasteConfig Script for System Components

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 Oracle instance and the modified move plan. The pasteConfig script iterates and recreates the configuration information for the Oracle instance in the target environment. It also merges the move plan property values for the target environment.

The copyConfig script supports moving the following system components:

  • Oracle HTTP Server

  • Oracle Internet Directory

  • Oracle Virtual Directory

The syntax is:

pasteConfig  -javaHome path_of_jdk 
             -archiveLoc archive_location
             -movePlanLoc move_plan_path 
             -targetComponentName trgt_component_name 
             -targetInstanceHomeLoc trgt_Instance_path 
             [-targetInstanceName trgt_Instance_name] 
             [-targetOracleHomeLoc trgt_ORACLE_HOME_path] 
             [-logDirLoc log_dir_path]
             [-silent {true | false}]
             [ <Domain Detail> ]

<Domain Detail> =
         -domainHostName domain_host_name
         -domainPortNum  domain_port_number 
         -domainAdminUserName domain_admin_username
         -domainAdminPassword domain_admin_password_file 

The following example shows how to apply the archive to the Oracle instance im_2 and to name the target Oracle Virtual Directory instance ovd_cl:

pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jrockit_160_20_D1.1.0-18
            -archiveLoc /tmp/ovd1.jar
            -movePlanLoc /scratch/oracle/ovd/move_plan.xml
            -targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_IM2 
            -targetInstanceHomeLoc /scratch/Oracle/Middleware/im_2 
            -targetInstanceName im_2 
            -targetComponentName ovd_cl 
            -domainHostName myhost 
            -domainPortNum 7001
            -domainAdminUserName domain_admin_username
            -domainAdminPassword domain_admin_password_file 

Table 20-8 describes the options for the pasteConfig script for system components.

Table 20-8 Options for the pasteConfig Script for System Components

Options Shortcut Description Mandatory or Optional

-javaHome

NA

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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.

In previous releases, this option was named archiveLocation, but that name is now deprecated.

Mandatory

-movePlanLoc

-mpl

The absolute path of the move plan extracted from the source.

Mandatory

-targetComponentName

-tcn

The name of the target component to be copied. The name must be unique in the instance.

Mandatory

-targetInstanceHomeLoc

-tih

The absolute path of the target Oracle instance.

If the Oracle instance directory does not exist at that location, the script creates the directory.

Mandatory

-targetInstanceName

-tin

The name of the target Oracle instance.

The name must be unique in the domain.

Optional, if the targetInstanceHomeLoc directory exists. In this case, the operation retrieves the name from the configuration.

-targetOracleHomeLoc

-toh

The absolute path of the target Oracle home.

The target Oracle home must exist and it must contain the binaries for the component you are copying.

Optional, if the targetInstanceHomeLoc exists. In this case, the operation retrieves the value from the configuration.

-logDirLoc

-ldl

The location of an existing directory. 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 prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional

Domain-Detail Options

     

-domainHostName

-dhn

The name of the host on which the domain is configured.

Use this option if you want to register the component with the domain.

In previous releases, the shortcut was -domainhost, but that shortcut is now deprecated.

Optional, if you do not want to register the component with the domain.

-domainPortNum

-dpn

The port number of the domain.

Use this option if you want to register the component with the domain.

The domain port number is listed in the following file as the adminPort:

ORACLE_INSTANCE/config/OPMN/opmn/instance.properties

For example: adminPort=7001

In previous releases, this option was named domainPortNo, but that name is now deprecated. In previous releases, the shortcut was -domainport, but that shortcut is now deprecated.

Optional, if you do not want to register the component with the domain.

-domainAdminUserName

-dau

The name of the administrative user for the domain.

Use this option if you want to register the component with the domain.

In previous releases, the shortcut was -domainuser, but that shortcut is now deprecated.

Optional, if you do not want to register the component with the domain.

-domainAdminPassword

-dap

The absolute path of a secure file containing the password for the administrative user for the domain. You must provide a password file, even if you are not changing the configuration.

Use this option if you want to register the component with the domain.

In previous releases, the shortcut was -domainpass, but that shortcut is now deprecated.

Optional, if you do not want to register the component with the domain.


20.3.1.9 pasteConfig Script for Node Manager

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 Manger and the modified move plan. The pasteConfig script recreates 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.

Even if the source Node Manager connection between the Administration Server and Node Manager is configured with SSL, they will both change to plain socket connection type after the copy of Node Manager is applied to the target environment.

You must run the pasteConfig script for each Node Manager in the source environment.

The syntax is:

pasteConfig  -javaHome path_of_jdk 
             -archiveLoc archive_location
             -targetNMHomeLoc trgt_Node_Manager_Home_path 
             -targetMWHomeLoc trgt_Middleware_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 Node Manager home located in /scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanager:

pasteConfig -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
            -archiveLoc /tmp/nm.jar
            -targetNMHomeLoc /scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanager
            -targetMWHomeLoc /scratch/Oracle/Middleware1
            -movePlanLoc /scratch/oracle/t2pplans/moveplan.xml
            -silent true

Table 20-9 describes the options for the pasteConfig script for Node Manager.

Table 20-9 Options for the pasteConfig Script for Node Manager

Options Shortcut Description Mandatory or Optional

-javaHome

None

The absolute path of the Java Developer's Kit.

If the operating system is SunOS, HP-UX, or Linux 64 bit, pass the -d64 option to the scripts in the command line.

To set the runtime property, you can specify the -d64 option in the T2P_JAVA_OPTIONS environment variable. For example:

setenv T2P_JAVA_OPTIONS "-d64 -Djava.io.tmpdir=/home/t2p/temp"

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

-targetNMHomeLoc

-tnh

The absolute path of the target Node Manager.

Mandatory

-targetMWHomeLoc

-tmw

The absolute path of the target Middleware home in which the copy of Node Manager is to be applied.

Mandatory

-movePlanLoc

-mpl

The absolute path of the modified move plan in the target environment.

Mandatory

-logDirLoc

-ldl

The location of an existing directory. A new log file is created in the directory. The default is the system Temp location.

Optional

-silent

None

Specifies whether the operation operates silently. That is, it does not prompt for confirmation. The default is that the operation prompts for confirmation. To continue, you must type yes, which is not case sensitive. Typing anything other than yes causes the script to return an error.

To specify that it does not prompt for confirmation, specify this option with the value of true.

Optional


20.4 Customizing Move Plans When Moving Components

When you move Oracle Fusion Middleware components, you run the extractMovePlan script to create a move plan for the component 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.

The following shows an excerpt of a move plan for Java components:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movePlan>
    <movableComponent>
        <componentType>J2EEDomain</componentType>
        <moveDescriptor>
            <configProperty>
                <name>Startup Mode</name>
                <value>PRODUCTION</value>
                <itemMetadata>
                    <dataType>STRING</dataType>
                    <scope>READ_WRITE</scope>
                </itemMetadata>
            </configProperty>
            <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>
                    <configProperty>
                        <name>Listen Address</name>
                        <value>example.com</value>
                        <itemMetadata>
                            <dataType>STRING</dataType>
                            <scope>READ_WRITE</scope>
                        </itemMetadata>
                    </configProperty>

You can modify properties with the scope of READ_WRITE. Do not modify the properties with the scope of READ_ONLY.

20.4.1 Locating configGroup Elements

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 20-11, 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>

20.4.2 Move Plans Properties

The tables in this section describe the move plan properties you can customize for Oracle Fusion Middleware components.

The properties that you edit differ depending on the type of component. Table 20-10 provides pointers to the appropriate list of properties for each component.

Table 20-10 Move Plan Properties for Components

Component Where to find the list of properties

Java components

Table 20-11

Oracle ADF connections

Table 20-12

Oracle SOA Suite

Table 20-11 and Table 20-13

Oracle HTTP Server

Table 20-14

Oracle Internet Directory

Table 20-15

Oracle Virtual Directory

Table 20-16

Node Manager

Table 20-17


Table 20-11 describes the properties you can customize for Java components.

Table 20-11 Common Move Plan Properties for Java Components

Properties Description Sample Value

Startup Mode

The startup mode of an Oracle WebLogic Server domain.

Valid values are:

  • DEVELOPMENT. Use this mode while you are developing your applications. Development mode uses a relaxed security configuration and enables you to auto-deploy applications.

  • PRODUCTION. Use this mode when your application is running in its final form. A production domain uses full security and may use clusters or other advanced features.

The default is PRODUCTION.

PRODUCTION

Common Java Properties

The following properties are in the SERVER_CONFIG group.

 

Listen Address

The Listen address of the WebLogic Server. Set it to the host name or set it to all local addresses to listen on all addresses on the host.

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

Custom Identity Keystore File

The absolute path of custom identity keystore file location.

/scratch/Oracle/Middleware/wlserver_10.3/server/lib/example_identity.jks

Custom Identity Keystore Passphrase File

The absolute path to the secure file containing the custom identity keystore password.

/scratch/i_pass.txt

Custom Trust Keystore File

The absolute path of custom trust keystore file location.

/scratch/Oracle/Middleware/wlserver_10.3/server/lib/example_trust.jks

Custom Trust Keystore Passphrase File

The absolute path to the secure file containing the custom trust keystore password.

/scratch/passphrase.txt

Custom Identity Private Key Alias

The private key alias.

example.com

Custom Identity Private Key Passphrase File

The absolute path to the secure file containing the custom identity private key password.

/scratch/i_p_pass.txt

Oracle WebLogic Server Cluster Configuration Properties

The following properties are in the CLUSTER_CONFIG group.

 

Messaging Mode

The cluster messaging mode. Acceptable values are unicast and multicast.

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

Machine Configuration Properties

The following properties are in the MACHINE_CONFIG group.

 

Machine Name

The name of the machine.

example.com

Node Manager Listen Address

The Listen address of the machine running Node Manager.

examplehost

Node Manager Listen Port

The port number of the Listen address of the machine running Node Manager.

5556

Deployment Plans

The following properties are in the DEPLOYMENT_PLAN_CONFIG group.

 

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.

deployment_plans/helloWorldEar_plan.xml

Authenticators

The following properties are in the AUTHENTICATORS group.

 

Host Name

The LDAP server host name.

example.com

Port

The LDAP server port number.

3060

Principal

The Admin 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/p.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

Data Source Configuration

The following properties are in the DATASOURCE group.

 

Driver Class

The driver class of the data source. Refer to "Selecting a JDBC Driver" in the Oracle Fusion Middleware Configuring and Managing JDBC 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, database service name or SID, and the database port number.

jdbc:oracle:thin:@orcl.examplecom:1521/orcl.example.com

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/pass_ds.txt

LDAP-Based Policy and Credential Store Configuration

The following properties are in the OPSS_SECURITY group. They are in the configProperty with the ID of LDAP.

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 exposed. 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 exposed. 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 exposed. 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/pass_ldap.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.

SOA_domain

Server Type

The type of server. Valid values are OID (Oracle Internet Directory) or OVD (Oracle Virtual Directory).

OID

LDAP Url

The URL of the LDAP connection. It contains the host name and port number of the LDAP store.

ldap://example.com:3060

Database-Based Policy and Credential Store Configuration

The following properties are in the OPSS_SECURITY group. They are in the configProperty with the id of DB.

If the source is a database-based store, these properties are exposed in the move plan. (The LDAP-based store is not exposed and you cannot move from a database-based to an LDAP-based store.)

 

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/pass_ldap.txt

DataSource Jndi Name

The name of the data source.

opssds

Jps Root

The LDAP Server context root

cn=jpsRoot

Domain

The name of the domain.

SOA_domain

Driver Class

The driver class of the data source. Refer to "Selecting a JDBC Driver" in the Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server to choose the appropriate class.

oracle.jdbc.OracleDriver

Url

The database URL of the data source. It contains the host name, the database port number, and the database service name or SID.

jdbc:oracle:thin:@hostname.com:1521:orcl

User

The name of the OPSS schema owner of the data source.

DEV_OPSS

RDBMS Security Store

The following properties are in the RDBMS Security Store group.

 

URL

The database URL of the security store connection. It contains the host name, the database port number, and the database service name or SID.

jdbc:oracle:thin:@hostname.com:1521/orcl.us.oracle.com

Driver Class

The driver class of the RDBMS Security Store connection. Refer to "Selecting a JDBC Driver" in the Oracle Fusion Middleware Configuring and Managing JDBC 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/pass_rbms.txt

Resource Adapter Configuration

The following property is in the ADAPTER group.

 

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 20-12 describes the properties you can customize if you are using Oracle ADF connections. 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 20-12 Move Plan Properties for Oracle ADF Connections

Properties 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

Business Components service endpoint provider

ADFBC

JndiFactoryInitial

JNDI initial factory class

com.sun.java.jndi.InitialFactory

JndiProviderUrl

The URL of the JNDI provider

t3://example.com:7101

JndiSecurityPrincipal

JNDI security principal name

weblogic

FabricAddress

Fabric address string

http://example.com

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 Business Activity Monitoring

   

WEBTIER_SERVER

The Oracle BAM web server host

example.com

USER_NAME

The Oracle BAM user name

user

PASSWORD

The password for the Oracle BAM user

password

WEBTIER_SERVER_PORT

The port number for the web server

9001

BAM_SERVER_PORT

The JNDI port number

8001

BAM_WEBTIER_PROTOCOL

The network protocol. The valid values are HTTP and HTTPS.

HTTP

BI Presentation Services connection

OBJECT_NAME_PROPERTY type is BISoapConnection

 

StaticResourcesLocation

The location where the browser should fetch Oracle BI EE static resources.

http://example.com:7001/analytics

WSDLContext

The Oracle BI EE context to use when making a web services call.

analytics-ws

Host

The host where Oracle BI EE is located.

example.com

Port

The port that hosts the BI Presentation Services server.

10621

ShouldPerformImpersonation

Whether Oracle BI EE should perform impersonation. This should always be set to true.

true

Context

The Oracle BI EE context to ue when fetching content.

analytics

Protocol

The protocol to use, depending on whether the Web server is configured with SSL.

http or https

IsStaticResourcesLocationAutomatic

Whether to auto-generate the StaticResourcesLocation from the Host, Port, and Context fields.

true or false

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 Secure Enterprise Search in Oracle WebCenter

The OBJECT_NAME_PROPERTY type is SesConnectionProvide

SoapURL

The Web Services URL that Oracle SES exposes to enable search requests

http:/example.com:port/search/query/OracleSearch

Oracle WebCenter Content Repository

OBJECT_NAME_PROPERTY type is JCR

ServerHost

The host name of the machine where the Content Server is running

example.com

ServerPort

The port number on which the Content Server listens

4444

ServerWebUrl

The Web server URL for the Content Server

http://example.com/cms/idcplg

Oracle WebCenter Announcements and Discussions

OBJECT_NAME_PROPERTY type is ForumConnectionProvider

AdminUser

The name of the Discussions server administrator. This account is used by the Discussions and Announcements services to perform administrative operations on behalf of WebCenter users.

admin

Url

The URL of the Discussions server hosting Discussion forums and Announcements

http://example.com:8890/owc_discussions

Oracle WebCenter External Applications

OBJECT_NAME_PROPERTY type is ExtAppConnectionProvider

Url

The login URL for the external application

https://example.com/config/login?

Oracle WebCenter Instant Messaging and Presence

OBJECT_NAME_PROPERTY type is RtcConnectionProvider

BaseConnectionURL

The URL of the server hosting instant messaging and presence services

http://example.com:8888

Domain

The network domain

example.com

ExternalAppId

The external application ID associated with the Presence server connection. If specified, external application credential information is used to authenticate users against the Microsoft Live Communications Server, Microsoft Office Communications Server, or Oracle WebLogic Communications Server. This property is mandatory for Microsoft Live Communications Server and Microsoft Office Communications Server connections.

extApp

Oracle WebCenter Mail Server

The OBJECT_NAME_PROPERTY is MailConnectionProvider

ExternalAppId

The external application ID associated with the mail server

extApp_Mail

ImapHost

The host name of the IMAP server

example.com

ImapPort

The port number of the IMAP server

993

ImapSecured

Specifies whether the mail server connection to the IMAP server is SSL-enabled. Valid values are true and false. The default is false.

true

SmtpHost

The host name of the computer where the SMTP (Simple Mail Transfer Protocol) service is running

example.com

SmtpPort

The port number of the SMTP host

587

SmtpSecured

Specifies whether the SMTP server is secured. Valid values are true and false. The default is false.

true

Oracle WebCenter Personal Events

The OBJECT_NAME_PROPERTY type is WebCenterPersonalEventConnectionProvider

ExternalAppId

The external application associated with the Microsoft Exchange Server providing personal events services. If specified, external application credential information is used to authenticate users against the Microsoft Exchange Server.

ExtPEApp

WebServiceURL

The URL of the Web service exposing the event application

http://example.com:80/ExchangeWS/PersonalEventsWebService.asmx

Oracle WebCenter Producers

The OBJECT_NAME_PROPERTY type is WSRPProducerConnection

ProxyHost

The host name or IP address of the proxy server

example.com

ProxyPort

The port number of the proxy server

80

Oracle WebCenter URL Connection

The OBJECT_NAME_PROPERTY type is WebProducerConnection

Host

The host name of the proxy server to be used for the Web Producers connection

example.com

Port

The port number to be used for the Web Producers connection

80

URL

The URL for the Web Producers connection

http:/example.com:port

Oracle WebCenter Worklists

The OBJECT_NAME_PROPERTY type is BPEL

URL

The URL required to access the BPEL server. The BPEL server URL must be unique within the WebCenter application.

protocol://example:port

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 20-13 describes the properties you can customize for Oracle SOA Suite.

Table 20-13 Move Plan Properties for Oracle SOA Suite

Properties Description Sample Value

SOA Composites Configuration

The following property is in the Composite group:

 

Config Plan Location

The location of the configuration plan to be used during movement to the target to redeploy the composite application. The path can be absolute, or relative to the location of the move plan.

The plan is extracted during the extractMovePlan script.

/scratch/app/config_plan.xml


In addition to the properties listed in Table 20-11 and Table 20-13, the properties for Oracle B2B channels are in the B2B Channels group. However, because B2B channels can be in various forms, there are no standard properties for a channel. When you extract a move plan, that move plan contains the properties for the current channels in the source environment. Edit the properties to specify values for the target environment.

The following example shows a portion of a move plan for B2B channels:

<movableComponent>
    <componentType>B2B</componentType>
    <moveDescriptor>
        <configGroup>
            <type>B2B Channels</type>
            <configProperty id="Channel1">
                <configProperty>
                    <name>file-param-is_binary</name>
                    <value></value>
                    <itemMetadata>
                        <dataType>STRING</dataType>
                        <scope>READ_WRITE</scope>
                    </itemMetadata>
                </configProperty>
                <configProperty>
                    <name>file-param-marker</name>
                    <value></value>
                    <itemMetadata>
                        <dataType>STRING</dataType>
                        <scope>READ_WRITE</scope>
                    </itemMetadata>
                </configProperty>

Table 20-14 describes the properties you can customize for Oracle HTTP Server.

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 20-14 Move Plan Properties for Oracle HTTP Server

Properties 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/pass.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/password.txt

SSLWallet

The location of the SSL wallet, if the wallet is not in the default location

/scratch/oracle/mw_home/ORACLE_INSTANCE/config/OHS/ohs1/keystores/mywallets

DocumentRoot

The directory that stores the main content for the Web site

/scratch/oracle/mw_home/ORACLE_INSTANCE/config/ohs/ohs1/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/mw_home/Oracle_OAMWebGate1/webgate/ohs

Table 20-15 describes the properties that you can change for the move plan for Oracle Internet Directory.

Table 20-15 Move Plan Properties for Oracle Internet Directory

Properties Description Sample Value

OID Non SSL Port

The non-SSL port for Oracle Internet Directory.

If you do not provide a port number or if the port number you provide is not available, the operation uses an available port.

3060

OID SSL Port

The SSL port for Oracle Internet Directory.

If you do not provide a port number or if the port number you provide is not available, the operation uses an available port.

3131

Namespace

The Oracle Internet Directory namespace.

dc=us,dc=oracle,dc=com

OID Admin Password

The absolute path of a secure file containing the password for the Oracle Internet Directory administrator. You must provide a password file, even if you are not changing the configuration.

/scratch/oracle/pass_oid.txt

ODS Schema Password

The absolute path of a secure file containing the password for the ODS schema, which is the schema that contains metadata for Oracle Internet Directory. You must provide a password file, even if you are not changing the configuration.

/scratch/oracle/pass_ods.txt

ODSSM Schema Password

The absolute path of a secure file containing the password for the ODSSM schema, which is used to access server manageability information for Oracle Internet Directory from the database. You must provide a password file, even if you are not changing the configuration.

/scratch/oracle/pass_odssm.txt

DB Host Name

The host name on which the database is running, which can be found in the tnsnames.ora file

example.com

DB Port

The port number of the database listener, which can be found in the tnsnames.ora file

1521

DB Service Name

The service name for the database, which can be found in the tnsnames.ora file

orcl.example.com


Table 20-16 describes the properties that you can change for the move plan for Oracle Virtual Directory.

Table 20-16 Move Plan Properties for Oracle Virtual Directory

Properties Description Sample Value

OVD Non SSL Port

The LDAP non-SSL port number for Oracle Virtual Directory.

If you do not provide a port number or if the port number you provide is not available, the operation uses the next available port.

6501

OVD SSL Port

The LDAP SSL port number for Oracle Virtual Directory.

If you do not provide a port number or if the port number you provide is not available, the operation uses the next available port.

7501

OVD Admin Port

The administration port number for Oracle Virtual Directory.

If you do not provide a port number or if the port number you provide is not available, the operation uses the next available port.

8899

OVD Http Port

The HTTP listener port number for Oracle Virtual Directory.

8080

host.port

The host name and port for the Oracle Virtual Directory adapter.

example.com:3060

username

The user name for the Oracle Virtual Directory adapter.

cn=orcladmin

root

The root for the Oracle Virtual Directory adapter.

dc=us,dc=oracle,dc=com

remotebase

The remote base for the Oracle Virtual Directory adapter.

dc=us,dc=oracle,dc=com

password

The absolute path of a secure file containing the password for the Oracle Virtual Directory adapter user.

/scratch/oracle/ovd_pass.txt


20.4.3 Move Plan for Node Manager

Table 20-17 describes the properties you can customize for Node Manager.

Table 20-17 Move Plan Properties for Node Manager

Property Description Sample Value

Node Manager Configuration

The following properties are in the NODE_MANAGER_PROPERTIES group:

 

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/Middleware/wlserver_10.3/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.

 

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/pass.txt

Domain Configuration

The following properties are in the DOMAINS group:

 

Domain Name

The name of the domain

SOA_domain

Domain Location

The absolute path of the domain location

/scratch/Oracle/Middleware/user_projects/domains/SOA_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/pass.txt

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/pass.txt