Devices
Devices is a standard configuration interface for displaying all the devices that Oracle Communications Unified Assurance has discovered through the various pollers and discovery agents. From this list, you can manually add and edit devices as well as modify device settings such as custom name, IP address, and device state. You can easily export the list for inventory or accounting purposes.
For information about interacting with the grid and form, see Standard Configuration Interface in Unified Assurance Concepts. The Devices interface has additional controls, described in Grid Details.
This user interface calls REST methods from the api/device/devices endpoints. See REST API for Unified Assurance Core for details.
To open this interface, from the main navigation menu, select Configuration, then Device Catalog, and then Devices.
Grid Details
This interface contains the following additional options in the button bar:
-
Discover: Select a device and click this button to immediately start the SNMP discovery process for the device.
-
Unmanage: Select a device and click this button to set the device state to Disabled.
-
Remote -> SSH: Select a device and click this button to start an SSH session to the device from the presentation server.
-
Device Overview: Select a device and click this button to open the Device Overview dashboard.
Form Fields
The Device Information area includes the following fields:
-
State: The state of the device. This can show if a device is fully or partially discovered, if it is virtual, and so on.
-
Disabled: A device that will no longer be discovered or polled.
-
Discovered: Device has SNMP access. Set after SNMP Discovery.
-
New: Device has not been auto or SNMP discovered.
-
Non-discoverable: A device that can not be discovered.
-
Verified: Device can be pinged, set after initial auto discovery.
-
Virtual: Virtual devices cannot be discovered. They are for display of devices that do not actually exist or you cannot connect to. They must have a Parent Device.
-
-
Parent Device: For virtual device (when State is set to Virtual), you must select a parent device. Not relevant for physical devices.
-
DNS Name: The DNS name for the device. Not relevant for virtual devices.
-
Custom Name: An alternate name for the device. If added, this will be displayed in the Unified Assurance UI instead of the DNS Name or an IP Address.
-
IP Address (IPv4): The v4 IP address of the device. You can attempt to look up the IP address based on the DNS name by setting the DNS Name field and clicking the Lookup IPv4 by DNS Name icon, which looks like a magnifying glass. Not relevant for virtual devices.
-
IP Address (IPv6): The v6 IP address of the device. You can attempt to look up the IP address based on the DNS name by setting the DNS Name field and clicking the Lookup IPv6 by DNS Name icon, which looks like a magnifying glass. Not relevant for virtual devices.
-
Priority: Can be used to multiply the event severity by this value, and then put into the "Score" field. When configured via an event filter, a higher score will place events generated by this device higher on the event list.
-
Zone: The device zone the device belongs to. Used to split up polling and devices by location as needed.
-
Static Category: The category of the device. If this field is set to anything other than [Discovered], the value chosen will be considered a static override and will always be displayed. If it is set to [Discovered], the information used by SNMP discovery will be used to determine the category.
-
Discovered Category: The read-only category identified through SNMP discovery. Unified Assurance derives this category from the detected device type.
-
Latitude: The measurement of how far north (0 to 90 degrees) or south (0 to -90 degrees) a place is from the Earth's Equator. Supports up to six decimal places.
-
Longitude: The measurement of how far east (0 to 180 degrees) or west (0 to -180 degrees) a place is from the Prime Meridian. Supports up to six decimal places.
-
Shard: The shard the device metrics will be stored on.
-
Vendor: The read-only field that displays the vendor associated with the detected device type. The value is Unknown when Unified Assurance cannot associate the detected device type with a vendor.
The Discovery Information area includes the following editable field:
- SNMP Profile: The SNMP Access Profile that will be used when connecting to the device.
If the device has been SNMP discovered, the following additional fields are populated with read-only data:
-
SysOID: The device's unique SNMP object identifier.
-
SysName: The device's name.
-
SysLocation: The device's location.
-
SysContact: The device's contact information.
-
SysDescription: The device's description.
-
Serial number: The device's serial number.
-
Engine ID: The device's SNMP engine ID.
The Meta Tags area contains any meta tags and metadata that have been added to the device.
Best Practices
Use the following best practices when creating or editing devices:
-
For physical devices:
-
At minimum, you must specify the Custom Name, DNS Name, IPv4 or IPv6 address when creating a device.
-
Although a DNS name is not required, Oracle recommends specifying it.
-
-
For virtual devices, IP address and DNS name are not used. Custom Name and Parent Device are required.
-
If you are collecting metrics for a device and you change the DNS name, IP address (IPv4 or IPv6), zone, or shard, you must run the RelocateMetricData tool to repoint the metrics data to the correct device in the Metric database.
If you change the device name (DNS or IP address) multiple times before running RelocateMetricData, you must use the first name in the relevant --Previous option. The Metric database is not aware of any name changes until you run RelocateMetricData, so RelocateMetricData cannot locate the device using any of the interim names.
See RelocateMetricData in Unified Assurance Implementation Guide for more information, including examples.