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_entitycommand with the appropriate JSON files
Adding Entities from the UI
- From the Management Cloud main menu, select Administration, Discovery, and then Add Entity. The Add Entity page displays.
- Select the Oracle Virtual Networking Entity Type.
- 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.
- 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.
omcli and the Appropriate JSON Files
- 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.
- 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>
- 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.
- Add the entity using
omcli add_entity agent DEFINITION_FILE [-credential_file CREDENTIAL_FILE [-encryption_method_gpg]]
- Verify the status of the newly added entity.
omcli status_entity agent DEFINITION_FILE
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.