13 Provisioning Oracle Fusion Middleware

Steps Involved in Provisioning WebLogic Domains

This section lists the sequence of operations that are performed when you run the Fusion Middleware Provisioning Deployment Procedure in Enterprise Manager Grid Control.

• Verify Source

• Verify Destination

• Prepare Source Binary Archive

• Create Binary Clones on Destination

• Create Source Domain Archive

• Create Domain on Administration Server Host (Target)

• Configure Domain

• Create Domain Archive

• Create Domain on Managed Server Hosts

• Start Up Node Managers

• Start Up Admin Server

• Start Up Managed Servers

• Validate Domain

• Register Fusion Middleware homes and domains with OMS

Steps Involved in Scaling Up / Out WebLogic Domains

You can scale up a WebLogic Domain by adding a new managed server to existing cluster or by provisioning a managed server to an existing host machine that is already running a managed server in the domain or cluster. You can scale out the domain by adding a managed server or cloning a managed server to a remote, new host machine that does not yet exist in the domain. This section lists the sequence of steps that are involved in scaling up / out a WebLogic Domain.

• Verify Source

• Verify Destination

• Prepare Source Binary Archive

• Create Binary Clones on Destinations

• Clone / Add Managed Servers

• Create Domain Archive

• Create Domain on Managed Server Host

• Start Up Node Managers

• Start Up Managed Servers

• Register Fusion Middleware homes and domains with OMS

Deployment Phases

The following describes the different phases involved in this Deployment Procedure:

Table 13-2 Deployment Phases Involved in Provisioning a WebLogic Domain

Phase	Description
	Select Source Allows you to select a WebLogic Domain or a Fusion Middleware Home that you want to provision, the working directory on the source machine, and the credentials for the host machine on which the Administration Server is installed. Note: The Middleware Home consists of the Oracle WebLogic Server Home and one or more Oracle homes.
	Select Target Allows you to specify the destination hosts on which the domain needs to be cloned or created. You can add one or more hosts and specify the credentials for the destination hosts. You can also specify the path to the working directory and the Fusion Middleware Home directory.
	Configure Domain Allows you to configure the details of the domain that is to be provisioned. In this phase, you can perform configuration tasks such as set up the domain, set the credentials for the Administration Server, set up Node Manager, configure machines, and provide details on the different data sources.
	Review Allows you to review the details you have provided for provisioning a Fusion Middleware Domain.

Prerequisites

Before running the Deployment Procedure, meet the following prerequisites:

• The target machine should contain sufficient space. If the size of the Fusion Middleware Home on the source machine is 3 GB, you need approximately 3 GB in the working directory on the source and destination machines. Additionally, the destination machine should also have 3 GB of space for the Fusion Middleware Home. The working directory is cleaned up after deployment procedure has been successfully completed.

• The Fusion Middleware Home directory you specify on the destination machine must be a new directory or an empty one.

• The operating system user who runs the deployment procedure must belong to the same group and have the same permissions as the user who owns the Oracle Universal Installer Inventory. This will ensure that the group ownership on the Middleware Home directory on the destination machine will match the group ownership on the OUI inventory.

• Ensure that the 11.1 Management Agent has been installed on the source (on which the Administration Server is running) and destination machines.

Running the Fusion Middleware Provisioning Deployment Procedure

To provision a Fusion Middleware Domain, follow these steps:

1. In Grid Control, click the Deployments tab.

2. Click Deployment Procedures in the Deployment Procedure Manager section.

3. On the Deployment Procedure Manager page, in the Procedures subtab, from the table, select Fusion Middleware Provisioning. Then click Schedule Deployment.

   Enterprise Manager Grid Control displays the Select Source page of the Oracle Fusion Middleware Deployment Procedure.

   Note:

   You cannot customize the deployment procedure and include additional steps that require user input.

4. On the Select Source page, do the following:

   1. In the Select Existing installation section, you can choose a WebLogic Domain or a Fusion Middleware Home. Select WebLogic Domain if you want to provision the domain and the software. Select Fusion Middleware Home if you want to provision the software only. The Fusion Middleware Home is provisioned first in a new environment. Domains are provisioned later and associated with the same software. Click the torch icon in the Select WebLogic Domain field and select a domain from the list. In the Source Information section, the WebLogic Domain Components including the Host, Fusion Middleware Home, WebLogic Server Home, and Fusion Middleware Domain Location are displayed.

      Note:

      The deployment procedure may fail when the following situations occur:

      • You select a WebLogic Domain that is not supported. To successfully complete the deployment, you must select a supported version from the list.

      • The corresponding Oracle homes are not listed under the selected domain. Before proceeding with the deployment, click Refresh Hosts in Enterprise Manager Grid Control console to ensure that the Oracle homes are properly discovered or select a different domain.

   2. If you select a Fusion Middleware Home, click the torch icon in the Select Fusion Middleware Home field and select a Fusion Middleware Home from the list. In the Source Information section, the Host, Fusion Middleware Home, and WebLogic Server Home are displayed.

   3. In the Working Directory field, specify the directory on the Administration Server machine on which the provisioning related files are temporarily stored. If this directory is not present, it will be created. When the provisioning operation has been completed, the contents of this directory will be deleted.

   4. In the Host Credentials section, select Preferred Credentials so that the preferred credentials stored in the Management Repository are used. The Preferred Credentials option will be available only if it has already been defined in Enterprise Manager Grid Control. For more information on setting up Preferred Credentials, see the Enterprise Manager Security chapter in the Enterprise Manager Administration Guide.

      Note:

      You can optionally override these preferred credentials. For example, if you have added two source hosts where the users are A and B, then you can choose Override Credentials - Different for Each Host and specify different credentials for each of the hosts. Similarly, if the destination hosts have the same credentials, which may be different from the preferred credentials, then you can choose Override Credentials - Same for All Hosts. The credentials you specify here are used by the Deployment Procedure to run the provisioning operation. If this environment is secure and has locked accounts, then make sure that:

      • The credentials you specify here have the necessary privileges to switch to the locked account for performing the provisioning operation. These include privileges to run sudo and powerbroker commands.

      • The Deployment Procedure has been customized to support locked environments.

      For more information, see Customizing Steps to Run as Another User

      Figure 13-4 Select Source Page

      
      

   5. Click Next.

      Enterprise Manager Grid Control displays the Select Targets page.

5. On the Select Targets page you can specify the target hosts on which the domain is to be created.

   Figure 13-5 Select Targets Page

   
   

   You can do the following:

   1. Click on the torch icon in the Host column and select a host from the list.

   2. If you choose to override the preferred credentials, specify the user name and password for the selected host.

   3. In the Fusion Middleware Home field, enter the full path to the directory in which the Fusion Middleware Home is to be created.

   4. If the JDK on the destination machine is in an external location, enter the full path to the location in the JDK Home Location field.

      Note:

      If you are using the WebLogic Server generic installer, the external JDK location must be specified. If this location is not specified, the default JDK of the Management Agent will be used.

   5. Check the Agent Credentials checkbox to specify the agent credentials. This field is applicable if the user who installed the Management Agent is different from the user installing Oracle Fusion Middleware.

   6. Click Next to proceed to the Configure Domain page.

6. On this page, you can enter the basic properties that are most likely to be reconfigured like domain name, administration server, clusters, machines, server, and JDBC Data Sources. For more information on configuring the domain, see the Creating WebLogic Domains Using the Configuration Wizard guide.

   1. In the Domain Properties page, enter a unique name for the domain, the username for the Administration Server and the password. You also need to enter the name of the Farm and the Domain Location (path to the directory in which the domain is to be created). The Domain Location directory must be empty.

      Figure 13-6 Domain Properties Page

      
      

      Tip:

      A farm is a collection of components managed by Enterprise Manager Grid Control. It can contain Oracle WebLogic Server domains, one Administration Server, one or more Managed Servers, and the Oracle Fusion Middleware components that are installed, configured, and running in the domain. For more information, see the Oracle Fusion Middleware Concepts Guide.

   2. In the Administration Server page, enter the name of the Administration Server that will be used to manage the domain, listen address and port, and the name of the host on which the Administration Server is to be installed. If you checked the Enable SSL checkbox, enter the number of the SSL port for secure requests. You must ensure that the port numbers you specify for the Listen Port and SSL Listen Port are available.

      Note:

      If you are using the SSL configuration, you must ensure that the security/identity stores are present in the file system under the same path as on the source and are configured with certificates generated for the destination hosts.

      Figure 13-7 Administration Server Page

      
      

   3. In the Clusters page, enter a name for the cluster, the cluster address that identifies the Managed Servers in the cluster, and the messaging mode (multicast or unicast). If you selected Multicast as the Messaging Mode, enter the multicast address and port.

      Figure 13-8 Clusters Page

      
      

   4. In the Machines page, enter the configuration information for the machines in the domain. You can add or delete configuration for the machines on this page.

      Figure 13-9 Machines Page

      
      

   5. In the Servers page, enter the configuration information for the managed server.

      Figure 13-10 Servers Page

      
      

      Tip:

      The port numbers you specify for the Listen Port and the SSL Listen Port on the Machines and Servers pages must be available on the target machine.

   6. In the JDBC Data Sources page, enter the configuration information for the data source. In the Driver field, select the correct driver from the drop down list. Based on the driver you have selected, enter the URL in the correct format. Select the target from the drop down list and specify the database user name and password.

      Figure 13-11 JDBC Data Sources Page

      
      

   7. In the JMS page, you can add new JMS persistent stores and JMS servers.

      Figure 13-12 JMS Page

      
      

   8. In the Server Startup Mode page, you can optionally start up the Managed Servers and the Admin Server. You can choose the following options:

      - Start Administration and Managed Servers

      - Start Administration Server

      - Do not start Administration Server or Managed Server

      Figure 13-13 Server Startup Mode Page

      
      

7. On the Schedule Deployment page, you can schedule the provisioning of the domain by specifying the time zone, time at which the deployment process should be started and other details.

8. On the Review page, review the details you have provided for the Deployment Procedure. If you are satisfied with the details, then click Submit to run the Deployment Procedure according to the schedule set. If you want to modify the details, click the Edit link in the section to be modified or click Back repeatedly to reach the page where you want to make the changes.

   After submitting the Deployment Procedure, you should see a link on top of the page. Click the link to view its progress. Alternatively, from the Deployments page, in the Deployment Procedure Manager section, click Procedure Completion Status to view the status of the Deployment Procedure.

9. After the Deployment Procedure has been successfully completed, the newly cloned domain will be added as a new target in Enterprise Manager Grid Control and can be monitored along with the other Fusion Middleware targets.

Deployment Phases

The following describes the different phases involved in this Deployment Procedure:

Table 13-3 Deployment Phases Involved in Scaling Up a Fusion Middleware Domain

Phase	Description
	Select Source Allows you to select an existing Fusion Middleware Domain that is to be scaled up, and specify the credentials for the Administration Server Console and Host.
	Configure Domain Allows you to add a new managed server, clone an existing server and specify configuration properties such as managed server name, listen name, address port, and so on.
	Review Allows you to review the details you have provided for scaling up a WebLogic Domain.

Prerequisites

Before running the Deployment Procedure, meet the prerequisites listed in Prerequisites.

Running the Fusion Middleware Domain Scale Up Deployment Procedure

To scale up / scale out a WebLogic Domain, follow these steps:

1. In Grid Control, click the Deployments tab.

2. On the Deployments page, in the Deployment Procedure Manager section, click Deployment Procedures.

3. On the Deployment Procedure Manager page, in the Procedures subtab, from the table, select Fusion Middleware Domain Scale Up. Then click Schedule Deployment.

   Enterprise Manager Grid Control displays the Select Source page of the Oracle Fusion Middleware Domain Scale Up Procedure.

   Figure 13-14 Select Source Page (Scale Up)

   
   

4. On the Select Source page, you can do the following:

   1. Click the torch icon in the Select Fusion Middleware Domain field and select a domain from the list. In the Source Information section, the details of the source domain including the Host, Fusion Middleware Home, WebLogic Server Home, and the Fusion Middleware Domain Location are displayed.

      Note:

      While running the deployment procedure, ensure that the Administration Server and Managed Server are running. You must also select a WebLogic domain that is supported from the list. If you select an unsupported version, the deployment procedure will fail.

   2. In the Working Directory field, specify the directory on the Administration Server machine on which the domain scale up related files are temporarily stored. If this directory is not present, it will be created. When the scale up operation has been completed, the contents of this directory will be deleted.

   3. In the Provisioning Mode section, enter the credentials for the Administration Server Console and the Administration Server Host. For the Administration Server Host, you can choose Preferred Credentials or choose Override Preferred Credentials and specify a user name and password for the host on which the server is running. The Preferred Credentials option will be available only if it has already been defined in Enterprise Manager Grid Control. For more information on setting up Preferred Credentials, see the Enterprise Manager Security chapter in the Enterprise Manager Administration Guide.

   4. Click Next.

      Enterprise Manager Grid Control displays the Configure Domain page.

   Figure 13-15 Configure Domain Page - Scale Up

   
   

5. On the Configure Domain page, you can add a new managed server, clone an existing one, or delete a managed server you have created. You can do the following:

   1. Click the Add Server tab in the left panel. A new server is added to the list and you need to enter the configuration details on the right panel.

   2. Select a server from the list and click the Clone Server tab in the left panel. A new server which is a copy of the one you selected will be created. You must configure the new server to proceed with the provisioning.

   3. In the Configure Managed Server section, enter the name of the host on which the managed server is to be added, the name of the new server, listen address, port, and the SSL port if applicable. If you checked the Enable SSL checkbox, enter the number of the SSL port for secure requests.

      Tip:

      The port numbers you specify for the Listen Port and the SSL Listen Port must be available on the target machine.

   4. In the Configure Machines section, you can configure the Machine and the Node Manager associated with the managed server instance.

      Note:

      To perform administrative operations such as start and stop from the Enterprise Manager Grid Control, the Node Manager must be configured and running on the machine.

   5. In the Software Installation section, in the Working Directory field, enter the full path to the directory on which the files required for scale up will be staged.

   6. In the Managed Server Credentials section, enter the user name and password for the host on which the managed server is to be created.

   7. Check the Agent Credentials checkbox to specify the agent credentials. This field is applicable if the user who has installed the Management Agent is different from the user installing Oracle Fusion Middleware.

   8. Click Next to proceed to the Schedule page.

6. On the Schedule Deployment page, you can schedule the domain scale up by specifying the time zone, time at which the deployment process should be started and other details.

7. On the Review page, review the details you have provided for the Deployment Procedure. If you are satisfied with the details, then click Submit to run the Deployment Procedure according to the schedule set. If you want to modify the details, click the Edit link in the section to be modified or click Back repeatedly to reach the page where you want to make the changes.

   After submitting the Deployment Procedure, you should see a link on top of the page. Click the link to view its progress. Alternatively, from the Deployments page, in the Deployment Procedure Manager section, click Procedure Completion Status to view the status of the Deployment Procedure.

8. After the Deployment Procedure has been successfully completed, the newly added Managed Servers will be added to the domain and the domain will be refreshed in the Enterprise Manager Grid Control console.