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

• 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 discovered category of the device by SNMP discovery.

• GeoLocation: The geographic coordinates of the device which can be used in Topology Graph views, Vision, and other places.

  Note:

  The coordinates must be in the order longitude, then latitude, for example:

  {"type":"Point","coordinates":[LONGITUDE,LATITUDE]}

• Shard: The shard the device metrics will be stored on.

• Discovery Information: If the device has been SNMP discovered, this information will be visible. You can use the Discover button to initiate discovery on this device. The SNMP Profile field is editable but all other fields are read-only.

  • SNMP Profile: The SNMP Access Profile that will be used when connecting to the device.

• Meta Tags: 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 either the 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.

• 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.

---

Title and Copyright Information

User’s Guide

G36447-01

Copyright © 2025, Oracle and/or its affiliates.