Skip Headers
Oracle® Enterprise Manager Cloud Control Upgrade Guide
12c Release 1 (12.1.0.1)
E22625-09
  Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

10 Analyzing Your Environment

This chapter describes how you can analyze your existing Oracle Management Agents (Management Agent) and prepare yourself to upgrade them. In particular, this chapter covers the following:


Note:

Perform these steps in the Enterprise Manager Grid Control console of the earlier release.

Identifying Management Agents with Valid Inventory

Every Oracle software product, including Oracle Management Agent (Management Agent) installed on a host is registered with the central inventory (oraInventory). Every Oracle software product has an entry in the inventory.xml file, which is present in the oraInventory directory. If a Management Agent is registered with the central inventory, then it is a Management Agent with valid inventory.

To identify Management Agents with valid inventory, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, in the Agent Upgrade Status section, view the count displayed against Agents with Valid Inventory.

    To drill down and view more information about each of the Management Agents, click the count value.

    Enterprise Manager Grid Control displays the Upgrade Status page that provides information such as the platform on which the Management Agents are running; their versions; their old and new Oracle home locations; and their deployment, configuration, health check, and switch over status.


    Note:

    • The count displayed here does not include the Management Agents with invalid inventory and the Management Agents that were installed after the count was determined.

    • To consider the Management Agents that have an invalid inventory, first resolve the issue with such Management Agents. Ensure that there are no such faulty Management Agents. For information on how to identify such Management Agents and resolve them, see Identifying Management Agents with Invalid Inventory. Once you have resolved the issue, click Refresh Agents and Targets List.

    • To consider the Management Agents that were installed after the count was determined, refresh the list by clicking Refresh Agents and Targets List.


Identifying Management Agents with Invalid Inventory

Every Oracle software product, including Management Agent installed on a host is registered with the central inventory (oraInventory). Every Oracle software product has an entry in the inventory.xml file, which is present in the oraInventory directory.

However, there may be circumstances when an entry for a Management Agent might be missing, incomplete, or corrupt, or the entry might be existing with an incorrect syntax. In addition, there is also a possibility that the host configuration was not refreshed and the latest configuration was not collected. If a Management Agent is not registered with the central inventory for such reasons, then it is a Management Agent with invalid inventory.

Management Agents with invalid inventory do not appear in the Enterprise Manager 12c Upgrade Console, and as a result, you will not be able to upgrade them until the issues are fixed.

To identify Management Agents with invalid inventory, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, in the Agent Upgrade Status section, view the count displayed against Agents with Invalid Inventory.

    To drill down and view more information about each of the Management Agents, click the count value.


    Note:

    To resolve this issue, follow these steps:
    1. Check the entry for these Management Agents in the inventory.xml file.

      The inventory.xml file is present in the oraInventory directory (central inventory). The location the oraInventory directory is mentioned in the oraInst.loc file that you pass while invoking the installer in silent mode. Ensure that the entry is present with the correct syntax.

    2. Refresh the host configuration in one of the following ways:

      (a) Go to the home page of the host. Click the Configuration tab. On the Configuration page, click Refresh.

      (b) Go to the Deployments page. In the Configuration section, click Refresh Host Configuration.

      If Step 2 (a) or Step 2 (b) fail, then run the following command from the Management Agent home:

      $<AGENT_HOME>/bin/emctl control agent runCollection

    3. Refresh the agent list in the Enterprise Manager 12c Upgrade Console.

      Go to the upgrade console. In the Agent Upgrade Status section, click Refresh Agents and Targets List.


Checking the Upgradability Status of Oracle Management Agents

To check the upgradability status of the Management Agents, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, in the Preupgrade Steps section, from the table, click Manage Software.

  4. On the Manage Software page, view the Agent Upgradability pie chart. The pie chart graphically shows the following information:

    • Completely Upgradable - Number of Management Agents that can be fully upgraded because the Management Agent software and all the associated, target-specific management plug-in software are available.

    • Missing Plug-Ins Software - Number of Management Agents that can be partially upgraded because the Management Agent software and only a few of the associated, target-specific management plug-in software are available. Some management plug-in software are either missing or unsupported in the upgraded Enterprise Manager system.

    • Missing Agent Software - Number of Management Agents that cannot be upgraded because the Management Agent software is not available. The associated, target-specific management plug-in software might be available, but the core Management Agent software is not available.

    • Not Supported - Number of Management Agents that are not supported in the upgraded Enterprise Manager system because Oracle Management Agent 12c has not been released for a particular platform. The targets monitored by those Management Agents can no longer be monitored in the upgraded Enterprise Manager system.

Checking the Upgradability Status of Targets

To check the upgradability status of the targets, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, do one of the following:

    • In the Other Links section, click Targets Upgradability Status.

      On the Targets Upgradability Status page, use the search functionality to search and identify the targets that can either be monitored or not monitored in the upgraded Enterprise Manager system.

      For example, to list the targets that cannot be monitored in the upgraded Enterprise Manager system, from the Upgrade Status list, select Not Upgradable. Similarly, to list the target that can be monitored, select Upgradable.

    • In the Preupgrade Steps section, from the table, click Manage Software.

      On the Manage Software page, view the Target Upgradability pie chart. The pie chart graphically shows the following information:

      • Upgradable - Number of targets that can be monitored in the upgraded Enterprise Manager system because the Management Agent software and the associated, target-specific management plug-in software are available.

      • Missing Agent/Plug-In Software - Number of targets that cannot be monitored in the upgraded Enterprise Manager system because either the Management Agent software is missing or the associated management plug-in software is missing.

      • Not Supported - Number of targets that cannot be monitored in the upgraded Enterprise Manager system because either Oracle Management Agent 12c has not been released for the platforms on which the targets are running, or the management plug-ins for those targets are not supported in the upgraded Enterprise Manager system.

      • Plug-In Software Not Certified - Number of targets that cannot be monitored in the upgraded Enterprise Manager system because the management plug-ins for those targets are not certified.

Identifying Problematic Oracle Management Agents

There may be Management Agents that cannot be upgraded due to technical issues such as missing host target, association with multiple host targets, unreachable state, invalid inventory, and so on.

To identify such problematic Management Agents, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, in the Other Links section, click Problematic Agents.

  4. On the Problematic Agents page, view the Management Agents that cannot be upgraded.

    • To search for a particular Management Agent, enter the Management Agent name in the Agent Name field, and click Search.

    • To filter the Management Agents based on a particular technical reason, select one of the following reasons from the Reason list, and click Search:

      • Missing Repository Inventory - Lists the Management Agents that are not registered with the central inventory (oraInventory).

      • Multiple Host Target - Lists the Management Agents that are either associated with or monitoring more than one host.

      • Agent Unreachable - Lists the Management Agents that are down.

      • Host Target Missing - Lists the Management Agents whose hosts are not discovered and monitored in the Enterprise Manager Grid Control console. The Management Agents themselves may be monitored but their hosts may not be monitored for some reason.

      • All - Lists all the Management Agents that have one or more issues listed in the Reason list.

Identifying Management Agents That Need to Be Reconfigured

You might have to reconfigure the Management Agents for one of the following reasons:

To identify the Management Agents that need to be reconfigured, follow these steps:

  1. In Grid Control, click Deployments.

  2. On the Deployments page, in the Upgrade section, click Enterprise Manager 12c Upgrade Console.

  3. On the Upgrade Console page, in the Other Links section, click Agents Needing Reconfiguration.

  4. On the Agents Needing Reconfiguration page, view the Management Agents that need to be reconfigured. The table not only lists the Management Agents but also provides the following reasons for you to reconfigure them.

    • OMS Host and Port Mismatch

      Indicates that the OMS host and port with which you deployed the Management Agent do not match with the OMS host and port with which you deployed the other Management Agents. To resolve this issue, access the Identify Host and Port for New Enterprise Manager System page, correct the OMS host and port, and deploy this Management Agent again.

    • Targets Deleted or Added

      Indicates that you have either deleted one or more targets monitored by this Management Agent, or added new targets to be monitored by this Management Agent. To resolve this issue, reconfigure this Management Agent so that the new configuration can take effect.

    • Plug-In Version Mismatch

      Indicates that the versions of the plug-ins you deployed with this Management Agent are different from the versions of the plug-ins you deployed with the other Management Agents. To resolve this issue, deploy this Management Agent again with the correct plug-in versions.