extend_as_home
Clones the specified Application Server Oracle Home or Software Library component from the target host to specified destinations. The new hosts join an existing cluster. For a Portal and Wireless install, OID user and password are also needed. For a J2EE instance connected to only a database-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 extend_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 -clustername=name of the cluster to join -oldIASAdminPassword=oldpass -newIASAdminPassword=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 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 Loca
For information about the input_file parameter, see -input_file Syntax Guidelines.
-
input_file=list_exclude_files
Comma-separated list of files to exclude. This is not required if the source is a Software Library. You can use an asterisk "*" as a wildcard.
For information about the input_file parameter, see -input_file Syntax Guidelines.
-
isSwLib
Specifies whether it is an Oracle Home database or Software Library.
-
tryftp_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
Application Server instance.
-
clustername
Name of the cluster to join.
-
oldIASAdminPassword
Old Application Server administrator password.
-
newIASAdminPassword
New Application Server administrator password.
-
oiduser
OID administrator user.
-
oidpassword
OID administrator password.
-
dcmpassword
DCM schema password.
-
prescripts
Path of the script to execute.
Note:
Double-quoted parameters 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, this option is set to false. -
postscripts
Path of the script to execute.
-
run_postscripts_as_root
Runs postscripts as
root
. By default, this option is set to false. -
rootscripts
Path of the script to execute. You can use the job system environment variables (
%oracle_home%
,%perl_bin%
) to specify 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.
Examples
emcli extend_as_home -input_file="dest_properties:/home/destinations.txt" -list_exclude_files="centralagents.lst" -isSwLib="false" -tryftp_copy="false" -jobname="extend as home" -iasInstance="asinstancename" -isIas1013="false" -clustername=ascluster -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"