Friday, 11 October 2013

4.Appendixes

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

4.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.
Ensure that the archive location is not within the Middleware home structure.
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 clone operation operates silently. That is, it does not prompt for confirmation. The default is that the operation prompts for confirmation. 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

4.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 target 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 clones 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 specify that it does not prompt for confirmation, specify this option with the value of true.
Optional

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

4.5   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

4.6      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 cloned.
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 specify that it does not prompt for confirmation, specify this option with the value of true.
Optional

4.7   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 cloned. 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 cloning.
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 specify that it 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.