provision_mw

Provisions a non-Oracle middleware provisioning profile.

Examples of non-Oracle middleware include Apache Tomcat, JBoss, etc.

Format

emcli provision_mw_profile 
      -profile="Profile Location" 
      -hosts="List of Hosts" 
      -credentials="List of Credentials" 
      [-input_file=parameters:"Provisioning Options"] 
      [-input_file=host_qualifiers:"Host Qualifiers"] 
      [-action="Provisioning Action"] 
      [-work_dir="Working Directory"] 
      [-analyze] 
      [-schedule= 
          start_time:yyyy/MM/dd HH:mm; 
          [tz:{java timezone ID}]; 
          [grace_period:xxx]; 
       ] 

[ ]  indicates that the parameter is optional.

Options

profile

Complete software library location of the profile.
hosts

Comma separated list of hosts where the profile will be provisioned.
credentials

Comma separated list of named credentials used to access the hosts. To pass one credential parameter, enter a name:value pair in the following format:
```
credential_name:credential_owner
```
Where:

credential_name is the name of the named credential.

credential_owner is the credentials of the Oracle home owner on the administration server host.

Either a single credential should be provided or the number of credentials should match the number of hosts. If a single credential is provided then it will be used for all of the hosts.
input_file:properties

A properties file listing values for all of the parameters required by the commands listed in the profile properties. This is an optional parameter if the commands listed in the profile properties do not require any external parameters.
input_file:host_qualifiers

A plain text file containing details about the hosts that are provided for provisioning. This is an optional parameter if the commands listed in the profile properties do not require any host qualifiers.
action

One of the provisioning actions as described in the profile properties. This option is not mandatory. If no value is provided then the default action mentioned in the profile properties will be used.
work_dir

A temporary working directory for the provisioning process. It will be cleaned up by the procedure at the end. This option is not mandatory. If no value is provided then the agent's working directory will be used.
analyze

Use this flag to specify whether to run the procedure in analyze mode. If this option is passed, then the procedure will pause after the prerequisites for manual intervention.
schedule

Specify when to run the deployment procedure. If no value is entered, by default the procedure runs immediately. To schedule a procedure, provide:
- start_time: when the procedure should start.
- tz: the timezone ID.
- grace_period: grace period in minutes

Examples

Example 1

The following example provisions a profile named MyProfile1 on two hosts using a single credential at the specified schedule.

emcli provision_mw_profile 
      -profile="Middleware Provisioning/Generic Profile/MyProfile1" 
      -hosts="myhost1.mycompany.com,myhost2.mycompany.com" 
      -credentials="MYHOSTCRED:SYSMAN" 
      -input_file=parameters:"/tmp/MyProfile1Input.properties" 
      -input_file=host_qualifiers:"/tmp/host_details.txt"

Example 2

The following example provisions a profile named MyProfile2 on two hosts using individual credentials. The procedure runs the steps specified in the action named 'clone' in the profile properties The provided working directory is used by procedure and it runs in analyze mode.

emcli provision_mw_profile 
      -profile="Middleware Provisioning/Generic Profile/MyProfile2" 
      -hosts="myhost1.mycompany.com,myhost2.mycompany.com" 
      -credentials="MYHOST1CRED:SYSMAN,MYHOST2CRED:SYSMAN" 
      -input_file=parameters:"/tmp/MyProfile2Input.properties" 
      -input_file=host_qualifiers:"/tmp/host_details.xml" 
      -action="clone" 
      -work_dir="/tmp/mytmpdir" 
      -analyze