clone_as_home
Clones the specified Application Server Oracle Home or S/W Library component from the target host to specified destinations. For a Portal and Wireless installation, the OID user and password are also needed. For a J2EE instance connected to only a DB-based repository, a DCM Schema password is needed.
Passing Variables Through EM CLI
When working with variables such as %perlbin%
or %oracle_home%
, EM CLI passes variable values from the current local environment instead of the variables themselves. To pass variables through an EM CLI command, as might be the case when using the -prescripts
or -postscripts
options, you can place the EM CLI command in a batch file and replace all occurrences of %
with %%
.
Format
emcli clone_as_home -input_file="dest_properties:file_path" -list_exclude_files="list of files to exclude" -isSwLib="true/false" -tryftp_copy="true/false" -jobname="name of cloning job" -iasInstance=instance -isIas1013="true/false" [-oldIASAdminPassword=oldpass] [-newIASAdminPassword=newpass] [-oldoc4jpassword=oldpass] [-oc4jpassword=newpass] [-oiduser=oid admin user] [-oidpassword=oid admin password] [-dcmpassword=dcm schema password] [-prescripts="script name to execute"] [-run_prescripts_as_root="true/false"] [-postscripts="script to execute"] [-run_postscripts_as_root="true/false"] [-rootscripts="script name to execute"] [-swlib_component ="path:path to component;version:rev"] [-source_params="TargetName:name;HomeLoc:loc;HomeName:name; ScratchLoc:Scratch dir Location" [-jobdesc="description"] [ ] indicates that the parameter is optional
Options
-
input_file="dest_properties:file_path"
File containing information regarding the targets.
Each line in the file corresponds to information regarding one destination.
Format:
Destination Host Name1;Destination Home Loc; Home Name; Scratch Location;
For more information about the input_file option, see -input_file Syntax Guidelines.
-
list_exclude_files
Comma-separated list of files to exclude. Not required if the source is software lib. "*" can be used as a wild card.
-
isSwLib
Specifies whether it is an Oracle Home database or Software Library.
-
ryftp_copy
Try FTP to copy or not. You should set the FTP copy option to false when using EM CLI from the command line.
-
jobname
Name of the cloning job.
-
iasInstance
Name of instance.
-
isIas1013
Specifies whether this is a 10.2.3 Ias home.
-
oldoc4jpassword
Old OC4j password. (Required for 10.1.3 Ias homes.)
-
oc4jpassword
New OC4J password. (Required for 10.1.3Ias homes.)
-
oldIASAdminPassword
Old Application Server administrator password. (Not required for 10.1.3 Ias homes.)
-
newIASAdminPassword
New Application Server administrator password. (Not required for 10.1.3 Ias homes.)
-
oiduser
OID admin user.
-
oidpassword
OID admin password.
-
dcmpassword
DCM schema password.
-
prescripts
Path of script to execute.
Note:
Double-quoted options can be passed using an escape (\) sequence. For example:
prescripts=" <some value here>=\"some value here\" "
-
run_prescripts_as_root
Run prescripts as "root". By default, the option is set to false.
-
postscripts
Path of script to execute.
-
run_postscripts_as_root
Run postscripts as "root". By default, the option is set to false.
-
rootscripts
Path of the script to execute. The job system environment variables (
%oracle_home%
,%perl_bin%
) can be used for specifying script locations. -
swlib_component
Path to the Software Library to be cloned. "isSwLib" must be true in this case.
-
source_params
Source Oracle home information. "isSwLib" must be false in this case.
-
jobdesc
Description of the job. If not specified, a default description is generated automatically.
Example
emcli clone_as_home -input_file="dest_properties:/home/destinations.txt" -list_exclude_files="centralagents.lst" -isSwLib="false" -tryftp_copy="false" -jobname="clone as home" -iasInstance="asinstancename" -isIas1013="false" -oldIASAdminPassword="oldpassword" -newIASAdminPassword="newpassword" -prescripts="/home/abc/myscripts" -run_prescripts_as_root="true" -rootscripts="%oracle_home%/root.sh" -source_params="TargetName:host.domain.com;HomeLoc=/home/oracle/appserver1; HomeName=oracleAppServer1;ScratchLoc=/tmp"