Oracle Enterprise Manager Ops Center includes the OCDoctor utility, a tool that can check systems for installation prerequisites, troubleshoot issues, and tune systems for Oracle Enterprise Manager Ops Center.
This chapter discusses the use of the OCDoctor.
This chapter includes the following sections:
The OCDoctor is a tool that can provide a variety of information about Oracle Enterprise Manager Ops Center and current or potential Enterprise Controller, Proxy Controller, and Agent Controller systems.
The OCDoctor is located in the /var/opt/sun/xvm/OCDoctor
directory on the Enterprise Controller system. You can copy the OCDoctor to other systems or download it from Oracle. Once you have copied it onto a system, you can perform preinstallation checks, troubleshoot issues, and check for OCDoctor updates.
You require specific roles to perform OCDoctor tasks in Oracle Enterprise Manager Ops Center.
The following table lists the tasks and the role required to complete the task. Contact your administrator if you do not have the necessary role or privilege to complete a task.
Table 6-1 OCDoctor Tasks and Roles
Task | Role |
---|---|
Preinstallation checks, troubleshoot and tuning, Update OCDoctor, and determine the number of access points |
Ops Center Admin |
You can perform various OCDoctor operations using Oracle Enterprise Manager Ops Center.
Using Oracle Enterprise Manager Ops Center, you can perform the following tasks:
Download the OCDoctor
Perform preinstallation checks
Perform troubleshooting and tuning
Update the OCDoctor
Cleanup Through OCDoctor
Determine the number of asset access points
In the Oracle Enterprise Manager Ops Center user interface, you can find OCDoctor information in different locations.
Table 6-2 Location of OCDoctor Information in the UI
To See | Location |
---|---|
To view the OCDoctor subsystem properties |
Expand Administration in the Navigation pane and select a Enterprise Controller. Select Configuration in the center pane. Select OCDoctor from the Subsystem drop-down. |
If you are operating in disconnected mode, or if you want to install the latest version of the OCDoctor on a new system, you can download the latest version from Oracle.
Follow this procedure to download the OCDoctor.
You can use the OCDoctor to verify that systems meet the prerequisites for an Oracle Enterprise Manager Ops Center installation, get a benchmark score, or check the system's connectivity.
Follow this procedure to perform the preinstallation checks.
The OCDoctor can help you troubleshoot issues and tune systems.
Follow this procedure to troubleshoot issues and tune systems.
The OCDoctor can locate and download updates if it is on an Internet-facing system. The Enterprise Controller performs this update automatically. You can also perform this update manually.
This procedure describes the steps to update the OCDoctor.
To free up the disk space, you can use the OCDoctor cleanup feature with OCDoctor 4.54 version.
The ./OCDoctor.sh --cleanup
script is used to scan the Enterprise Controller, Proxy Controller, and Agent Controller traces of Oracle Enterprise Manager Ops Center that can be safely removed to free up the disk space.
For example:
# /var/opt/sun/xvm/OCDoctor/OCDoctor.sh --cleanup Cleaning up Ops Center Enterprise Controller Version 12.3.0.1407 List of files/directories to get removed / cleaned up: /var/opt/sun/xvm/EnterpriseController_installer_12.2.0.2663 /var/opt/sun/xvm/update-saved-state/update_EC_minor_bundle_12.2.2.1103 ... /var/opt/sun/xvm/images/agent/OpsCenterAgent.Solaris.sparc.12.2.0.2663.zip /var/opt/sun/xvm/images/agent/OpsCenterAgent.Solaris.sparc.12.2.0.2663.zip.sig /var/opt/sun/xvm/images/agent/OpsCenterAgent.SolarisIPS.all.12.2.0.2663.zip /var/opt/sun/xvm/images/agent/OpsCenterAgent.SolarisIPS.all.12.2.0.2663.zip.sig Total size of files/directories = 32774052 KB / 32005.9 MB / 31.3 GB Ensure that there is no OS Provisisoning Job running using this Proxy Controller right now! Please review the list and press <ENTER> to continue or ^C to abort ... Deleting items, please be patience ............................. done Note: In case of further Boot Environments, you may not see any increase in free disk space until the other BEs got destroyed!
An access point is a connection between a managed asset and the Enterprise Controller through a Proxy Controller. The number of access points for the Enterprise Controller and for each Proxy Controller provides more accurate scaling information than the number of assets.
A single managed asset can have one or more access points, depending on how many Proxy Controllers are managing it. For example, if an Oracle VM Server for SPARC control domain's operating system is managed by one Proxy Controller while a hosted logical domain's operating system is managed by another Proxy Controller, the Enterprise Controller has two access points for that asset.
The OCDoctor utility includes a script, AssetCount.sh
, that you can run on the Enterprise Controller to get the current access point count for the Enterprise Controller and each Proxy Controller, including a breakdown of the type of assets on each Proxy Controller.
When the OCDoctor utility is run with the --troubleshoot
option, it performs an access point count. If the results of this count indicate that the Enterprise Controller or Proxy Controllers are approaching or beyond the maximum recommended number of assets, the output will include a warning.
When you run the ./OCDoctor.sh --collectlogs
command on the Enterprise Controller, the current access point count is included in the output. The current access point count can be useful when troubleshooting an issue.
Note:
Starting from 12.3.1 version, you can view the access point count for the Enterprise Controller and the Proxy Controllers in the user interface. For more information, see Viewing and Removing Access Points.
The following methods can be used to view the access point count:
You can view the total number of access points managed by the Enterprise Controller, as well as a categorized count of the access points managed by each Proxy Controller.
Run the following command on the Enterprise Controller:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh standard
For example:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh standard EC 72 Proxy Assets Zones Ldoms OVMGuests Servers Storages Switches ExadataCells MSeriesChassis MSeriesD ------------------------------------------------------------------------------------------------- pc4 32 5 25 0 2 0 0 0 0 0 pc1 28 0 26 0 2 0 0 0 0 0 pc0 12 2 4 0 6 0 0 0 0 0 Use option '-v' to see additional notes on the counting algorithm.
You can view a list of the access points of each type that are managed by each Proxy Controller.
The output first provides the total number of access points on the Enterprise Controller, then for each Proxy Controller provides the total number of access points, the number of access points of each type, and the user-friendly name for each asset.
The output for this command can be very long in a large environment.
Run the following command on the Enterprise Controller:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh machine
For example:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh machine EC 72 Proxy 32 pc4 Zones 5 S11zone101 S11zone102 S11zone100 S11zone103 S11zone104 Ldoms 25 stdldom21 stdldom34 stdldom36 stdldom22 stdldom45 stdldom47 ... OVMGuests 0 Servers 2 10.187.70.169 pc4 ... Proxy 28 pc1 Zones 0 Ldoms 26 stdldom21 stdldom34 stdldom36 stdldom22 stdldom45 stdldom47 ... OVMGuests 0 Servers 2 10.187.70.171 pc1
You can view a count of the access points for each Proxy Controller in three categories: Agent Controllers, Agentless assets, and service processors.
Run the following command on the Enterprise Controller:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh agent
For example:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh agent EC 72 Proxy Agents Agentless SPs -------------------------- pc4 25 2 0 pc1 1 1 0 pc0 5 5 5 Use option '-v' to see additional notes on the counting algorithm.
You can view all access point data, including the results of the standard
, machine
, and agent
options.
Run the following command on the Enterprise Controller:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh all
For example:
# /var/opt/sun/xvm/OCDoctor/toolbox/AssetCount.sh all EC 72 Proxy Assets Zones Ldoms OVMGuests Servers Storages Switches ExadataCells MSeriesChassis MSeriesD ------------------------------------------------------------------------------------------------- pc4 32 5 25 0 2 0 0 0 0 0 pc1 28 0 26 0 2 0 0 0 0 0 pc0 12 2 4 0 6 0 0 0 0 0 Proxy Agents Agentless SPs -------------------------- pc4 25 2 0 pc1 1 1 0 pc0 5 5 5 Proxy 32 pc4 Zones 5 S11zone101 S11zone102 S11zone100 S11zone103 S11zone104 Ldoms 25 stdldom21 stdldom34 stdldom36 stdldom22 stdldom45 stdldom47 ... OVMGuests 0 Servers 2 10.187.70.169 pc4 ... Proxy 28 pc1 Zones 0 Ldoms 26 stdldom21 stdldom34 stdldom36 stdldom22 stdldom45 stdldom47 ... OVMGuests 0 Servers 2 10.187.70.171 pc1 Use option '-v' to see additional notes on the counting algorithm.
You can view the Oracle Enterprise Manager Ops Center documents for additional information.
For more information, see these Oracle resources:
To download the OCDoctor-LATEST.zip file, go to https://updates.oracle.com/OCDoctor/OCDoctor-latest.zip
For more information on product administration, see http://docs.oracle.com/cd/E59957_01/nav/administer.htm
For end-to-end examples, see the Deploy How To library at http://docs.oracle.com/cd/E59957_01/nav/deploy.htm
and the Operate How To library at http://docs.oracle.com/cd/E59957_01/nav/operate.htm
For more information on Enterprise Manager Ops Center, see the Ops Center blog at https://blogs.oracle.com/opscenter/