Skip Headers
Oracle® Enterprise Manager Ops Center Administration Guide
12c Release 2 (12.2.1.0.0)

E38534-04
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

5 OCDoctor

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.

The following features and topics are covered in this chapter:

5.1 Introduction to the OCDoctor

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.

5.2 Downloading the OCDoctor

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.

To Download the OCDoctor

  1. On an Internet-facing system, navigate to http://java.net/projects/oc-doctor/downloads and click the OCDoctor-LATEST.zip download.

  2. Move the downloaded file to the target system.

  3. Unzip the file.

  4. If the target system is an existing Enterprise Controller, replace the contents of the /var/opt/sun/xvm/OCDoctor directory with the contents of the zip file.

5.3 Performing Preinstallation Checks

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.

To Perform Preinstallation Checks

  1. Change to the /var/opt/sun/xvm/OCDoctor directory.

  2. Run the OCDoctor.sh script with one of the following options:

    • --ec-prereq: Verifies that the system meets the prerequisites for an Enterprise Controller installation.

    • --proxy-prereq: Verifies that the system meets the prerequisites for a Proxy Controller installation.

    • --agent-prereq: Verifies that the system meets the prerequisites for an Agent Controller installation.

    • --performance: Checks the speed of the system and provides a Benchmark Time (BT) score. You can use a BT score to estimate how many assets a system can effectively manage. You should use this option when the system is idle.

    • --check-connectivity: Verifies that the system has network connectivity by connecting to My Oracle Support and downloading two test files.

    For example:

    # ./OCDoctor.sh --check-connectivity
    Ops Center Doctor 4.30  [OC 12.2.0.2663,SunOS11]
    ======================== Checking Network Connectivity ==============================
    Using Ops Center Proxy server:example-proxy.company.com   Port:80 (you may overwrite it by setting https_proxy)
    Please enter the My Oracle Support (MOS) Username: example.user@company.com
    Password:
     
    Test 1/4: Checking CC service reachability (without using user/password yet)
    ==============================================================================
    Connecting to https://hs-ws1.oracle.com/ochi/servicecheck?type=cc
    OK: CC status is OK
     
    Test 2/4: Checking GUUS service (KnowledgeBase Service) reachability (without using user/password yet)
    ==============================================================================
    Connecting to https://hs-ws1.oracle.com/ochi/servicecheck?type=guus
    OK: GUUS status is OK
     
    Test 3/4: Downloading Knowledge Channels file from updates.oracle.com
    ===========================================================================
    Connecting to https://updates.oracle.com/channels3/channels.xml
    OK: Knowledge download was successful!
     
    Test 4/4: Downloading patch 108437-06 from updates.oracle.com
    ===========================================================================
    Connecting to https://updates.oracle.com/all_unsigned/108437-06.zip
    OK: Patch download was successful!
    

5.4 Performing Troubleshooting and Tuning

The OCDoctor can help you troubleshoot issues and tune systems.

To Perform Troubleshooting and Tuning

  1. Change to the /var/opt/sun/xvm/OCDoctor directory.

  2. Run the OCDoctor.sh script with one of the following options:

    • --troubleshoot: Troubleshoots common problems and suggests solutions. You can also use the --fix option to automatically fix certain issues.

    • --collectlogs <parameters>: Collects all logs from the current system. You can add optional parameters to pass the logs to collection scripts.

    • --needhelp: Provides information on gathering additional system information and filing a support case.

    • --tuning: Scans the current system and suggests changes to improve system performance. You can also use the --fix option to automatically apply some tuning improvements.

    • --whatisblobid <id>: Provides details about the specified blob id.

    • --getblobid <patch id>: Provides the blob id for a specified patch.

    For example:

    # ./OCDoctor.sh --troubleshoot
    Ops Center Doctor 4.30  [OC 12.2.0.2663,SunOS11] [Read only] [31-Mar-2014 10:34AM MDT]
    ======================== Checking Enterprise Controller... ==============================
    OK: Total number of agents (without Solaris 11 ones): 20
    OK: Number of agents with inventories: 20
    OK: Enterprise Controller requirements are met
    OK: Files in /var/opt/sun/xvm/images/agent/ have the right permissions
    OK: Files in /var/opt/sun/xvm/osp/web/pub/pkgs/ have the right permissions
    OK: both pvalue and pdefault in systemproperty are equal to false (at id 114)
    OK: Found only 57 OCDB*.aud files in oracle/admin/OCDB/adump folder
    OK: Found no ocdb*.aud files in oracle/admin/OCDB/adump folder
    OK: No auth.cgi was found in cgi-bin
    OK: User 'oracleoc' home folder points to the right location
    OK: User 'allstart' home folder points to the right location
    OK: Apache logs are smaller than 2 GB
    OK: n1gc folder has the right permissions
    OK: All agent packages are installed properly
    OK: All Enterprise Controller packages are installed properly
    OK: Enterprise Controller status is online
    <Output omitted>
    

5.5 Updating the OCDoctor

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.

To Update the OCDoctor

  1. Change to the /var/opt/sun/xvm/OCDoctor directory.

  2. Run the OCDoctor.sh script with the --update option. If you want to force a download of the latest online version, use the --force option.

    For example:

    # ./OCDoctor.sh --update
    Ops Center Doctor 4.30  [OC 12.2.0.2663,SunOS11]
    Trying to download updates...
    Using Ops Center Proxy server:www-proxy.us.oracle.com   Port:80
     
    Downloading version file using mirror: updates.oracle.com
     
    OK: Version file was downloaded successfully
    OK: Connected successfully - but no updates were found (current: 4.30, online: 4.30).
     
    You may force downloading the online version by running:
    # ./OCDoctor.sh --update --force