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.example.com;HomeLoc=/home/oracle/appserver1;
    HomeName=oracleAppServer1;ScratchLoc=/tmp"