Add Oracle Infiniband Switch

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

Step 1: Prepare Oracle Infiniband Switch for monitoring.

Prerequisites

To enable monitoring, HTTP and SNMPv1/v2c/v3 are needed. If SNMPv1/v2 is used, you must provide SNMP community string that has been used earlier in IB Switch configuration along with IP address of agent which will be used for IB Switch monitoring. If SNMPv3 is used, in addition to SNMPv3 user, you must provide the auth method (SHA or MD5) and auth-password if auth used, and plus priv method (only DES supported) and priv-password if priv used. You must configure everything manually in IB Switch. Read only access is sufficient for IB Switch monitoring.

Step 2: Decide how you want to add the Oracle Infiniband Switch.

You can add Oracle Infiniband Switch entities using one of two ways:

• Add them from UI
• Use the agent's omcli add_entity command with the appropriate JSON files

Adding Entities from the UI

1. From the Management Cloud main menu, select Administration, Discovery, and then Add Entity. The Add Entity page displays.
2. Select the Oracle Infiniband Switch Entity Type.
3. Enter the following UI properties.

   Oracle Infiniband Switch UI Fields

   Entity Name: Name of your Oracle Infiniband Switch in Oracle Management Cloud. Dispatch URL: snmp://<Fully qualified host name or IP address of Oracle InfiniBand Switch> SNMP Port: Port where Oracle InfiniBand Switch listens for SNMP requests - 161 by default (optional) SNMP Timeout: Timeout for SNMP requests in seconds - 30 secs by default (optional) Cloud Agent: Cloud agent monitoring your Oracle Infiniband Switch. Monitoring Credentials SNMP V1/V2 Community String: SNMPv2c community string. SNMP V3 Username: SNMPv3 username. Authorization Password: Password used for authentication Authorization Protocol: Protocol used for authentication. (MD5 or SHA) Privacy Password: password used for encryption

See Add Entities from the Console for detailed instructions on using the Add Entity UI.

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 Infiniband Switch JSON Files and Properties

   Definition File: omc_oracle_ib_switch_sample.json name: Your InfiniBand Switch entity name. displayName: Your InfiniBand Switch 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 host_name: Under “value”, provide fully qualified host name or IP address of InfiniBand Switch omc_dispatch_url: Under “value”, following the string snmp://, provide the fully qualified hostname or IP address of InfiniBand Switch. 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 InfiniBand Switch, 2c by default. Credential Files omc_oracle_ib_switch_snmpv2c_sample_creds.json Use this credential file if you have configured your switch with SNMPv1/v2. COMMUNITY: Under “value”, within the square brackets, provide the SNMPv2c community string used during the InfiniBand Switch configuration. omc_oracle_ib_switch_snmpv3_sample_creds.json Use this credential file if you have configured your switch with SNMPv3 authUser: Under “value”, within the square brackets, provide provide SNMPv3 user name. authPwd: Under “value”, within the square brackets, provide the auth password or empty out the field. authProtocol: Under “value”, within the square brackets, provide the auth-method (SHA or MD5). privPwd: Under “value”, within the square brackets, provide the priv method password, if priv is used. 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 Oracle Infiniband Switch, see the following:

• Lack of Data
• Create an Agent Support Bundle