/
/ $Header: opatch/source/oracle/opatch/opatchfmw/deploy_help.txt /main/3 2010/07/04 22:45:14 vganesan Exp $
/
/ deploy_help.txt
/
/ Copyright (c) 2009, Oracle. All Rights Reserved.
/
/   NAME
/     deploy_help.txt - <one-line expansion of the name>
/
/   DESCRIPTION
/     <short description of component this file declares/defines>
/
/   NOTES
/     <other useful comments, qualifications, etc.>
/
/   MODIFIED   (MM/DD/YY)
/   akmaurya    12/11/09 - help text for -silent option
/   supal       11/15/09 - Domain can be optional
/   vganesan    10/26/09 - Support 'report', 'property_file' option
/   vganesan    10/26/09 - Update help for 'ph' option
/   vganesan    09/30/09 - Updated to help wrt mw_home, oh option
/   supal       09/07/09 - Further updates to the deploy help
/   vganesan    08/24/09 - Modified the command option values
/   supal       08/17/09 - Help text for the deploy command
/   supal       08/17/09 - Creation
/
DESCRIPTION
    This operation deploys modified artifacts from the Fusion Middleware
    ORACLE_HOME to the Fusion Middleware domain. The patch location can 
    be specified by 'ph' location option. If the patch is already applied
    to the Oracle Home, the 'id' option can be used to specify the patch
    to be used for deployment. 

    The -domain <DOMAIN_NAME> option has to be specified along with the
    -auto option for automated rollout to the Fusion Middleware domain.
    If only a single domain has been created out of the Oracle Home
    you can omit specifying the domain name. Only certain patches which
    have been certified by Oracle Product Support can be rolled out using
    this command.

    OPatch will pose questions to query for information necessary for 
    accessing the Fusion Middleware domain such as Admin Server URL, 
    Admin Server User, Admin Server Password, Node Manager User and Node
    Manager password.

SYNTAX
opatch deploy [-domain <DOMAIN_NAME>] [-auto ]
              [-id <ID of the patch installed in Oracle Home> ]
              [-invPtrLoc <Patch to oraInst.loc file ] 
              [-mw_home <Middlware Home> ]
              [-ph <Patch Location> ]
              [-oh <Oracle Home Path> ] 
              [-report ]
              [-silent ] [-property_file <Path to custom property file>]            
 
OPTIONS

       -domain
              The name of the Fusion Middleware domain to which the
              artifacts affected by the patch will be redeployed.
 
       -auto
              This option has to be specified if automated rollout of the
              patch is required to be performed by OPatch. This option
              causes OPatch to also bounce the WebLogic servers hosting
              the applications needing redeployment.
 
       -id
              A single Patch ID that is installed in the Oracle Home.

       -ph
              Location of the patch. If it is not specified, the current
              directory is taken as the patch location.
 
       -property_file
              The user defined property file for OPatch to use. The
              path to the property file should be absolute. This
              property file takes precedence over the one that is
              supplied with OPatch
              For FMW components, 'userConfigFile', 'userKeyFile',
              'NodeManagerConfigFile' and 'NodeManagerKeyFile'
              location can be specified as keys with corresponding files
              as values. They refer to encrypted, decrypted files for Admin
              user, Admin password, Node Manager user and Node Manager
              password. Similarly, Admin Server URL (key as AdminServerURL),
              Domain Home (key as DomainHome) and Applications Directory (key
              as ApplicationsDir) can be given as keys with corresponding
              values. The Key, value pair is of the format 'x=y' where 'x' is
              OPatch understood key and each pair is separated by newline in the
              property file.
 
       -invptrloc
              Used to locate the oraInst.loc file. Needed when the
              installation uses the -invPtrLoc flag. This should be
              the path to the oraInst.loc file.

       -mw_home
              The Middleware Home for the Fusion Middleware install. This
              takes precedence over the environment variable MW_HOME. 

       -oh
              The Oracle Home of the Fusion Middleware product which is to be
              used for the deploy operations. This takes precedence over the
              environment variable ORACLE_HOME.

       -report
              Just prints out the actions without execution.

       -silent
              Invoke the operation in silent mode. Path to custom property
              file may be provided which will have required inputs as
              name-value pairs. If required inputs are not found, OPatch will
              exit with error message quoting the missing inputs.
              Required inputs are userConfigFile, userKeyFile, AdminServerURL,
              DomainHome, ApplicationsDir.  

PARAMETERS
   The 'ph' option is mandatory when patch is not installed in the Oracle Home.
   The 'id' option can be used when patch is installed in the Oracle Home.
