Skip Headers
Oracle® Enterprise Manager Cloud Administration Guide
12c Release 3 (12.1.0.3)

E28814-10
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

15 Setting Up an MWaaS Cloud

This chapter covers the initial configuration required to set up and enable a Middleware as a Service Cloud. It contains the following sections:

15.1 Getting Started with MWaaS - Physical Flow

This section helps you get started by providing an overview of the steps involved in setting up the Middleware as a Service (MWaaS) to provision a service instance on one or more physical hosts. Before you set up MWaaS, you must download and deploy the required plug-ins. For more details, see Section 3.3, "Deploying the Required Plug-ins".

Table 15-1 Getting Started with MWaaS (Physical Flow)

Step Task Role

1

Define roles for administrators and self service users. See Section 3.4, "Defining Roles and Assigning Users".

Super Administrator

2

Install the Management Agent on unmanaged hosts so that they can be monitored by Enterprise Manager. Section 9.2, "Adding Hosts".

Super Administrator

3

Optionally, you may need to configure Privilege Delegation Settings on your managed hosts. Section 3.6, "Configuring Privilege Delegation Settings".

Super Administrator

4

Configure the storage location for the Software Library. See Section 3.1, "Setting Up the Software Library"

Cloud Administrator

6

Create a Middleware Home. See Section 15.1.2, "Creating a Middleware Home".

Self Service Administrator

7

Create a WebLogic Domain Provisioning Profile (see Section 15.1.1.1, "Creating a WebLogic Domain Provisioning Profile") or create a Configured Deployment Procedure (see Section 15.1.3, "Configuring and Saving the Deployment Procedure".)

Note: Oracle recommends that you use the WebLogic Domain Provisioning Profile to set up MWaaS.

Self Service Administrator

5

Load Middleware Provisioning Profiles into the Software Library. See Section 15.1.1, "Creating Provisioning Profiles".

Self Service Administrator


Figure 15-1 shows the sequence of steps required to enable MWaaS (physical hosts).

Figure 15-1 Getting Started with MWaaS (Physical Flow)

MwaaS Setup

15.1.1 Creating Provisioning Profiles

Provisioning profiles can be used to standardize deployments and help reduce errors when deployment procedures are configured. These provisioning profiles are used by operators for mass deployment. You can:

15.1.1.1 Creating a WebLogic Domain Provisioning Profile

A WebLogic Domain Provisioning Profile consists of the Middleware Home, binaries, and the domain configuration. You can create a profile, save it in the Software Library, and then use the saved profile as the source for creating new WebLogic domains. This will ensure that future WebLogic installations follow a standard, consistent configuration.

Prerequisites

  • The Management Agent must be running on the Administration Server.

  • You must have the host credentials for the Administration Server running on the source machine.

  • The WebLogic Domain for which the profile is being created must be a monitored target in Enterprise Manager.

  • The disk space required to create a profile is calculated as follows:

    Disk Space = Middleware Home Size + WebLogic Domain Size + Space for Temporary Scripts

  • The JRF binaries are installed in the Middleware Home and configured in the domain.

  • The WebLogic domain must be configured through Fusion Middleware Control. This ensures that the Fusion Middleware Control link is displayed in the Service Instance Home page in the Middleware Self Service Portal. See Section 17.3, "Viewing the Middleware Service Home Page".

  • The WebLogic Domain that is used to create a profile must meet the following requirements:

    • The WebLogic Domain must be configured on a single host, with a single cluster and one or more Managed Servers.

    • The machine associated with the WebLogic Server must not be of Unix type.

    • The Administration Server must not be associated with a machine.

  • The maximum heap value of all the servers must have an appropriate -Xmx setting in multiples of 256. For example, Xms1024m -Xmx1536m -XX:PermSize=512m -XX:MaxPermSize=1536m and so on. You must define the -Xmx server setting to ensure that the MWaaS memory metric and quota checking feature works properly. The value of the memory metric for a MWaaS service is the sum of the maximum heap available for all servers in the service.

To create a profile, follow these steps:

  1. From the Enterprise menu, select Provisioning and Patching, then select Software Library.

  2. From the Actions menu, click Create Folder to create a folder in which the profile you are creating is to be stored. We recommend that you do not use an out-of-box folder to store the profile.

  3. Select the folder that you have created, and from the Actions menu, select Create Entity, and then select Component.

  4. The Create Component popup window appears. From the Select Subtype drop-down list, select the WebLogic Domain Provisioning Profile component and click Continue.

  5. In the Create WebLogic Domain Provisioning Profile: Describe page, the Parent Directory under which the profile will be created and the Subtype are displayed. Enter a name (only alphanumeric characters and underscores are allowed) and description for the profile and enter the values for the Product Version, Product, and Vendor attributes. For example, enter the Product Version as 10.3.6, Product as WebLogic Domain, and Vendor as Oracle.

  6. Click Next. The Create WebLogic Domain Provisioning Profile: Configure page appears.

    Figure 15-2 Create WebLogic Domain Provisioning Profile: Configure

    Create WebLogic Domain Provisioning Profile: Configure
  7. Click the Search icon next to the WebLogic Domain field and select a WebLogic Domain from which the profile is to be created. The profile will include both the software in the Middleware Home as well as the configuration in the WebLogic Domain home.

  8. Deselect the Include the binaries from the Middleware Home in the profile to be created checkbox. Since the Middleware Home is already installed, deselecting this checkbox ensures that only the configuration is included.

  9. In the Working Directory field, specify the directory on the host machine on which the files required for creating the profile are temporarily stored. If this directory is not present, it will be created. When the profile has been created, the contents of this directory will be deleted.

  10. In the Host Credentials section, enter the host credentials of the machine on which the Administration Server of the source WebLogic Domain is installed. Select one of the following options:

    • Preferred Credentials: 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. For more information on setting up Preferred Credentials, see Managing Preferred Credentials.

    • Named Credentials: The credentials stored in the Management Repository is used. To use the Named Credentials stored in the Management Repository, you must have already registered each of the preferred credential types with a unique name. Select the desired Named Credentials from the list available.

  11. Click Next. In the Review page, you can review the information and click Save and Upload.

  12. The Job Name is displayed at the top of the page. Navigate to the Job Activity page and check the job status. Once it has been completed, navigate to the Software Library page and confirm if all the components of the profile (WebLogic Domain, MWHome, and Profile) have a Ready Status. You can also verify if the profile has been successfully created by navigating to the Middleware Provisioning page. From the Enterprise menu, select Provisioning and Patching, then select Middleware Provisioning and check if the profile is displayed there. You can now use this profile as the source for future WebLogic Domain installations.

15.1.1.2 Using the Out-of-the-box Provisioning Profile

When you install Enterprise Manager, a self update archive with a sample out-of-the-box provisioning profile is available. You can download the profiles from the Self Update console.

To use the out-of-the-box provisioning profile, follow these steps:

  1. Log in to Enterprise Manager as a user with the EM_CLOUD_ADMINISTRATOR role.

  2. From the Setup menu, select Extensibility and then select Self Update. The Self Update Console with the list of entity types that can be downloaded appears.

    Figure 15-3 Self Update Console

    Self Update Console
  3. Select the Middleware Profiles and Gold Images folder and click Open. The Middleware Profiles and Gold Images Updates page appears. You will see "1" as an available update.

  4. Select the update and click Download. The Schedule Download dialog appears.

  5. Specify if the update is to be downloaded immediately or at a later date.

  6. Click Select. An Enterprise Manager job is created to download the update to the Software Library. Enterprise Manager starts downloading the archive from the Oracle Enterprise Manager store. Wait for the download to complete. (When in offline mode the system starts reading from the specified location.) When the download is complete, the status indicates that the update has been downloaded.

    Figure 15-4 Middleware Profiles and Gold Images Updates: Downloaded

    Middleware Profiles and Gold Images Updates: Downloaded
  7. Click Apply. A job is submitted to apply the update. The downloaded update is applied and appears on the Middleware Profiles and Gold Images Updates page.

    Figure 15-5 Middleware Profiles and Gold Images Updates: Applied

    Middleware Profiles and Gold Images Updates: Applied

When the updates have been applied, the profile is copied under the Oracle Supplied Fusion Middleware Provisioning Profiles/10.3.6.0/linux64 directory in the Software Library. These profiles can then be used to create services templates that can be used provision one or more service instances. See Section 16.1, "Setting Up the Middleware Cloud Self Service Portal" for details on creating service templates.

Note:

  • The out-of-the-box profile has been certified to work with WebLogic Server 10.3.6.0.

  • As the sample provisioning profile does not contain the Oracle Middleware Home Gold Image component, you must ensure that the Middleware Homes (WebLogic 10.3.6.0) and JRF binaries of the same version have been created on the selected destination host(s) when they are provisioned.

15.1.2 Creating a Middleware Home

A Middleware Home consists of the WebLogic Server Home (such as WebCenter Home, WebTier Home, and so on) and optionally, one or more Oracle Homes. The Middleware Home must be created on all the hosts that are part of the PaaS Infrastructure Zone. See Section 9.3, "Creating a PaaS Infrastructure Zone" for details. If the Middleware Home has not been created on a host, that host cannot participate in the Middleware Pool.

Note:

You can also manually install the Middleware Home and use the Discover Promote Oracle Home Target job to discover it in Enterprise Manager.

To create a Middleware Home, you must run the Provision from Oracle Middleware Home Gold Image deployment procedure.

Prerequisites

Before running this deployment procedure, you must meet the following prerequisites:

  • The user must have Write permissions on:

    • The Working Directory on all destination hosts.

    • The Middleware Home on all destination hosts.

  • An Oracle Middleware Home Gold Image must be present in the Software Library. For details on creating this gold image, see Section 15.1.2.2, "Creating an Oracle Middleware Home Gold Image".

15.1.2.1 Provision from Oracle Middleware Home Gold Image Deployment Procedure

Note:

  • If you have manually created and discovered a Middleware Home, this step can be ignored.

  • You cannot have more than one Middleware Home of the same WebLogic Server version on a single host.

You can clone a Middleware Home from a gold image present in the Software Library. This gold image must have been created earlier by pointing to an existing Middleware Home. To clone a Middleware Home from a gold image, follow these steps:

  1. From the Enterprise menu, select Provisioning and Patching, then select Middleware Provisioning.

  2. From the Middleware Provisioning Deployment Procedures section, select the Provision Middleware procedure from the list and click Launch.

  3. In the Middleware Provisioning: Source page, select the Provision from Oracle Middleware Home Gold Image option. Click the Search icon next to the Home Gold Image from Software Library field and select a gold image from the list.

  4. In the Source Information section, the selected component and its location is displayed. Click Next.

  5. In the Middleware Provisioning: Destinations page, specify the destination hosts on which the Middleware Home is to be cloned.

    Figure 15-6 Middleware Provisioning (Gold Image): Destination

    Middleware Provisioning (Gold Image): Destination
  6. Click Add Hosts and select a host from the list.

  7. In the Select Destination Locations section, specify the location of the Middleware Home on the Host machine. The Create a New Middleware Home option is selected by default.

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

  9. In the Working Directory field, specify the directory on the destination Host on which the cloning related files are temporarily stored. This directory must have sufficient space to store the files. If this directory is not present, it will be created. When the cloning operation has been completed, the directory and its contents will be deleted.

  10. In the JDK Home Location field, enter the absolute path to the JDK directory to be used on the destination Host. This field can be edited only if the JDK Home in the source domain is in an external location. If the JDK Home in the source domain is internal and installed in the Middleware Home, this field cannot be edited.

    Note:

    If there are several destination hosts, the location of the Middleware Home, Working Directory, and JDK Home Location is the same across all the hosts.
  11. In the Middleware Provisioning: Credentials page, specify the credentials for the destination host. They can be:

    • Preferred Credentials: 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 Cloud Control.

    • Named Credentials: The credentials of a named profile stored in the Management Repository is used. To use the Named Credentials stored in the Management Repository, you must have already registered each of the preferred credential types with a unique name. Select the desired Named credential from the list available in Credential Name. If you have created all necessary named credentials, you can use them now. If they have not been created, you can create them using this deployment procedure.

  12. In the Schedule page, specify a Deployment Instance name. If you want to run the procedure immediately, then retain the default selection, that is, One Time (Immediately). If you want to run the procedure later, then select One Time (Later) and provide time zone, start date, and start time details. You can set the notification preferences according to deployment procedure status. If you want to run only prerequisites, you can select Pause the procedure after the necessary prerequisite checks have been completed to pause the procedure execution after all prerequisite checks are performed. Click Next.

  13. 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.

  14. In the Procedure Activity page, view the status of the execution of the job and steps in the deployment procedure. Click the Status link for each step to view the details of the execution of each step. You can click Debug to set the logging level to Debug and click Stop to stop the procedure execution.

15.1.2.2 Creating an Oracle Middleware Home Gold Image

You can create an Oracle Middleware Home Gold Image and save it in the Software Library. You can then use this gold image as the source for future Middleware Home installations.

Prerequisites

  • The Management Agent must be running on the Administration Server.

  • You must have the host credentials for the Administration Server running on the source machine.

  • The disk space required to create a gold image is calculated as follows:

    Disk Space = Middleware Home Size + Space for Temporary Scripts

  1. From the Enterprise menu, select Provisioning and Patching, then select Software Library.

  2. From the Actions menu, click Create Folder to create a folder in which the gold image you are creating is to be stored. We recommend that you do not use an out-of-box folder to store the gold image.

  3. Select the folder you have created and from the Actions menu, select Create Entity, then select Component.

  4. A Create Component popup window appears. From the Select Subtype drop-down list, select the Oracle Middleware Home Gold Image component and click Continue.

  5. In the Describe page, the Parent Directory under which the gold image will be created and the Subtype are displayed. Enter a name and description for the profile and enter the values for the Product Version, Product, and Vendor attributes. For example, enter the Product Version as 10.3.6, Product as Middleware Home, and Vendor as Oracle.

  6. Click Next. Create Oracle Middleware Home Gold Image: Configure page appears. Click the Search icon next to the Middleware Home field and select an existing Middleware Home from which the gold image is to be created.

    Figure 15-7 Create Oracle Middleware Home Gold Image: Configure

    Create Oracle Middleware Home Gold Image: Configure
  7. In the Working Directory field, specify the directory on the destination Host on which the files required for creating the gold image are temporarily stored. If this directory is not present, it will be created. When the gold image has been created, the contents of this directory will be deleted.

  8. In the Host Credentials section, enter the host credentials of the machine on which the Middleware Home is located. Select one of the following options:

    • Preferred Credentials: 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.

    • Named Credentials: The credentials stored in the Management Repository is used. To use the Named Credentials stored in the Management Repository, you must have already registered each of the preferred credential types with a unique name. Select the desired Named credential from the list available in Credential Name.

  9. Click Next. In the Review page, you can review the information and click Save and Upload.

  10. The Job Name is displayed at the top of the page. Navigate to the Job Activity page and check the job status. Once it has been completed, navigate to the Software Library page and confirm if all the components of the gold image have a Ready Status. You can now use this gold image for future cloning operations.

15.1.3 Configuring and Saving the Deployment Procedure

Note:

Oracle recommends that the WebLogic Domain Provisioning Profile is used instead of the Configured Deployment Procedure described in this section.

You can configure and save a Middleware Provisioning deployment procedure. This Configured Deployment Procedure can then be used by the EM_SSA_ADMINISTRATOR while creating a Middleware Service Template. To customize the deployment procedure, follow these steps:

  1. Log into Enterprise Manager as a user with EM_SSA_ADMINISTRATOR role.

  2. From the Enterprise menu, select Provisioning and Patching, then select Middleware Provisioning. The Middleware Provisioning page appears.

  3. The profiles that have been uploaded are listed in the Profile section. The profile you select must contain only one cluster with one WebLogic Server.

  4. Select the Provision Middleware Deployment Procedure from the Deployment Procedures region and click Launch.

  5. Select Provision from WebLogic Domain Provisioning Profile option. Click the Search icon and select one of the profiles as the image to use for the oracle home.

  6. Enter a name for the customized deployment procedure and click Save.

    The MWaaS feature will not work if any variables in the deployment procedure are locked.

  7. After the deployment procedure has been saved, click Cancel to exit the current deployment procedure. You will see the new customized deployment procedure listed in the Deployment Procedures table in the Middleware Provisioning page. The saved deployment procedure can now be used while creating a service template.

    Note:

    The Configured Deployment Procedure you have created must contain only one cluster with one or more WebLogic Servers.

15.2 Getting Started with MWaaS - Virtual Flow

This section helps you get started by providing an overview of the steps involved in setting up the Middleware as a Service (MWaaS) and provision a service instance on one or more Oracle VM Zones. Before you set up MWaaS, you must download and deploy the required plug-ins. For more details, see Section 3.3, "Deploying the Required Plug-ins".

Note:

MWaaS (Virtual Flow) can be used only with Oracle VM Servers. Third party virtualization technology is not supported.

Table 15-2 Getting Started with MWaaS (Virtual Flow)

Step Task Role

1

Define roles for administrators and self service users. See Section 3.4, "Defining Roles and Assigning Users".

Super Administrator

2

Optionally, you may need to configure Privilege Delegation Settings on your managed hosts. Section 3.6, "Configuring Privilege Delegation Settings".

Super Administrator

3

Configure the storage location for the Software Library. See Section 3.1, "Setting Up the Software Library"

Cloud Administrator

4

Register Oracle VM Manager. See Section 4.3, "Registering the Oracle VM Manager".

Cloud Administrator

5

Discover Virtual Servers. See Section 4.5, "Discovering a Virtual Server".

Cloud Administrator

6

Register Storage Servers. See Section 4.9, "Registering Storage Servers".

Cloud Administrator

7

Configure Networks. See Section 4.7, "Setting Up Networks".

Cloud Administrator

8

Create Virtual Server Pool. See Section 4.14, "Creating a Virtual Server Pool".

Cloud Administrator

9

Create Oracle VM Zone. See Section 4.15, "Creating a Zone"

Cloud Administrator

10

Create a PaaS Infrastructure Zone. See Section 9.3, "Creating a PaaS Infrastructure Zone".

Cloud Administrator

11

Deploy an Oracle Virtual Assembly (ova) and create a Deployment Plan. See Section 8.8.4, "Provisioning Guest Virtual Machines Using Oracle Virtual Assemblies (OVA)".

For more information on assemblies, see the Oracle Virtual Assembly Builder page http://www.oracle.com/technetwork/middleware/ovab/overview/index.html on the Oracle Technology Network.

For instructions on building assemblies, see the Oracle Virtual Assembly Builder Installation Guide.

Self Service Administrator


Figure 15-8 shows the sequence of steps required to enable middleware as a service (virtual hosts).

Figure 15-8 Getting Started with MWaaS (Virtual Flow)

Getting Started with MWaaS (Virtual Hosts)

After you followed the steps listed in Figure 15-8, do the following: