Skip Headers
Oracle® Enterprise Manager Cloud Control Basic Installation Guide
12c Release 1 (12.1.0.1)
E22624-12
  Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

9 Installing Application Dependency and Performance

This chapter describes how you can install Application Dependency and Performance (ADP) in the Enterprise Manager Cloud Control environment.

In particular, this chapter covers the following:

Overview

Application Dependency and Performance (ADP) is one of the critical functionalities in Enterprise Manager Cloud Control that allows you to analyze Java EE, SOA, Portal, OSB, and ADF applications. It captures the complex relationships among various application building blocks in its application schema model - the core of the Oracle intelligent platform.

Therefore, to manage applications effectively, gain an understanding of the complex relationships among the business functions, associated interconnected components, and the underlying runtime environments, you must deploy Application Dependency and Performance (ADP) Manager application, and monitor them by installing the corresponding ADP agents.

To install ADP, use the Middleware Diagnostics page that is accessible from within Enterprise Manager Cloud Control console. To access the page, from Setup menu, select Middleware Diagnostics.

Figure 9-1 Middleware Diagnostics

Surrounding text describes Figure 9-1 .

The Middleware Diagnostics Page is a GUI based screen that enables you to deploy ADP Manager, and monitor the health of the ADP Manager application in a reliable and an efficient manner.

Using Middleware Diagnostics Page, you can achieve the following:

Before you Begin

Before you begin installing Application Dependency and Performance, keep these points in mind.

For ADP Manager:

For ADP Agent:

Prerequisites

Ensure that you meet the following prerequisites:

Installation Procedure

This section contains the following topics:

Deploying ADP Manager on the Same Host as OMS

To deploy ADP Manager on the same host as OMS, automatically creating a managed server, you must log in to Enterprise Manager Cloud Control with Super Administrator privilieges (SYSMAN), and perform the following steps:

  1. In Cloud Control, from Setup menu, select Middleware Diagnostics.

  2. On the Middleware Diagnostics page, click Deploy ADP Manager.

    The ADP Manager deployment page appears.

    Deploying ADP Manager on the same host as OMS
  3. On the Deploy ADP Manager page, select Create a managed server, and enter the following details:

    • Select an OMS Server from the Host list. The list comprises of all the servers discovered in Enterprise Manager WebLogic domain.

      For example, host1.example.com (EMGC_OMS1),host2.example.com (EMGC_OMS2), and so on.

    • Enter a unique Managed Server Name.

      For example, EMGC_ADPMANAGER1, EMGC_ADPMANAGER2,and so on.

    • The Port numbers for Listen Port, SSL Listen Port, ADP Manager Registry Port, ADP Manager Java Provider Port, and ADP Manager Controller Port are populated with the default values 4200, 4201, 51099, 55003, and 55000 respectively. You can change these values if required.

      Note: ADP Manager registry port enables communication between ADP Manager and ADP Agent.

  4. Depending on the host selected in the previous step, you are prompted for the credentials, as follows:

    • If you select the same host as the Administration Server (EMGC_OMS1), then you must provide the Oracle WebLogic Administration Server Host Credentials and Oracle WebLogic Domain Credentials.

    • If you select a different host (EMGC_OMS2) from the Administration Server, then in addition to Oracle WebLogic Administration Server Host Credentials and Oracle WebLogic Domain Credentials, you must also provide Oracle WebLogic Managed Server Host Credentials

    Where,

    Oracle WebLogic Administration Server Host Credentials are credentials for the host where the WebLogic Administration Server is running.

    Oracle WebLogic Domain Credentials are credentials of the Weblogic domain in the Enterprise Manager Cloud Control.

    Oracle WebLogic Managed Server Host Credentials are the credentials of the host machine where the Managed Server is running.

    For more information about credentials, see Selecting Credentials.

  5. Click Deploy to submit the job.

    The ADP Deployment Status page appears with a link to the job status. Click the link to see the status of the job that you submitted.

Deploying ADP Agents

To deploy ADP Agents to a WebLogic Server, perform the following steps:

  1. In Cloud Control, from the Targets menu, select Middleware.

    The Middleware page displays a list of all the Middleware targets discovered and managed in Cloud Control. Click target name to select the desired target.

  2. On the Middleware page, click Oracle WebLogic Domain. Ensure that the selected domain is not an Enterprise Manager Cloud Control domain (EMGC_DOMAIN).


    Note:

    ADP Agent cannot be deployed on a managed server (WebLogic Server) present in the Enterprise Manager domain.

    All the managed server present in the domain appear on the domain home page.

  3. From the WebLogic Domain menu, select Diagnostics, and then click Setup Diagnostics Agents to deploy agents to the selected managed servers.

  4. On the Deploy Diagnostics Agents page, choose the Oracle WebLogic Server (managed server) to which you want to deploy the ADP agents.

    Figure 9-2 Deploy Diagnostics Agents

    Surrounding text describes Figure 9-2 .

    Ensure that you retain the selection of only those Diagnostic Agent(s) that you want to deploy to each of the managed server, deselect the others.

    By default, the following servers appear deselected:

    • The Administration server is not selected by default.

    • All the managed servers that are not up and running appear deselected by default.

    • If the Deployed Version and the Version to Deploy are the same, and the status of already deployed ADP agent is up and running.


    Note:

    In Addition to the managed server selected, the ADP Agent is deployed to the Administration Server of the selected domain.

  5. In the Diagnostics Agent Configuration section, enter the ADP Configuration Properties for the selected agents:

    • Select the desired ADP Manager from the ADP Manager list.

      The ADP agents selected for deployment will report to the selected ADP Manager.

    • If you select the Update Remote Start configuration option, then some configuration scripts run in the background to facilitate the monitoring process. Select this option if you use node manager to stop or start the WebLogic Servers to which ADP agent is being deployed.

      For more information about the NodeManager, see Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.

  6. If the version of the WebLogic Server is greater than 9.2.X, and if the Management Agent is used to discover the monitored WebLogic domain which is not JRF enabled, then an Additional Configuration section appears.

    In the WebLogic Home field, enter the absolute path to the WebLogic home of the monitored domain.

    If the WebLogic Middleware Home field appears, then enter the absolute path to the WebLogic Middleware Home of the monitored domain.

  7. In the Credentials section, provide Oracle WebLogic Administration Server Host Credentials , Oracle WebLogic Domain Credentials, Oracle Enterprise Manager WebLogic Administration Server Host Credentials, and Oracle Enterprise Manager WebLogic Domain Credentials.

    Where,

    Oracle WebLogic Administration Server Host Credentials are credentials for the host where the WebLogic Administration Server is running.

    Oracle WebLogic Domain Credentials are credentials of the monitored Weblogic domain in the Enterprise Manager Cloud Control.

    Oracle Enterprise Manager WebLogic Administration Server Host Credentials are required to access the host where the WebLogic administration server for the Cloud Control domain is running.

    Oracle Enterprise Manager WebLogic Domain Credentials are required to access the Enterprise Manager Cloud Control domain.

    For more information about selecting credentials, see Selecting Credentials.

  8. Click Deploy to submit the job. A Diagnostics Agent Deployment status page appears:

    Surrounding text describes agent_output.gif.

    The status page appears with a link to the job status. Click the link to see the status of the job that you submitted.


    Note:

    Restart the administration server and the managed servers to which the ADP Agents have been deployed. These servers should be restarted only after the deployment has completed successfully.

After You Install

This section contains the following details:

Verifying ADP Manager Installation

Once you have deployed ADP Manager, you can perform the following sanity checks to verify if the ADP manager has been installed accurately on the managed server:

  • In Cloud Control, from Setup menu, click Middleware Diagnostics. On the Middleware Diagnostics page, the newly deployed JVMD Manager must appear and its status must be up and running.

  • In Cloud Control, from the Targets menu, select Middleware, from Middleware Features, click Application Dependency and Performance. On the ADP home page, in the Registration tab, the managed server on which the ADP Manager is deployed must appear. Select the manager name and click Test Connect to ensure that the manger is up and running.

Verifying ADP Agent Installation

Once you have deployed ADP Agent, you can perform the following steps to verify if the ADP Agent is installed on the targeted manager servers accurately:

  1. In Cloud Control, from Targets menu, select Middleware.

  2. On the Middleware page, from Middleware Features, click Application Dependency and Performance.

  3. On the Monitoring tab, expand the folder corresponding to the ADP Manager associated with the deployed agents.

  4.  Select the Status node in the navigation tree, and click the node, do not expand it. Verify the Agent Information table for the servers that you deployed to.


    Note:

    If you have not restarted the monitored servers, then the EJB Deployed status should be true, and the Agent Installed status should be false.

    Once you restart the monitored servers, the Agent Status for those servers should be REPORTING.