Skip Headers
Oracle® Enterprise Manager Cloud Administration Guide
12c Release 4 (12.1.0.4)

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

20 Using the MWaaS Self Service Portal

This chapter provides Self Service Application users with instructions on using the MWaaS Self Service Portal to request and monitor middleware services. It contains the following sections:

20.1 Using the MWaaS Self Service Portal

The Middleware Self Service Portal allows users with the EM_SSA_USER role to view, monitor, and request middleware services. Users with the EM_SSA_USER role can request middleware services using any of the predefined service templates. They can deploy, undeploy applications, create data sources, scale up, and scale down services with minimal or zero intervention by the EM_SSA_ADMINISTRATOR user.

Prerequisites

Only users who have been granted the MWAAS_ACCESS privilege can access the Middleware Self Service Portal. By default, the out-of-the-box EM_SSA_USER role has this privilege. But, the EM_SSA_USER_BASE role does not have this privilege and it must be explicitly granted to users with this role.

To view the MWaaS Self Service Portal, follow these steps:

  1. Log into Enterprise Manager as a user with the EM_SSA_USER role.

  2. Select Middleware from the Manage drop down list. The Middleware Cloud Self Service Portal appears.

    Figure 20-1 Middleware Cloud Self Service Portal

    Middleware Cloud Self Service Portal
  3. This page contains the following tabs:

    • Home: The Home tab contains the following regions:

      • Notifications: This region shows the number of services that are due to expire in the next 7 days and the number of the services templates published within the last 7 days.

      • Usage: The total quota (servers and memory) used so far, including all the services that the user has created.

      • Middleware Services: This region shows the list of services owned by the SSA user. For each service, the status, the zone being used by the service, the creation date, expiration date, and days until expiration are displayed.You can perform the following actions:

        To request a service, click Request Service. See Section 20.2, "Requesting a Service" for details. Click on the Name link to drill down to the Service Home page.

        You can view the service details by clicking on the Name link to drill down to the Middleware Service Home page. You can delete a service by selecting a service from the table and clicking Delete.

        You can select a service from the table and click Start or Stop to start or stop a service.

        You can set the end date for a service. Select a service from the table and click Set End Date. In the popup window that appears, you can specify a new End Date for the middleware service instance. If you do not want the service to expire, select Indefinitely and click OK.

      • My Requests: This region shows a list of Service Creation, Service Deletion, Start Service, Stop Service, Scale Up, and Scale Down requests. For each request, the status, type, start date, and submission date of the request is displayed. Select columns from the View menu to view more details about the request. You can select a scheduled request and click Reschedule to reschedule the request. You can select a scheduled request and click Cancel to delete the request. If a request that is scheduled such as Create gets canceled, all other associated requests are also canceled.

    • Chargeback: This tab displays all the chargeback break-up data for the service. The charge incurred will be calculated from the service requested date to current date. This page contains the following regions:

      • Charge Trend: This graph show the usage and charge trends over time.

      • Details: You can aggregate the chargeback data for the service by resources of metrics. You can export this data to an external application such as a spreadsheet.

      • Charge Plans: The charge plans that have been assigned to each PaaS Infrastructure Zone are displayed. Select a zone to view the pricing. The rate for each metric in the zone for a specific time period is displayed.

      For details on setting up the Chargeback Service, see Chapter 27, "Chargeback Administration".

    • Library: This tab displays a list of Java EE application components that are available to the SSA user. You can do the following:

      • Upload: You can upload a new Java EE application component to the Software Library. See Section 20.4, "Uploading a Java EE Component to the Software Library" for details.

      • Delete: Select a Java EE component from the list and click Delete to remove it from the library.

      • Share / Stop Sharing: You can share a component with one or more users and roles. Select the component and click Share. The Select and Share: Users and Roles window appears. From the Type drop list, select User or Role and click Search. The users or roles with which the component can be shared. Select one or more users or roles and click Share. The selected component is shared with the specified users and roles. To stop sharing the component, select the component and click Stop Sharing.

    • Policies: Click the Policies tab to view the list of policies that you have defined. You can create a new Performance or Schedule Based Policy or a Policy Group for one or more middleware services and define Scale Up or Scale Down on these policies. See Section 20.1.1, "Defining Dynamic Elasticity Policies for Middleware Services".

    • My Preferences: Click the My Preferences link to set up your preferences such as the Default Service Type, Default Email Address for Notifications, Default Locale, Default PaaS Infrastructure Zone, and so on. To set the Middleware Cloud Self Service Portal as the default page that appears when you log in to the Self Service Portal, select Middleware in the Default Service Type drop down list and click Apply. For more details on setting the preferences, see Section 8.9, "Viewing My Preferences".

      Figure 20-2 My Preferences (Middleware)

      My Preferences (Middleware)

20.1.1 Defining Dynamic Elasticity Policies for Middleware Services

To define a policy, follow these steps:

  1. Log into Enterprise Manager as a user the EM_SSA_USER role.

  2. Click the Policies tab. The following page appears.

    Figure 20-3 Policies Tab

    Surrounding text describes Figure 20-3 .
  3. To create a policy, from the Create menu, you can select either of the following:

    • Schedule Based Policy

    • Performance Based Policy

20.1.1.1 Creating a MWaaS Schedule Policy

For instance, if you want to create a schedule based policy that states that a middleware service must be scaled up every Monday, follow these steps:

  1. From the Create menu, select Schedule Policy. The following page appears:

    Figure 20-4 Create Schedule Policy

    Surrounding text describes Figure 20-4 .
  2. Enter a name and description for the policy.

  3. In the Policy Action field, select Scale Up and enter 2 as the Value in the Action Parameters field.

  4. In the Start field, specify the date from which this policy must be effective.

  5. In the Repeat field, select Specify Days of the Week and in the Days of the Week field, select Monday. Thus the service will be scaled up by 2 every Monday.

  6. Click OK to create the policy. You will return to the Policies page where the policy you have defined will appear in the Policies table. To apply these policy for a target, click Add in the Associations region and select a target with which this policy must be associated.

20.1.1.2 Defining a MWaaS Performance Policy

Performance policies are formed based on the performance metrics of a specific target type and its associated targets. You can create conditions and rules for the policy based on the metrics. To define a performance policy, follow these steps:

  1. Click the Policies tab in the Middleware Self Service Portal. The Policy page appears.

  2. Click Create and select the Performance Policy type.

  3. In the General Information page, enter the name and description of the policy.

  4. In the Rules and Relationships page, select a metric from the right panel and click Add to Definition. Specify the condition, value, and number of occurences.When these conditions are met, the policy is executed.

  5. Click Next. The Create Performance Policy: Rules page appears. The policy rule is displayed.

  6. Select Scale Up or Scale Down from the Action drop down list.

  7. In the Action Parameters field, enter a value next to the Number of Java Servers. The value specified here is used to either increment or decrement the Number of Java Servers depending on the Action selected.

  8. Click Next. The Create Performance Policy: Review page appears. Review the policy details and click Save the policy and return to the Middleware Service Portal: Policies page.

  9. In the Associations region, click Add and select one or more targets to be associated with this policy. The associated targets are listed in the Associations region.

    Click on the target link to view a list of policies associated with the target. Once the targets have been associated, the policy is activated. Click View History to view the policy action history.

20.2 Requesting a Service

You can request a new middleware service on this page. To request a service, follow these steps:

  1. Click Request Service in the Home page of the Middleware Cloud Self Service Portal.

  2. The Select Service Template window appears. A list of service templates available in the zones the SSA user can access is displayed. Choose a service template and click Select to launch the New Service Request page.

    Figure 20-5 New Service Request

    Surrounding text describes Figure 20-5 .
  3. Enter a name for the service and select the PaaS Infrastructure Zone in which the new service is to be deployed.

  4. If the service template you have selected is based on a profile that contains a cluster with one or more WebLogic servers, in the Number of Java Servers field, specify the initial number of servers that can be present in the new service instance.

    Note:

    The Number of Java Servers you specify here cannot be lesser than the number of servers specified in the profile.
  5. Specify the schedule for the service request.

    • Start Date: You can choose Immediately (request is executed immediately) or Later. If you select the Later option, specify the date from which the service is to be available.

    • End Date: Select Indefinitely to make the service available for a indefinite period of time. If you select Until, specify the date on which will be deleted and no longer available.

  6. In the Create WebLogic User Account (optional) region, you can optionally specify a WebLogic user account to be created on your service after it is provisioned. Enter the WebLogic User Name and WebLogic Password. You will be able to access the WebLogic Server Administration Console using the user name and password specified here.

    Note:

    The Create WebLogic User Account will appear only if the Expose WebLogic Admin Console and Fusion Middleware Control to SSA User field was set to Yes by the EM_SSA_ADMINISTRATOR when the service template was created.
  7. In the Deploy Application region, you can optionally choose to deploy an application to the new service being created. Enter the following details:

    • Application Name: Enter a name for the application that is to be deployed.

    • Application Component: You can choose to:

      • Select an application component from the Software Library: Click the Search icon and select a Java EE application component from the Software Library.

      • Select an application archive from your desktop. Click Browse and select an application archive from your desktop.

    • Deploy as an application: The deployment can be created as a normal application or as a library. If you select this option, click Browse in the Deployment Plan field and select a .xml file that contains the deployment options. This file overrides the deployment plan (if any) specified with the application component.

    • Deploy as a library: You can deploy the application as a library. Libraries are deployments that can be shared by other deployments. Libraries should be available on all of the targets running their referencing applications.

  8. Click Submit to create the service request. This request will now appear in the My Requests table in the Home page of the Middleware Self Service Portal. You can monitor the status of this request in this table. When the request has been completed, you can refresh the page to view the new service in the Services table.

20.3 Viewing the Middleware Service Home Page

The Middleware Service Home page provides detailed information about the services you have requested using the Request Service option. To view the Middleware Service Home page, click the Name link in the Middleware Services region in the Middleware Cloud Self Service Portal: Home tab.

Figure 20-6 Middleware Service Home

Middleware Service Home Page

This page contains the following regions:

  • Performance Summary: Shows the availability status of the service, status summary of the Java Servers, and the performance metrics for the underlying WebLogic cluster associated with this service. This page can be customized with different metrics by clicking the wheel button on the right corner of the region.The following charts are displayed.

    • Availability: The availability status of the service.

    • Resource Usage: Shows the CPU and Heap Usage charts for all the servers in the cluster.

    • Response and Load: Shows the request processing time and number of requests per minute for the current service.

    • General: Shows charts for various performance metrics for the service.

  • Applications: Lists all the applications deployed to this service. For each application, the name, status, and the key metrics such as Active Sessions, Request Processing Time, and Request per Minute are displayed. Click the Name link to drill down to the Application Home page. You can do the following:

    • Deploy: Click Deploy to deploy the application to the service. See Section 20.3.1, "Deploying and Redeploying an Application" for details.

    • Delete: Select an application and click Delete to undeploy an application.

    • Redeploy: If you have an updated Java EE application component, you can select the application and click Redeploy to redeploy the application. See Section 20.3.1, "Deploying and Redeploying an Application" for details.

    • Start / Stop: Select an application and click Start or Stop to start or stop the application.

    • Test: Select an application and click the Test icon. A list of URLs is displayed in the Application URLs dialog box. Click the URL to navigate to the associated page.

  • Libraries: If any applications have been deployed as libraries, they are listed here.You can do the following:

    • Deploy: Click Deploy to deploy the application to the service. See Deploying an Application for details.

    • Delete: Select an application and click Delete to undeploy an application.

    • Redeploy: If you have an updated Java EE application component, you can select the application and click Redeploy to redeploy the application.

      Note:

      If you select a library that is being referenced by an application, the Redeploy and Delete buttons are disabled and this library cannot be deleted or redeployed.

    When deploying using the Self Service Portal you can create the deployment as a normal application or a library. Libraries are deployments that can be shared with other deployments. The Middleware Service home page shows normal applications in the Applications table and libraries in the Libraries table. Libraries may be deleted and redeployed, but only if they are not being referenced by any applications.

  • Data Sources: This region shows all the data sources that are available for this service. For each data source, the Name, Database Service Name, JNDI name and the URL for the database is displayed. If the data source has been created using a database service, the name is displayed in the Database Service column. Click on the name to drill down to the Database Service Home page. You can create new data sources, edit or delete existing data sources, and test the connection to any specified data source.

  • Requests: This table shows all the requests that have submitted for this service. These include requests such as Deploy, Undeploy, Redeploy, Scale Up, Scale Down, Start, Stop, Create, Edit, and Delete Data Source.

    The following options are available from the Middleware Service menu:

    • Set End Date: Select this option to specify an end date for the middleware service.

    • Start and Stop: You can start or stop the service by selecting the appropriate option from the Middleware Service menu.

    • Scale Up and Scale Down: See Section 20.3.2, "Scaling Up and Scaling Down a Service".

    • Policies: Select this option to create schedule or performance based policies. See Section 20.1.1, "Defining Dynamic Elasticity Policies for Middleware Services".

    • Select Metrics: Click Select Metrics to add new charts, remove existing ones, and drag and drop metrics to charts. In the Metric Palette window that appears, select a metric or drag and drop a metric into an existing chart or create a new chart. By default, all new charts are displayed in the General section but you can drag and drop them to a different section. You can remove a metric/chart by unchecking a box in the Metric Palette or by clicking the x on the drag bar on the right side of the chart. You can move charts within their section by dragging them by that bar.

    • Restore Default Charts: Click Restore Default Charts to restore the charts to the default settings. All chart additions, modifications and deletions are applicable to a specific service. An SSA user can have different charts for each service.

    • Log Messages: Click Log Messages to view a list of messages sorted by message type, date, and so on. Select the date range, message type, and specify other filters in the Message field. Click Add Fields, select other fields to be included in the message, and click Search. The first 1000 messages that meet the search criteria are displayed. Click Export Messages to File to export the messages to a log file in .txt, .xml, or .csv format.

    • WebLogic Server Administration Console: Click this option to launch the WebLogic Administration Console.

    • Fusion Middleware Control: Click this option to launch the Fusion Middleware Control console.

      Note:

      The WebLogic Server Administration Console and the Fusion Middleware Control interfaces allow you to manage and monitor the Oracle Fusion Middleware components. The WebLogic Server Administration Console and Fusion Middleware Control options are available in the Middleware Service menu only if the Expose WebLogic and FMW Console URLs to SSA User field has been set to 1 in the Middleware Service Template. See Section 19.6, "Creating a Middleware Service Template" for details.

20.3.1 Deploying and Redeploying an Application

You can deploy a preconfigured Java EE application to a Service Instance. To deploy an application, follow these steps:

  1. Log into Enterprise Manager as a user with the EM_SSA_USER role and navigate to the Middleware Cloud Self Service Portal page.

  2. Click on a Name link in the Middleware Services region. The Middleware Service Home page appears.

  3. Click Deploy in the Applications table. The Deploy Application page appears.

    Figure 20-7 Deploy Application

    Deploy Application Page
  4. Enter the following details:

    • Application Name: Enter a name for the application that is to be deployed.

    • Application Component: You can choose to:

      • Select an application component from the Software Library: Click the Search icon and select a Java EE application component from the Software Library.

      • Select an application archive from your desktop. Click Browse and select an application archive from your desktop.

    • Deploy as an application: The deployment can be created as a normal application or as a library. If you select this option, click Browse in the Deployment Plan field and select a .xml file that contains the deployment options. This file overrides the deployment plan (if any) specified with the application component.

    • Deploy as a library: You can deploy the application as a library. Libraries are deployments that can be shared by other deployments. Libraries should be available on all of the targets running their referencing applications.

      Note:

      If you have set the Expose WebLogic and FMW Console URLs to SSA User field to Yes while Creating a Service Template, you will prompted for the WebLogic Username and Password here.
  5. Specify when the deploy operation should occur and click Deploy. After the request to deploy the application has been created, you will return to the Middleware Service Home page where a confirmation message is displayed.

20.3.1.1 Redeploying an Application

You can redeploy an application that has been deployed to a Service Instance. To redeploy an application, select a deployed application from the Applications table and click Redeploy. In the Redeploy Application page, select the Application Component that is to be redeployed, the deployment plan if any, and click Redeploy. You will see a confirmation message indicating that the application has been redeployed.

20.3.1.2 Deleting an Application

You can delete (undeploy) an application that has been deployed. Select the application to be deleted from the Applications table and click Delete. A confirmation message is displayed. Click Yes to undeploy the application.

20.3.2 Scaling Up and Scaling Down a Service

You can scale up or scale down a service.

Note:

The Scale Up and Scale Down options are available only in the following scenarios:
  • The service is based on a middleware virtual service template and the Topology field in the Create Service Template: Configuration is set to 1. These options are not available if the Topology field is set to 0 (no cluster).

  • The service is based on a middleware physical service template that contains a middleware provisioning profile with one cluster. If the middleware provisioning profile does not contain a cluster, these options are not available.

On the Middleware Service Home page, select the following options from the Middleware Service menu:

  • Scale Up: You can scale up a service by adding one more servers. The number of servers you can add is limited by your quota. Click Scale Up and enter the number of servers by which the service is to be scaled up. Click Submit to submit the scale up request and add more servers.

  • Scale Down: Click Scale Down and enter the number of servers by which the service is to be scaled down. Click Submit to submit the scale down request and reduce the number of servers.

20.3.3 Creating a Data Source

In WebLogic Server, you configure database connectivity by adding data sources to your WebLogic domain. WebLogic JDBC data sources provide database access and database connection management. Before an application can access a database, it must be configured to use the JDBC data source.

To create a data source for a service, follow these steps:

  1. Log into Enterprise Manager as a user with the EM_SSA_USER role and navigate to the Middleware Cloud Self Service Portal page.

  2. Click Create in the Data Sources table in the Middleware Service Home page. The Create Data Source page appears.

    Figure 20-8 Create Data Source

    Creating a Data Source
  3. Enter the Data Source Name and the JNDI Name.

  4. Select the Database Driver Class.

  5. If you have a database service instance configured, you can select the Database Service and the corresponding URL is displayed. If not configured, you must manually enter the Database URL.

  6. Specify the Database User Name and Password.

  7. Click Create to create the data source.

20.3.3.1 Editing a Data Source

You can edit the properties of a data source. Click the Name link in the Data Sources table in the Middleware Service Home page. The Edit Data Source page appears. You can edit the properties of the data source. If some of the properties are changed, the data source needs to be redeployed and applications using this data source need to be restarted.

20.4 Uploading a Java EE Component to the Software Library

You can upload pre-configured ear, war, jar, or rar files to the Software Library. These files are uploaded to the Software Library as Java EE Application components, which are then deployed to your service. To upload a file to the Software Library, click the Library tab. The Upload to Software Library field appears.

Figure 20-9 Upload to Software Library

Upload to Software Library

Enter the name and description of the file being uploaded. You can then choose to upload files as follows:

  • Individual Files: If you choose the Upload Files Individually option, you need to specify the following:

    • Archive: Select the archive file to be uploaded to the Software Library. This can be an ear, war, jar, or rar file. You can also optionally specify the following:

      • Deployment Plan: This is an xml file containing the deployment options for the Java EE Application component.

      • Pre Deploy Script: This is a script containing WLST commands. The Management Agent runs this script on the Administration Server associated with each instance before the application is deployed. You can use this script to create data sources, JMS end points, and any other resources that might be needed by the application that is being deployed.

      • Post Deploy Script: This is a WLST script that is executed by Management Agent on the Administration Server after the application is deployed. You can use this script to perform any post deployment configuration. For example, if you need to roll back and undo the changes made by the pre deploy script, you can select this option.

  • Zip File: If you select the Upload Zip File option, you must upload a zip file that contains the JavaEEAppComp.manifest file that describes the contents of the zip file.

Click Upload to upload the file to the Software Library.

20.5 Viewing the Application Home Page

To view the Application Home page, select an application, and click the Name link in the Applications table on the Middleware Service Home page.

Figure 20-10 MWaaS Application Home

MWaaS Application Home Page

This page displays performance and availability for the application, along with a chart that shows response and load. You can redeploy, delete (undeploy), start, or stop the application using options from the Application menu.