1. Using Oracle Infrastructure Monitoring
  2. Discovery
  3. Add Oracle Power Distribution Unit (PDU)

Add Oracle Power Distribution Unit (PDU)

You can add PDU entities using the Add Entity UI or using the cloud agent command line interface (omcli) with the appropriate JSON files.

Step 1: Prepare PDU for monitoring.

Prerequisites

To enable monitoring, HTTP and SNMPv1/v2c/v3 are needed. The NMS and trap tables in PDU administration interface must be set for a proper SNMP monitoring. for more information, see the PDU vendor documentation.

Step 2: Add the PDU using omcli and the Appropriate JSON Files

  1. Download and extract the required JSON file(s) from the master JSON zip file. See the table below for the specific JSON files you'll need.
  2. Edit the file(s) and specify the requisite properties shown below.
    Oracle Power Distribution Unit (PDU) Files and Properties

    Definition File: omc_oracle_pdu_sample.json

    • name: Your PDU entity name.
    • displayName: Your PDU entity display name.
    • timezoneRegion: Time zone of your entity. It is recommended that you use the long values IANA-maintained TZ database time zones. For example: America/New_York
    • omc_dispatch_url: Under “value”, provide your PDU HTTP URL.
    • omc_snmp_port: Under “value”, provide your SNMP port, default is 161.
    • omc_snmp_timeout: Under “value”, provide the timeout for SNMP requests in seconds, 10 by default.
    • omc_snmp_version: Under “value”, provide the SNMP version used to monitor PDU. Valid values are 1, 2 or 3.

    Credential Files

    You need to use HTTP credentials along with one of the SNMP credentials (v2c or v3)

    HTTP credentials - part of SNMPv1 and SNMPv3 json
    • username: User name for HTTP communication.
    • password: Password for user in HTTP communication.

    SNMPv2c

    omc_oracle_pdu_sample_snmpv1_creds.json

    • COMMUNITY: Community String for SNMP communication

    SNMP v3

    omc_oracle_pdu_sample_snmpv3_creds.json

    Use this credentials JSON file if using SNMP v3.

    • authUser: Name of priviliged user for SNMP communication
    • authPwd: Password for priviliged user for SNMP communication
    • authProtocol: Encryption protocol to be used for SNMP communication
    • privPwd: Password for SNMP communication

    Do not remove the square brackets.
  3. Add the entity using omcli.
    omcli add_entity agent DEFINITION_FILE [-credential_file CREDENTIAL_FILE [-encryption_method_gpg]]
  4. Verify the status of the newly added entity. 
    omcli status_entity agent DEFINITION_FILE

See step 4. Adding Entities to Your Service of Add Entities Using JSON Files for more information.

Step 3: (Optional but recommended) Set up alerts.

To enable lights-out monitoring, you can set up alert rules to generate alerts and send notifications if your entities have performance issues.

See Set Up Alert Rules and Set Up Alert Thresholds and Notifications.

Troubleshooting

If you run into any issues regarding discovery or monitoring of PDU, see the following: