Add Oracle Virtual Networking

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

Step 1: Decide how you want to add the Oracle Virtual Networking.

You can add Oracle Virtual Networking 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 Virtual Networking Entity Type.
3. Enter the following UI properties.

   Oracle Fabric Manager / Virtual Networking / Xsigo UI Fields

   Entity Name: Your OFM/OVN entity name. Host Name: The fully qualified host name or IP address of the OFM/OVM host. REST Port: The OFM/OVN REST port, default is 8443. Trust Any Server Certificate: False is recommended. You must import the storage server SSL certificate into the selected could agent before discovery. If you choose True instead, discovery will occur even for an untrusted or expired certificate. Cloud Agent: Cloud agent monitoring the host where OFM/OVM is installed. Monitoring Credentials Username: The OFM/OVN user. Password: The OFM/OVM user password.

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 Fabric Manager / Virtual Networking / Xsigo JSON Files and Properties

   Note: ONLY proper SSL certificates of OVN/OFM are supported. For self-signed certificates, manual addition to the agent keystore is required. To manually add a self-signed certificate to the agent keystore, run the following command: omcli secure add_trust_cert_to_jks -password <ask_oracle_support> -trust_certs_loc </path/to/certificateOfOFMServer.crt> -alias <hostname_of_OFM> omc_oracle_ovn_sample.json name: Your OFM/OVN entity name. displayName: Your OFM/OVN 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_ovn_hostname: Under “value”, provide fully qualified host name or IP address of the OFM/OVM host. omc_ovn_rest_port: Under “value”, provide your OFM/OVN REST port, default is 8443. Credential File: omc_oracle_ovn_sample_creds.json username: Under “value”, provide fully qualified host name or IP address of the OFM/OVM host. password: Under “value”, within the square brackets, provide the OFM/OVN user password. 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 2: (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 Virtual Networking, see the following:

• Lack of Data
• Create an Agent Support Bundle