Displaying Device Information at the Network Level
The Prime Performance Manager network device view provides the broadest overview of your network devices. From this view you can drill down to different device details, as well as to individual devices for details about one device. (See Displaying Device Information at the Device Level.)
To display the network-level device view, from the Network menu, choose Devices. The Network Devices window displays the last updated time in the window title bar. If the gateway and client reside in the same time zone, one time is presented. If the gateway and client are in different time zones, both times are presented.
Device information areas, accessed from Network Devices window tabs, are displayed in Table 9-1 .
Displaying Device Properties at the Network Level
Prime Performance Manager displays properties for all network devices in one view. To display them:
- From the Network menu, choose Devices.
All discovered network devices are displayed. Table 9-2 lists the available device properties. In addition, you can change the following items in User Preferences.
- Device details displayed from device hyperlinks—You can display device details from hyperlinks either as a popup that automatically appears when you move your mouse over the link, or in the 360 Network Device View window, which is displayed when you click an icon next to the hyperlink.
The device details displayed in the popup or 360 Network Device View are described in Table 9-2 , and Table 9-11. The details display option is useful in other windows that list device links, for example, the Network Alarms window, or when drilling down to the interface report level. However, you can disable this feature in User Preferences.
- Alarm severity icons—Devices include an alarm severity icon indicating the highest level alarm on the device. You can disable this feature in User Preferences.
- Deleted devices—Deleted devices, without hyperlinks, can be displayed by enabling this option in User Preferences.
For information about changing user preferences, see Customizing the GUI and Information Display
Table 9-2 Devices Properties at the Network Level
|
|
Internal ID |
Device internal ID. Prime Performance Manager assigns this ID to the device for internal use. |
Unit |
Name of the unit to which the device is assigned. |
Display Name |
Device display name. |
Custom Name 1 |
Device custom name, if available. |
Sync Name 1 |
Device sync name. |
IP Address or DNS Hostname 1 |
Device IP address or DNS name as Prime Performance Manager discovered it. |
System Name 1 |
Device system name. |
Management IP Address |
IP address used to poll the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Annotation |
Displays any annotation that was written about the device. See Annotating a Device. |
Feature 1 |
A short descriptive term for the device, if known. Otherwise, Generic. |
Software Version 1 |
Device software version. |
Serial Number 1 |
Device serial number. The serial numbers that are displayed as unknown, can be customized using the following steps:
- Open the /opt/CSCOppm-gw/properties/Device.properties file on the Prime Performance Manager Gateway.
- Append the DEVICE_SERIALNUM_INDEX property with the device type OID and the serial number index separated by a colon.
Note Append the correct index to its appropriate device type OID. Example: For cisco340024TSA, the device OID is 1.3.6.1.4.1.9.1.736, the serial number index is 1001, the entry added needs to be as follows: 1.3.6.1.4.1.9.1.736:1001 To configure multiple devices, use a comma separated string without any spaces. Example: DEVICE_SERIALNUM_INDEX=1.3.6.1.4.1.9.1.574:1001,1.3.6.1.4.1.9.1.1252:100 |
Last Full Poll Time 1 |
The time of the last Prime Performance Manager poll. |
Last Poll Response (secs) 1 |
The time for the device to respond to the last poll request. |
Avg. Poll Response (secs) 1 |
Average time for the device to respond to Prime Performance Manager poll requests. |
Uptime 1 |
Time the device has been up in days, hours, minutes, and seconds. |
Reboot Reason 1 |
Reason for the last device reboot. |
Discovery Source 1 |
Indicates how Prime Performance Manager discovered the device: PPM (Prime Performance Manager) or Prime Network. See Chapter5, “Discovering Devices With Prime Performance Manager” |
Report Polling |
Indicates whether report polling is enabled for this device. |
Sending Alarms |
Indicates whether the device is sending alarms. Users with authentication level Network Operator (level 3) and higher can edit this field. See Creating and Editing Device Polling Groups. |
Severity |
If alarms are raised for the device, the highest severity: Critical, Major, Minor, Warning, Informational, Unmanaged, or Normal. |
Last Status Change 1 |
Date and time that the device status last changed. |
Status |
Current device status:
- Active—The device is active.
- Discovering—Prime Performance Manager is in the process of discovering the device; not all device details are known.
- Polling—Prime Performance Manager is polling the device.
- Unknown—Prime Performance Manager does not have the device details, possibly because connectivity is lost or other reasons.
- Unmanaged—Indicates a Prime Network device that is not managed by Prime Network.
- Waiting—Prime Performance Manager has sent a polling request and is waiting for a response.
- Warning—The device is in a warning status.
|
Status Reason |
Reason for the current device status. (If you cannot see all of the status reason text, place the cursor over the cell to see the full text in a tooltip.) The stateReasons.html provides a list of possible reasons,located at: /opt/CSCOppm-gw/apache/share/htdocs/eventHelp. |
Contact 1 |
The device contact name, if added. |
Location 2 |
The device location, if added. If GPS locations are enabled, the location is displayed as a hyperlink that, when launched, displays the device location in a separate Google Maps browser session. |
Polling Group 1 |
The polling group to which the device is assigned. See Creating and Editing Device Polling Groups |
Report Policy 1 |
The report policy to which the device is assigned. See Creating Report Policies. |
Vendor 1 |
Device manufacturer. |
Software Description 1 |
Device software description, if available. |
Displaying Device Type Distributions at the Network Level
The Network - Device Distribution by Type window presents your device type distributions in table and pie chart format. Information includes the device type, the total number of devices, and the device type percentage within the network. To display device distributions:
- From the Network menu, choose Devices, then click Types.
Network - Device Distribution by Type fields include:
- Type—The name of the device platform, for example, Cisco1706, ONS15454.
- Total (total number of devices)—The total number of devices of a particular type.
- Percentage—The percentage of devices of this type out of all the discovered devices.
From the Device Distributions window, you can:
- Click a device type link to display all the devices of that type. From there you can drill down into individual devices to view reports, alarms, events, and other information described in Displaying Device Properties at the Network Level.
- Export the data to a CSV file.
- Send the distributions pie chart to a printer or graphic image.
Displaying Alarms by Device at the Network Level
The Network - Alarms by Device window displays a count of alarms by device and severity. You can display alarms by device from either the Devices or Alarms/Events windows:
- From the Network menu, choose either Devices or Alarms/Events, then click Alarms by Device.
Table 9-3 lists the Network - Alarms by Device properties.
Table 9-3 Network Alarms by Device Properties at the Network Level
|
|
|
Internal ID |
— |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Device |
— |
Name of the device. When you click any of the device names, the Alarms tab of that device is displayed. This column is displayed by default. |
Sending Alarms |
— |
Indicates whether the device is sending alarms. Users with authentication level Network Operator (level 3) and higher can edit this field. See Creating and Editing Device Polling Groups. |
Last Status Change 1 |
— |
Date and time that the status of the device alarms last changed. |
Total |
— |
Total number of alarms for the device. |
Critical (alarm count) (alarm percentage) |
|
Total number of critical alarms for the device. |
Major (alarm count) (alarm percentage) |
|
Total number of major alarms for the device. |
Minor (alarm count) (alarm percentage) |
|
Total number of minor alarms for the device. |
Warning (alarm count) (alarm percentage) |
|
Total number of warning alarms for the device. |
Informational (alarm count) (alarm percentage) |
|
Total number of informational alarms for the device. |
Normal (alarm count) (alarm percentage) |
|
Total number of normal alarms for the device. |
Displaying Alarms by Device Type at the Network Level
The Network - Alarms by Device Type window displays device alarm information organized by device types. You can display alarms by device type from either the Devices or Alarms/Events windows:
- From the Network menu, choose either Devices or Alarms/Events, then click Alarms by Device Type.
Network - Alarms by Device Type displays the following information:
- Device Type—The device type, for example, Cisco7606 for Cisco 7606 Routers, CiscoONS15454 for Cisco ONS 15454 Multiservice Transport Platform, and so on.
- Total—The total number of alarms for the device type.
- Alarms—The following alarm totals are provided along with the total alarm count and alarm percentage:
–
Critical
–
Major
–
Minor
–
Warning
–
Information
–
Normal
Displaying Devices Time Out Alarms at the Network Level
The Network - Unreachable window displays devices for which a NodeUnreachable alarm is present. To display devices with unreachable alarms:
- From the Network menu, choose Devices, then click Unreachable. The table displays the same device parameters as the Devices table. See Table 9-2.
Displaying NetFlow Devices at the Network Level
The Network - NetFlow window displays devices that have NetFlow provisioned. To display NetFlow devices:
- From the Network menu, choose Devices, then click NetFlow. The Network - NetFlow Enabled Devices table displays the same device parameters as the Devices table. See Table 9-2.
Note
If no network devices have NetFlow provisioned, the NetFlow tab is not displayed.
Displaying Device Polling Responses at the Network Level
The Network - Polling window displays the number of seconds devices take to respond to the Prime Performance Manager poll requests. To display the device poll responses:
- From the Network menu, choose Devices, then click Polling.
Table 9-4 lists the Network - Polling information.
Table 9-4 Device Polling Responses at the Network Level
|
|
Internal ID |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Unit 1 |
Name of the unit to which the device is assigned. |
Display Name |
Name of the device. |
Management IP Address |
Device IP address used to poll the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Location |
The device location. |
Report Polling |
Indicates whether report polling is enabled for this device. |
Report Policy |
The report policy, if any, assigned to the device. |
Polling Group |
The polling group, if any, assigned to the device. |
Last Full Poll Time ( device time zone) |
The date and time Prime Performance Manager last polled the device. |
Last Poll Response (secs) |
The time, in seconds, it took for the device to respond to the poll. |
Avg. Poll Response (secs) |
Average response time for the device to respond to poll from the Prime Performance Manager server. |
Severity |
The highest severity alarm currently raised on the device. |
Uptime |
The amount of the time the device has been up. |
Displaying Device ICMP Ping Responses at the Network Level
The Network - Ping window displays the number of seconds devices take to respond to the Prime Performance Manager Internet Control Message Protocol (ICMP) pings, and the resulting device availability percentages.
Note
The ICMP Ping reports must be enabled in order for data to appear in the Network Ping table. The ICMP Ping reports are located in the Availability report group.
To display ICMP ping results and device availability:
- From the Network menu, choose Devices, then click Ping.
The following information is displayed:
- Last ICMP Response—The time required for the device to respond to the last ICMP ping.
- Availability—Based upon the ping responses, the device availability is provided for the previous and current time periods for the following intervals:
–
15 Minutes
–
Hourly
–
Daily
–
Weekly
–
Monthly
Displaying Device Up Time at the Network Level
The Network - Uptime window displays the uptime for managed devices. To display device up times:
- From the Network menu, choose Devices, then click Uptime.
Table 9-5 lists the device up time properties.
Table 9-5 Device Up Time at the Network Level
|
|
Internal ID |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Unit 1 |
Name of the unit to which the device is assigned. |
Display Name |
The device display name. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Uptime |
Time the device has been up, in days, hours, minutes, and seconds. |
Reboot Reason |
Reason for the last reboot of the device. |
Severity |
Indicates the highest alarm severity for the chosen device: Critical, Major, Minor, Warning, Informational, Unmanaged, or Normal. |
Displaying Device Data Collection Status at the Network Level
The Network - Data Collection table allows you to quickly see the data collection status of devices across the network. To display the device data collection status:
- From the Network menu, choose Devices, then click Data Collection.
Table 9-6 lists the data collection status parameters.
Table 9-6 Device Data Collection at the Network Level
|
|
SNMP |
Indicates whether the device SNMP data collector is active, inactive, or not configured for polling. |
Hypervisor |
Indicates whether the device Hypervisor data collector is active, inactive, or not configured for polling. |
SMICollector |
Indicates whether the device storage management initiative (SMI) collector is active, inactive, or not configured for polling. It is used to collect performance statistics from storage devices and network. |
CLI |
Indicates whether the device CLI data collector is active, inactive, or not configured for polling. |
NetFlow |
Indicates whether the device NetFlow data collector is active, inactive, or not configured for polling. |
JMX |
Indicates whether the device Java Management Extensions data collector is active, inactive, or not configured for polling. |
Data Collection Manager |
Indicates whether the Cisco Data Collection Manager (DCM) bulk statistics collector is active, inactive, or not configured for polling. DCM is a data collection agent that is embedded in managed devices, such as routers and switches. DCM works on a push model, which is based on a subscribe-and-notify data pattern, as opposed to the pull model, which is based on a request-and-response data pattern, in traditional SNMP-based network management. |
Collectd Stats |
Indicates whether the collectd statistics data collector is active, inactive, or not configured for polling. collectd is a daemon which collects system performance statistics periodically and provides mechanisms to store the values in a variety of ways. |
Star OS Bulk Stats |
Indicates whether the Cisco Star OS bulk statistics data collector is active, inactive, or not configured for polling. It is used to process performance statistics pushed from Cisco ASR 5000 devices. |
RMS_LOGCollector |
Displays Radio Access Network (RAN) Management System (RMS) upload servers log collector data. |
ICMP |
Indicates whether the device IP data collector is active, inactive, or not configured for polling. |
Small Cell |
Indicates whether the Cisco Small Cell Solution bulk statistics data collector is active, inactive, or not configured for polling. It is used to collect performance statistics from small cell AP devices on a upload server in wireless access network. |
Generic CSV |
Indicates whether the generic CSV bulk statistics data collector is active, inactive, or not configured for polling. |
GMOND |
Indicates whether the Ganglia Monitoring Daemon (GMOND) data collector is active, inactive, or not configured for polling. |
Internal |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Optical Bulk Stats |
Indicates whether the optical bulk statistics data collector is active, inactive, or not configured for polling. |
Displaying Device Software at the Network Level
The Network - Software window lists the software versions and descriptions for each device in the Prime Performance Manager network. To display the device software information:
- From the Network menu, choose Devices, then click Software.
Table 9-7 lists the Network - Software parameters.
Table 9-7 Device Software at the Network Level
|
|
Display Name |
Name of the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Vendor |
The device manufacturer or technology. |
Software Version |
Software version used by the device. |
Software Description |
Full software version information. |
Displaying Device Contacts and Locations at the Network Level
The Network - Contacts/Locations window displays the device contacts and locations if that information was entered for the device. To display the device contacts and locations:
- From the Network menu, choose Devices, then click Contacts/Locations.
Table 9-8 lists the Network - Contact/Location properties.
Table 9-8 Device Contacts and Locations at the Network Level
|
|
Internal ID |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Display Name |
The device display name. |
IP Address or DNS Hostname 1 |
IP address or DNS name of the device, as the Prime Performance Manager discovered it. |
System Name 1 |
System name of the device. |
Management IP Address 1 |
The IP address that SNMP uses to poll the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Contact |
The device contact name. |
Location |
The device location. |
Status |
Current device status:
- Active—The device is active.
- Discovering—Prime Performance Manager is in the process of discovering the device; not all device details are known.
- Polling—Prime Performance Manager is polling the device.
- Unknown—Prime Performance Manager does not have the device details, possibly because connectivity is lost or other reasons.
- Unmanaged—Indicates a Prime Network device that is not managed by Prime Network.
- Waiting—Prime Performance Manager has sent a polling request and is waiting for a response.
- Warning—The device is in a warning status.
|
Displaying Device Vendors at the Network Level
The Network Vendors window displays the device types, manufacturers, and status. To display the device vendor information:
- From the Network menu, choose Devices, then click Vendor.
Table 9-9 displays the device vendor information.
Table 9-9 Device Vendor Information at the Network Level
|
|
Internal ID |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Display Name |
The device display name. |
IP Address or DNS Hostname 1 |
IP address or DNS name of the device, as the Prime Performance Manager discovered it. |
System Name 1 |
System name of the device. |
Management IP Address 1 |
The IP address that SNMP uses to poll the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Vendor |
The device manufacturer. |
Status |
The device status, for example, Active. |
Displaying Device Details in Cisco Prime Format
If Prime Performance Manager is integrated with Cisco Prime Central (see “Importing Devices From Other Cisco Prime Applications” ), you can display the device details in a format that matches Prime Central. Because fewer properties are displayed than the Devices tab, Prime can provide a quick look at the Prime Performance Manager devices in an organization that aligns with their display in Prime Central.
To display Prime Performance Manager device details in Prime Central format:
- From the Network menu, choose Devices, then click Prime.
Table 9-8 lists the device properties displayed in the Network - Prime window.
Table 9-10 Device Details Displayed in Network - Prime
|
|
Internal ID |
Internal device ID. Prime Performance Manager assigns this ID to the device for internal use. |
Unit 1 |
The unit to which the device is assigned. |
Device Name |
IP address or DNS name of the device, as the Prime Performance Manager discovered it. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Vendor |
The device manufacturer. |
Status |
Current device status:
- Active—The device is active.
- Discovering—Prime Performance Manager is in the process of discovering the device; not all device details are known.
- Polling—Prime Performance Manager is polling the device.
- Unknown—Prime Performance Manager does not have the device details, possibly because connectivity is lost or other reasons.
- Unmanaged—Indicates a Prime Network device that is not managed by Prime Network.
- Waiting—Prime Performance Manager has sent a polling request and is waiting for a response.
- Warning-—The device is in a warning status.
|
Management IP Address |
IP address used to poll the device. |
Software Version |
The software version installed on the device. |
System Name |
The device system name. |
Managing Devices in the Network-Level View
At the network-level device view, operator or higher users can perform some device modifications. To manage network devices:
Step 1
From the Network menu, choose Devices.
Step 2
Navigate to one of the following device view tabs:
- Devices
- Types
- Alarms by Device
- Alarms by Device Type
- Unreachable
- NetFlow
- Polling
- Ping
- Uptime
- Data Collection
- Software
- Contact/Locations
- Vendor
- Prime
See Displaying Device Information at the Network Level for information on displaying these views.
Step 3
Select a device. Press Shift to select multiple contiguous devices, or Ctrl to select devices that are not contiguous.
Step 4
From the Actions menu (located just above the device table), choose any of the following actions.
- Poll Device—Polls the devices selected in the device list.
- Edit Properties—Allows you to edit the device display name and default web port. See Editing a Device Name, Web Port, Time Zone, and Location.
- Edit Device Credentials—Allows you to edit the device connection credentials used to poll the device. See Editing the Device Credentials.
- Edit Report Policy—Allows you to change the report policy assigned to the device. See Editing the Report Policy Assigned to a Device
- Edit Polling Policy—Allows you to change the polling policy assigned to the device. See Creating and Editing Device Polling Groups and Editing the Polling Group Assigned to a Device.
- Edit Management IP Addresses—Allows you to edit a device management IP addresses. See Editing the Device Management IP Addresses.
- Change Interface Polling—Allows you to remove device interfaces from polling. See Removing Device Interfaces From Polling.
- Relocate Device—Allows you to relocate a device from one unit to another. See Relocating Devices to Units.
- Disable Alarms and TCAs—Displays the Customize Date and Time Range dialog box in which you can configure a date and time span during which alarms and TCAs will be suppressed on the selected device(s). You can specify a specific start and end date using the calendar, or you can specify the start date and time, then click any of the time presets (1 Day, 2 Days, 1 Week, and so on).
- Enable Alarms and TCA—If you disabled alarms and TCAs, this option enables them, even if the duration specified in the Customize Date and Time Range dialog box has not been reached.
- Unmanage Device—Changes managed devices to unmanaged.
- Manage Device—Changes unmanaged devices to managed.
- Enable Maintenance Mode—Allows you to place the device in maintenance mode (polling is stopped) for a specified time period entered in the Enable Maintenance Mode dialog box.
- Annotation—Allows you to enter the notes for the selected device. See Annotating a Device.
- Delete—Deletes the selected device(s).
Note
If multiple devices are selected, not all actions are available.
Step 5
To check device connectivity, from the device toolbar, click one or both of the following:
- Ping—Pings the device and displays the results in a Ping Device: [ device name ] window.
- Traceroute—Runs the traceroute command to detail the route from the gateway to the device and displays the results in a Traceroute Device: [ device name ] window.
Note
You can also use the ppm ping and ppm traceroute commands to check device connectivity. See ppm ping and ppm traceroute.
Editing a Device Name, Web Port, Time Zone, and Location
Within the device network view, you can change the device name, web port, time zone and location. To edit these device properties:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device whose name you want to edit.
Step 3
From the Actions menu, choose Edit Properties
Step 4
In the Edit Properties dialog box, edit the following properties:
- Name—Name of the device. The name is green for valid inputs and red for invalid inputs. The name may include up to 100 alphanumeric and the special characters hyphen (-), underscore (_), period (.), and colon (:). If you enter an invalid name, the Save option is disabled. After saving, the new name is displayed in the navigation tree and in the Details panel. The character ‘.’ is allowed only when the resulting name is a valid hostname.
- Default Web Port—Should you wish to change the default device web port, enter the web port number.
- Time Zone—Should you wish to change the device time zone, type the first two or more letters of the time zone. The field will populate with time zones matching the letters you entered. (Time zones are expressed using the tzdata, or IANA Time Zone Database formats.)
- Location—The device location, which is displayed in the device Location property. If GPS Locations is enabled (see Changing System Configuration Settings), the location you enter is used to display the device location in Google Maps. If GPS is enabled, be sure to enter sufficient location information to enable Google Maps to display the device location accurately.
Step 5
Click Save.
Editing the Device Credentials
To edit the device connection credentials:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device whose credentials you want to edit.
Step 3
From the Actions menu, choose Edit Device Credentials.
Step 4
In the Edit Device Credentials dialog box, edit any of the following:
SNMP
- SNMP Version—Indicate the SNMP version, either 1, 2c, or 3.
- Max Table Varbind—Sets the maximum table variable binding.
- Port—Sets the SNMP port number.
SNMP v1, v2
- Read Community—The SNMP community name used by the device for read access to the information maintained by the SNMP agent on the device.
SNMP v3
- User Name—The user name.
- Authentication Protocol—The authentication protocol:
–
md5—Uses the Hash-based Message Authentication Code (HMAC) MD5 algorithm for authentication
–
sha—Uses the HMAC SHA algorithm for authentication
- Privacy Protocol—The privacy protocol:
–
3des—Uses Data Encryption Standard (DES).
–
des—Uses the Data Encryption Standard (DES).
–
aes128—Uses Advanced Encryption Standard (AES) 128-bit encryption.
- Privacy Password—The privacy password.
Other Credentials
- ID—An internal identifier.
- Connection Protocol—Choose the transport protocol to be used to communicate with device:
–
Telnet—Telnet.
–
SSHv1—SSH Version 1.
–
SSHv2—SSH Version 2.
–
WSMA_SSH—Web Services Management Agent over SSHv2. WSMA is an infrastructure framework that allows external applications to monitor and control Cisco devices. WSMA uses transports such as SSH, HTTP, and HTTPS to access a set of Web Services agents residing on the Cisco device.
–
collectd_SSH—A daemon that collects, transfers, and stores performance data.
–
HTTP—HyperText Transfer Protocol.
–
HTTPS—Secure HTTP.
–
HTTP_BULK—Bulk statistics through HTTP.
–
WMI_HTTP—Windows Management Instrumentation over HTTP.
–
WMI_HTTPS—Windows Management Instrumentation HTTPS.
–
vCenter_HTTPS—VMware vCenter server over HTTPS.
–
ESXi_HTTP—VMware ESXi embedded bare metal hypervisor over HTTP.
–
ESXi_HTTPS—VMware ESXi embedded bare metal hypervisor over HTTP.S
Note
When you define the credential for vCenter and ESXi devices, make sure the user account you use has the session privilege. For information, see.
–
XEN_TLS—Xen hypervisor over Transport Layer Security (TLS) protocol.
–
KVM_TLS—Linux Kernal-based Virtual Machine (KVM) over TLS.
Note Xen_TLS and KVM_TLS have discovery requirements. See Xen and KVM TLS Discovery Requirements
–
HyperV_HTTP—Microsoft HyperV server over HTTP.
–
HyperV_HTTPS—Microsoft HyperV server over HTTPS.
–
JMX—Java Management Extensions. Collects statistics from Java processes running on various servers.
Note JMX reports are not enabled by default. After adding the JMX credential, you will need to enable the reports. For information, see Customizing Individual Report Settings.
–
PNSC_HTTPS—Cisco Prime Network Services Controller secure HTTP connection.
–
GMOND_SOCKET—Ganglia Monitoring Daemon (gmond) socket.
–
SMI_HTTPS—Storage Management Initiative over HTTPS.
–
ULS_HTTP—Allows Prime Performance Manager to perform Small Cell upload server HTTP credential verification including subsystem, username, password, and credential parameters. Beyond that, ULS_HTTP is identical to HTTP protocol.
–
AVI_HTTPS—A secure connection with AVI Networks load leveling device.
- User Name—The device login username.
- Password—The password for the login user.
- Secondary Login Type—Enables
- Enable User Name—The privileged username.
- Enable Password—The privileged user password.
- Port—The device port to be used by the transport protocol chosen in the Protocol field.
- Sub System—The subsystem used by transport protocol. If the subsystem is defined on the device, enter it here. A blank string is the default subsystem for SSH. The default subsystem for WSMA is “wsma”.
Note
To poll the Cisco Nexus 7000 through its XML management interface using Network Configuration Protocol (NETCONF), enter netconf in the Sub System field. Using the XML interface allows you to generate Border Gateway Protocol (BGP) reports.
- User Name—Enter the device login username.
Note
For vCenter and ESXi devices that are members of an Active Domain, you can enter the domain and username in the format domain/username.
Note
For KVM_TLS, if SASL is enabled on the KVM device, add Simple Authentication Security Layer (SASL) credentials to the entry. SASL usernames typically have the SASL realm appended to it, such as user@hostname. If SASL is not enabled on the KVM device, you can leave the User Name and Password fields blank.
- Password—Enter the password for the login user.
- Secondary Login Type—Indicates how the secondary user and password should be processed:
–
Enable—Executes the Cisco IOS enable command, which provides Prime Performance Manager privileged EXEC level (Level 15) access to the device.
–
Second Login—Executes the login command to log into the device using the secondary username and password. If you choose this option, the secondary user must have privileged EXEC access to the device,
Note
Secondary Login Type is only available for Telnet or SSH connections.
- Secondary User Name—Enter the secondary username.
- Secondary User Password—Enter the secondary user password.
Step 5
If you entered an SSHv2 or HTTPS credential and want to use the SSHv2 key authentication, complete the following steps. Otherwise, continue with Step 6. By default, Prime Performance Manager authenticates itself to the device using the User Name and Password entries. To change to the SSHv2 authentication keys:
a.
In the Client Authentication Type field, and choose Public Key.
b.
Click the Client Private Key field.
c.
In the SSH Credentials for [hostname] dialog box, enter the private key file name and click Import.
d.
Enter the public key file name and click Import.
e.
Click Generate Public Key.
Step 6
Click the Test Credential.
A Testing Credentials for [ device name ] dialog box appears. If Prime Performance Manager succeeded in connecting to the device with the credentials you entered, the following is displayed:
****Starting Credentials Test****
Connection test successfully!
If Prime Performance Manager could not connect to the device, an error is displayed, for example:
****Starting Credentials Test****
Exception while connecting to device!
Step 7
In the Test Credentials for [ device name ] dialog box, click Close.
Step 8
If the credentials test succeeded, click Save.
The edited credentials are saved for the device.
Editing the Report Policy Assigned to a Device
To edit the report policy assigned to a device:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device whose report policy you want to edit.
Step 3
From the Actions menu, choose Edit Report Policy.
Step 4
In the Edit Report Policy dialog box, choose the report policy that you want assigned to the device from the Report Policy policy list.
Step 5
Click Save.
Editing the Polling Group Assigned to a Device
To edit the polling group assigned to a device:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device whose polling group you want to edit.
Step 3
From the Actions menu, choose Edit Polling Group.
Step 4
In the Polling Group Details dialog box, edit the following properties:
- Polling Group—Allows you to assign a different polling policy to the device. For information about creating and editing polling policies, see Creating and Editing Device Polling Groups
- Timeout—The timeout duration in seconds configured in the polling policy. Timeout is not editable unless you choose This Device Only in the Polling Policy field.
- Retries—The number of times Prime Performance Manager will retry a connection after a timeout configured in the polling policy. Retries is not editable unless you choose This Device Only in the Polling Policy field.
Step 5
Click Save.
Editing the Device Management IP Addresses
To edit the polling group assigned to a device:
Note
The Edit SNMP IP Addresses option is available only for the users with authentication Level 5.
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device whose management IP addresses you want to edit.
Step 3
From the Actions menu, choose Edit Management IP Addresses.
The Edit Management IP Address dialog box displays the following:
- Available IP Addresses—Lists all IP addresses not associated polling.
- IP Addresses for Management—Lists the IP addresses associated with the device, including the primary SNMP address and all backup IP addresses.
Step 4
Click any of the following:
- Add —Adds the IP Addresses from the Available IP Address box to the IP Addresses for Management box. This option is disabled if there is no IP address in the Available IP Address box.
- Remove —Removes the IP Addresses from the IP Addresses for Management box and adds them to the Available IP Addresses box. This option is disabled if there is no IP address in the IP Addresses for Management box.
- Raise —Moves the selected IP address up one level in the IP Addresses for Management box. This option is disabled if there is only one IP address in the IP Addresses for Management box.
- Lower —Moves the selected IP address down one level in the IP Addresses for Management box. This option is disabled if there is only one IP address in the IP Addresses for Management box.
Note
If only one IP address is available, the Raise and Lower buttons are not available.
Step 5
When finished, click Save.
Removing Device Interfaces From Polling
By default, all device interfaces are polled. At certain times you might want to remove one or more device interfaces from polling. For example in a network that aggregates very large numbers of low speed links pointing to the customer edge of the network, you might not want to retrieve data for every customer link, most of which are fixed bandwidths. In this case, you can use the Change Interface Polling action to remove the interfaces from polling.
Note
If you remove interfaces from polling, reports requiring information from the removed interfaces, for example, QOS, MPLS, VPN, might show incomplete data points.
To remove a device interface from polling:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
Select the device containing the interfaces you want to remove.
The device must have an Active status and not have alarms. If the device is not active or has alarms, the Change Interface Polling action is not available.
Step 3
From the Action menu, choose Change Interface Polling.
Step 4
In the Change Interface Polling dialog box, select the interfaces you want polled and click Add to move from the Available Interfaces to the Selected For Polling group.
Tip Press Shift to choose more than one interface.
Step 5
Click Save.
Only interfaces in the Selected For Polling group will be polled.
Relocating Devices to Units
To relocate a device to a different unit:
Step 1
Navigate to one of the following device views: Devices, Alarms by Device, Unreachable, NetFlow, Polling, Ping, Uptime, Data Collection, Software, Contact/Location, Prime. (For information on displaying these views, see Displaying Device Information at the Network Level.)
Step 2
In the device list, select the device that you want to relocate.
Step 3
From the Actions menu, choose Relocate Device.
Step 4
In the Relocate Device dialog box, choose the unit to which you want to assign the device from the Units list.
Step 5
Click Save.
Annotating a Device
You can add annotative notes to devices to communicate details to network personnel that aren’t included in the device information picked up by Prime Performance Manager.
To annotate a device in the network.
Step 1
Login to the Prime Performance Manager GUI.
Step 2
From the Network menu, choose Devices. The Device summary page displays.
Step 3
Highlight the device you want to annotate.
Step 4
From the Actions menu, click Annotation.
The Annotation screen displays and allows you to enter text for the selected device.
Step 5
Click Save to save the text.
Step 6
Click on the Edit Note icon to edit the existing text.
Step 7
Click on the Cancel Editing Note icon if you do not want to save the edited text.
Step 8
Click on the device link on which you have annotated the text. The selected device page displays the Annotate tab.
Displaying the 360 Device Details View
Every device, device element, or device technology hyperlink displayed in Prime Performance Manager includes an icon, shown in Figure 9-1, that, when clicked, displays a 360 detailed device view, shown in Figure 9-2. This window provides detailed information about the device, element, technology from various Prime Performance Manager GUI locations including devices, alarms, reports, and views.
Figure 9-1 360 Device View Icon
To display the 360 device details view:
Step 1
Navigate to a device hyperlink in one of the following windows:
–
Devices > Devices tab
–
Alarms/Events > Alarms tab
–
Reports > Any report
–
Views > Any view
–
Dashboards > Any dashboard
Step 2
Move your cursor over a device link and click the display icon to the right of the link.
The 360 Network Device Details window (Figure 9-2) appears. Information displayed in the window includes:
- Device name and IP address.
- Software and polling information
- CPU and memory utilization, and the last total poll response, CPU and memory utilization is the average for the specified time period, The timestamp is the beginning of the interval.
- Device alarms, events, availability, collector status, polling information, and annotation.
- Tools that display device alarms in the Alarms window, display the Cisco support website, and run ping and traceroute commands on the device.
Note
The data and tabs displayed depend on the particular device and information that is available for it. Data Center devices and device elements, such as hypervisors, UCS server blades, VM, and other Data Center elements will display information specific to the Data Center element, and not necessarily information that appears for standard network devices.
Figure 9-2 360 Network Device Details
|
Alarms, support, ping, and traceroute tools. |
|
CPU and memory utilization, last poll response. |
|
Device name and IP address |
|
Alarms, Events, Availability, Collector Status, Polling Information, and Annotation tabs. |
|
Software, status, and polling information. |
|
Device information display. |
Note
Not all information is displayed for Basic users.
Step 3
To close the window, click the Close icon at the top right. The window also closes automatically when you navigate to other windows.
Displaying Device Information at the Device Level
Prime Performance Manager allows you to drill down to individual devices and review additional parameters and details not displayed at the network level. including device-level reports, dashboards, properties, event history, alarms, status, and availability.
Device time stamps can be displayed in the device time zone by enabling the Display Device Level Data in Device Time Zone option in User Preferences. Time stamps affected by this option include the time stamp displayed in report titles, calendar popup selections, summary table maximum date strings, graph date strings, tooltip hover information. the Timestamp column in report table format, and the Timestamp values in exported CSV files. For information about changing user preferences, see Customizing the GUI and Information Display.
To display individual device information:
Step 1
Navigate to one of the following:
- Performance menu > Reports > Choose a report. > Click a device link in the report.
- Network menu > Devices
- Network menu > Alarms/Events
- System menu > Gateways/Units
- If you attached devices to custom report views, display the view or subview. (For information about custom report views, see Creating and Managing Custom Report Views.)
Step 2
Click a device link or, if you are displaying a custom view, display the view or subview containing the device.
At the individual device view, the following is displayed:
Note
In addition to the menus listed below, custom report views and subviews with attached devices will display a View and View Editor menus. For information, see Creating and Managing Custom Report Views.
- Reports—Allows you display any report that is generated for the device. The reports that are available depend upon the device hardware and network provisioning. In many cases, you can drill down to detailed device component reports, for example, interfaces and ports. For additional information about the Prime Performance Manager reports, see Chapter7, “Managing Reports, Dashboards, and Views”
- Dashboards—Allows you display any dashboard that can be generated for the device based upon the hardware and technologies that are provisioned for it. Like reports, you can often drill down to view device component dashboards. For additional information about the Prime Performance Manager dashboards, see Managing Dashboards.
- Details—Displays the detailed device information listed in Table 9-11 .
Table 9-11 Device Details at the Device Level
|
|
|
Toolbar |
Actions menu |
Allows you to modify devices by choosing a device in the table, then selecting an option. For a description of actions you can perform, see Managing Individual Devices. |
Ping |
Pings the selected device. |
Traceroute |
Runs a traceroute to the selected. |
Launch |
Launches the device home page. |
Pause |
Pauses the refreshing of data displayed in the GUI. |
Refresh Interval |
Sets the time the GUI page will be refreshed. The range is 30 to 900 seconds. The default is 180 seconds. |
Naming Information |
Display Name |
The device display name. |
Custom Name |
The custom device name, if one is defined. If not, this field displays Unknown. |
Sync Name |
If devices were imported from Prime Network, the device name (or business tag, if defined) as it appears in Prime Network. |
IP Address or Host Name |
The device IP address or DNS name, as discovered by Prime Performance Manager. |
System Name |
The name set on the router and returned, using the SNMP variable sysName. |
Unit |
The name of the unit to which the device belongs. |
Homepage |
Provides a link to the device home page. |
Report Policy |
If the device has a report policy, the policy is displayed here. Clicking its link takes you to the policy on the Report Policy tab. Other entries you might see:
- Default—The device is pulling the system default report policy.
- This Device Only—A custom report policy was set for only that device by going into the Report Status tab and customizing it for the device.
For information about report policies, see Creating Report Policies. |
Polling Group |
The polling group to which the device is assigned. For information about polling groups, see Creating and Editing Device Polling Groups. |
Status Information |
Sending Alarms |
Indicates whether the device is sending alarms, Yes or No. |
Alarm Severity |
Indicates the alarm severity of the object. |
Maintenance Mode |
Indicates whether maintenance mode is enabled for the device. If maintenance mode is enabled, alarms and report polling are disabled. The Status Information area displays the dates the alarms are disabled, and the dates maintenance mode is enabled in red text. |
Device Status |
Current device status:
- Active—The device is active.
- Discovering—Prime Performance Manager is in the process of discovering the device; not all device details are known.
- Polling—Prime Performance Manager is polling the device.
- Unknown—Prime Performance Manager does not have the device details, possibly because connectivity is lost or other reasons.
- Unmanaged—Indicates a Prime Network device that is not managed by Prime Network.
- Waiting—Prime Performance Manager has sent a polling request and is waiting for a response.
- Warning—The device is in a warning status.
|
Last Status Change |
Date and time when the device status was last changed. |
Status Reason |
Reason for the current device status. (If you cannot see all of the status reason text, place the cursor over the cell to see the full text in a tooltip.) A list of possible reasons is provided in the stateReasons.html, located at: /opt/CSCOppm-gw/apache/share/htdocs/eventHelp. |
Last Poll IP Address |
The IP address that was last polled |
Device Performance |
Memory Utilization |
Displays the memory utilization at the time of the poll. If the device has multiple memory pools, the utilization is the average of the pools. Text color is based on the Enabled Colors user preference:
- Off—Text is not color coded.
- On—Text follows the ascending metric.
- Red/Orange/Gold Only—follows the ascending metric, with the exception of green.
For information about user preferences, see Customizing the GUI and Information Display. |
CPU Utilization |
Displays the memory utilization at the time of the poll. If the device has multiple CPUs, the utilization is the average of the CPUs. Text color is also based on the Enabled Colors user preference. |
Descriptive Information |
Contact |
The contact person for the managed device and contact information, if available. If the contact details are not available, this field displays Unknown. |
Software Version |
The software version (for example, the ONS package or IOS version) that is installed on the device. |
Software Description |
Comprehensive information about the software that is installed on the device. |
Device Type |
The device type, which is usually based on the device family, for example, Cisco1706 for Cisco 1706 Series Routers. If the device family type is not known, IP Device is displayed. Prime Performance Manager gateway and unit servers are listed as ciscoGatewayServer and ciscoUnitServer. |
Location |
The device physical location. If the device location details are not available, this field displays Unknown. |
Vendor |
The device manufacturer or network technology. |
Uptime Information |
Uptime |
The time the device has been up, in days, hours, minutes, and seconds. |
Reboot Time |
The date and time of the last device reboot. |
Reboot Reason |
The reason for the last reboot of the device. |
Unique Device Identifier (UDI) |
Name |
The device name. |
Description |
The device description. |
Product ID |
The device product ID number. |
Version ID |
The device version number. |
Serial Number |
The device serial number. |
- Data Collection—Displays the device data collection information shown in Table 9-12 .
Table 9-12 Device Data Collection at the Device Level
|
|
|
Toolbar |
Actions menu |
Allows you to modify devices by choosing a device in the table, then selecting an option. For a description of actions you can perform, see Managing Individual Devices. |
Ping |
Pings the selected device. |
Traceroute |
Runs a traceroute to the selected. |
Launch |
Launches the device home page. |
Pause |
Pauses the refreshing of data displayed in the GUI. |
Refresh Interval |
Sets the time the GUI page will be refreshed. The range is 30 to 900 seconds. The default is 180 seconds. |
Polling Information |
Status |
Indicates the device status. See Table 9-2 for a list of device statuses. |
Report Polling |
Indicates whether report polling is enabled for this device. |
First Discovered |
The date and time when Prime Performance Manager first discovered the device. |
Uptime |
The device uptime, that is, the time since the last startup or reboot. |
Last Poll IP Address |
The last IP address that was polled for this device. |
Last Capability Full Poll Time |
The last time the device capabilities were assessed. This query is performed once every 24 hours at a minimum. It also occurs when Prime Performance Manager detects a device configuration or entity change, or when the SystemCapabilities or UserCapabilities file changes. |
Last Full Poll Time |
The date and time of the last full poll of the device for device-related MIBs. |
Last Poll Response (secs) |
The time, in seconds, taken by this device to respond to the last poll request. |
Avg Poll Response (secs) |
The average time, in seconds, taken by this device to respond to poll requests. |
Polling Group |
The polling group to which the device is assigned. For information about polling groups, see Creating and Editing Device Polling Groups. |
Report Policy |
If the device has a report policy, the policy is displayed here. Clicking its link takes you to the policy on the Report Policy tab. Other entries you might see:
- Default—The device is pulling the system default report policy.
- This Device Only—A custom report policy was set for only that device by going into the Report Status tab and customizing it for the device.
For information about report policies, see Creating Report Policies. |
Collector Status |
SNMP |
Indicates whether data has been retrieved through SNMP. Will be Active unless data has never been retrieved using SNMP. |
|
SMI |
Indicates whether Storage Management Institute statistics were collected. |
|
Hypervisor |
Indicates whether a hypervisor is active. This will normally be active for VM devices. |
|
CLI |
Indicates whether an XML poll was performed:
- Active—A successful XML poll has occurred.
- Not Active—An XML poll failed because of credentials.
|
|
NetFlow |
Indicates whether NetFlow data was collected.
- Active—The device is configured to export NetFlow and the collector is receiving the flows regularly.
- Not Active—The device is configured for NetFlow but it might not be receiving flows recently.
|
|
JMX |
Indicates whether Java Management Extensions data was collected. |
|
Data Collection Manager |
Indicates whether Data Collection Manager bulk statistics were collected. |
|
Collectd Stats |
Indicates whether collectd statistics were collected. |
|
StarOS Bulk Stats |
Indicates whether StarOS bulk statistics were collected. |
|
RMS Log |
Indicates whether the RAN Management System log is active. |
|
ICMP |
Indicates whether Internet Control Message Protocol (ICMP) statistics were collected. |
|
Small Cell |
Indicates whether small cell bulk statistics were collected. |
|
Generic CSV |
Indicates whether generic CSV statistics were collected. |
|
GMOND |
Indicates whether ganglia monitoring daemon (gmond) statistics were collected. |
|
Internal |
Indicates whether internal statistics were collected. |
|
Optical Bulk Stats |
Indicates whether optical bulk statistics were collected. |
IP Addresses for Management |
IP Address |
IP address(es) associated with this device, including the primary address and all backup IP addresses. |
Last Full Poll Time |
The date and time of the last full poll of the device. If the IP address has never been polled, Prime Performance Manager displays Never Polled. |
Manageable |
Indicates whether the IP address is used for polling, Yes or No. |
- Events—Displays events that have occurred on the device. For a list of event parameters, see Table 10-1.
- Alarms—Displays alarms that have been raised on the device. For a list of event parameters, see Table 10-1.
- Thresholds—Displays thresholds that apply to the device. For information, see Displaying Thresholds by Device.
- Report Status—Displays the reports available for the device.
- Availability—Displays device availability information in table and bar chart format. Availability increments include current and last 15 minutes, hour, day, week and month.
- Star Graphs—Allows you to add selected charts from multiple device reports and effectively create a custom report view for a specific device. For information, see Creating Custom Device Star Graphs.
- Device Status—Displays information from the Details, Data Collection, Events, Alarms, and Availability tabs in a snapshot device status view.
- Probes—Displays any probes that are defined for the devices. Actions and fields include:
–
Add Probe—Adds a probe to the device. For information, see the Creating Probes.
–
Probe Name—The probe name.
–
Probe Type—The probe type: HTTP, TCP, NTP, DNS, or DHCP.
–
Enable/Disable—Enables or disables the probe.
–
Edit—Displays the Edit [probe type] Probe dialog box where you can edit the probe parameters. For information, see one of the following topics for the probe type:
Creating a DHCP Probe
Creating a DNS Probe
Creating an HTTP Probe
Creating a TCP Probe
Creating an NTP Probe
Note
When you select an individual device, it is added to the Devices navigation list so you can go back to it at any later point during the session. For example, if you select five devices, Device 1, Device 2, Device, 3, Device 4, and Device 5, these devices will appear in the navigation area so you can display them at any point.
Viewing Information in the Device Header
The following device-level tabs, Reports, Dashboards, Details, Data Collection, Events, Alarms, Thresholds, Report Status, Availability, Star Graphs, Device Status, Probes, and Annotation, display summary information about the device. Information includes:
- Device uptime—The Reports and Dashboard headers display time the device has been active since the last startup or reboot.
- Last update—The date and time of the last GUI update displayed. If the gateway and browser are in separate time zones, both times are displayed.
- Device IP or hostname—The device IP address or hostname is displayed in the center of the header. For the reports and dashboards, device components, for example, VMs, blades, are appended to the device IP address or host name with an asterisk, for example,
192.11.11.11 * openstackvm.
- Query interval—The Dashboard header displays the report time period.
- Device and alarm statuses— Icons on the right of the header indicate the device status and highest alarm.
- Report policy—Displayed on the Report Status tab.
- Item count—Displayed on the Events and Alarms tabs.
- Page identifiers—Displayed on the Events, Alarms, Thresholds, and Probes tabs.
Figure 9-3 shows the device header at the network level. Because the browser is in a different time zone than the gateway, two updated dates and times are shown. Other header options include the number of devices selected, the total number of devices, and the page number.
Figure 9-3 Device Header in Network View
|
Last screen update |
|
Total items in Device window |
|
Items selected |
|
Page number |
Figure 9-4 shows the device header at the device level for the Reports tab. The report header displays the report name and report period. The device header displays the device uptime, the device name and, because the report is for a device hypervisor, the hypervisor name. The device highest alarm and status icons are also shown.
Figure 9-4 Device Header in Device View
|
Report title |
|
Device and hypervisor names |
|
Report period |
|
Highest alarm |
|
Device uptime |
|
Device status |
|
Network view tool |
|
|
Creating Probes
A probe is a program or other device inserted at a key network point to monitor and/or collect data about network activity. Probes:
- Show you which protocols are being used on your network, which hosts are sending and receiving data, where the traffic is coming from, and when this occurs.
- Provide an overview of the network throughput and the number of hosts, conversations, and protocols seen on the network.
- Provide an overview of the most active protocols, talkers, listeners, hosts, and conversations on your network.
Prime Performance Manager allows you to create the following probe types:
- Transmission Control Protocol (TCP)
- HyperText Transmission Protocol (HTTP)
- Network Timing Protocol (NTP)
- Dynamic Naming Service (DNS)
- Dynamic Host Configuration Protocol (DHCP)
Probe creation procedures are provided in the following topics:
Creating a DHCP Probe
The DHCP probe helps to discover DHCP servers on the network. The probe broadcasts multiple DHCP request packets from a physical interface. Different request packet types are sent but a DHCP server may respond only to some requests depending on the server configuration.
After sending a request packet, DHCP probe listens for responses. Unknown server responses are captured in logs. As DHCP server broadcasts do not cross IP routers, it locates only servers that are attached to the same physical network as the specified interface.
Although DHCP probe supports monitoring only on a single physical interface, you can install a probe on each physical interface; each monitors a different physical network. When running multiple copies of DHCP probe, be sure to specify the appropriate file for each instance.
Note
Before running DHCP probe on any network other than one for which you are responsible, contact that network’s administrator to take permission for you to run this software on the specified network.
To create a DHCP probe:
Step 1
Log into the Prime Performance Manager GUI as the administrator user.
Step 2
Display the Probe Editor using one of the following:
- From the Network menu, choose Probe Editor, or
- Navigate to the device where you want to add the probe and click the Probes tab.
The Network Probe Editor window appears.
Step 3
On the Probe Editor toolbar, click the Create Probe tool.
Step 4
In the Add Probe dialog box Probe Type field, choose:
- DHCP Probe for a DHCP probe with IPv4 addresses, or
- DHCPv6 Probe for a DHCP probe with IPv6 addresses.
Step 5
If templates exist and you want to apply one, choose the template from the Apply Template list. Otherwise, continue with Step 6.
Step 6
If you want to create a template based on entries, click Create Template. Otherwise, continue with Step 7.
Step 7
Enter the DHCP probe parameters.
- Device—The device associated with the probe that Prime Performance Manager polls for probe data. You can click the field to display a list of valid devices, or type the device name.
- Name—An arbitrary name assigned to the probe. The name should be unique within Prime Performance Manager when prepended with the device name, that is, Node=abc,Probe=xyz.
- Description—An optional description you can add to help identify the probe.
- Enabled—If checked (default), enables the probe.
- Interval (seconds)— The probe interval. Valid values are 1-300 seconds.
- Response Timeout—The amount of time to wait for a response from the probe before a timeout is issued. Valid values are 1-60 seconds.
- DHCP Server IP Address—(DHCP Probe only) Enter the DHCP server IP address associated with this probe.
- Port—Port on which the name server is listening. Port 67 is the default for DHCP probes and port 547 for DHCPv6 probes.
Step 8
Click Save.
The new DHCP probe is created and displayed in the Probe Editor.
Creating a DNS Probe
The DNS probe allows you to query DNS servers. A common check is whether your domain name (www.company.com) still points to your web server IP address. The DNS probe allows you to verify your web site domain names, mail server domain name mappings, DNS zone details, and other DNS information contained in text records. The DNS probe allows local servers to automatically fail or recover based on probe results. Probes are constantly sent to the DNS servers to determine their status. If a DNS server fails to respond to a certain number of probes, it is marked as failed. As soon as the DNS server starts to respond to DNS probes, it is returned to the in-service state. The configuration status helps you to find the load balance other ports on the same servers while you are probing DNS.
To create a DNS probe:
Step 1
Log into the Prime Performance Manager GUI as the administrator user.
Step 2
Display the Probe Editor using one of the following:
- From the Network menu, choose Probe Editor, or
- Navigate to the device where you want to add the probe and click the Probes tab.
The Probe Editor window displays.
Step 3
On the Probe Editor toolbar, click the Create Probe tool.
Step 4
In the Add Probe dialog box Probe Type field, choose DNS.
Step 5
If templates exist and you want to apply one, choose the template from the Apply Template list. Otherwise, continue with Step 6.
Step 6
If you want to create a template based on entries, click Create Template. Otherwise, continue with Step 7
.
Step 7
Enter the DNS probe parameters.
- Device—The device associated with the probe that Prime Performance Manager polls for probe data. If you chose the Probe Editor from the Network menu, you can click the field to display a list of valid devices, or type the device name. If you chose the Probe Editor from the device Probes tab, the device is automatically populated and cannot be changed.
- Name—An arbitrary name assigned to the probe. The name should be unique within Prime Performance Manager when prepended with the device name, that is, Node=abc,Probe=xyz.
- Description—An optional description you can add to help identify the probe.
- Enabled—If checked (default), enables the probe.
- Interval (seconds)— The probe interval. Valid values are 1-300 seconds.
- Response Timeout—The amount of time to wait for a response from the probe before a timeout is issued. Valid values are 1-60 seconds.
- DNS Server IP Address—Enter the DNS server IP address associated with this probe.
- Port—Port on which the name server is listening. This is normally port 53.
- Target Domain—Enter the target web domain address.
- Authoritative Name Server—If the server is a DNS authoritative name server, that is, it is responsible for their supported domains and can delegate authority over subdomains to other name servers, check this box,
- Expected IP Address Table—(optional) The IP addresses you expect to result from the DNS query. Type each entry on a new line.
Step 8
Click Save.
The new DNS probe is created in the Probe Editor.
Creating an HTTP Probe
An HTTP probe establishes a TCP connection and issues an HTTP request to the server for an expected string and status code. Prime Performance Manager compares the received response with the configured codes, looking for a configured string in the received HTTP page, or verifying the hash tag for the HTTP page. If any of these checks fail, the server is marked as failed. Probe credentials are the username and password used for authentication on the server.
You can use the HTTP probe to verify connectivity and monitor the real servers being load balanced. Probes determine the status of each real server in the server farm. For example, if you configure an expected string and status code and the Prime Performance Manager finds them both in the server response, the server is marked as passed. However, if the Prime Performance Manager does not receive either the server response string or the expected status code, it marks the server as failed
To create a HTTP probe:
Step 1
Log into the Prime Performance Manager GUI as the administrator user.
Step 2
Display the Probe Editor using one of the following:
- From the Network menu, choose Probe Editor, or
- Navigate to the device where you want to add the probe and click the Probes tab.
The Probe Editor window displays.
Step 3
On the Probe Editor toolbar, click the Create Probe tool.
Step 4
In the Add Probe dialog box Probe Type field, choose HTTP.
Step 5
If templates exist and you want to apply one, choose the template from the Apply Template list. Otherwise, continue with Step 6.
Step 6
If you want to create a template based on entries, click Create Template. Otherwise, continue with Step 7
.
Step 7
Enter the HTTP probe parameters:
- Device—The device associated with the probe that Prime Performance Manager polls for probe data. If you chose the Probe Editor from the Network menu, you can click the field to display a list of valid devices, or type the device name. If you chose the Probe Editor from the device Probes tab, the device is automatically populated and cannot be changed.
- Name—An arbitrary name assigned to the probe. The name should be unique within Prime Performance Manager when prepended with the device name, that is, Node=abc,Probe=xyz.
- Description—An optional description you can add to help identify the probe.
- Enabled—If checked (default), enables the probe.
- Interval (seconds)— The probe interval. Valid values are 1-300 seconds.
- Open Timeout—The timeout in seconds for opening a connection to the probe, that is, the time the probe waits to open and establish the connection with the server.
- Response Timeout—The amount of time to wait for a response from the probe before a timeout is issued. Valid values are 1-60 seconds.
- IP Address—Enter the HTTP server IP address associated with this probe.
- Port—The TCP port to probe. The range is 0 to 65536.
- Username—(optional) Enter the username associated with the HTTP probe. The maximum length is 64 byte with valid characters.
- Password—(optional) Enter the password for the HTTP probe. The maximum length is 64 byte with valid characters.
- HTTP Header Fields—Click Add Row to add an optional HTTP name and value.
–
Name—The HTTP header name. Any name can be assigned.
–
Value—The HTTP header value. You can enter any of the following.
Accept
Accept Charset
Accept Encoding
Accept Language
Authorization
Cache Control
Connection
Content MD5
Expect
From
Host
If Match
Pragma
Referer
Transfer Encoding
User Agent
For information about HTTP headers, see the W3C RFC 2616 document: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html
- HTTP Request Methods—The HTTP request method. Valid values include:
–
DELETE
–
GET
–
HEAD
–
OPTIONS
–
POST
–
PUT
–
TRACE
Note
If you type in the method, type in a method exactly as it appears in the drop-down list.
- HTTP Version—The HTTP version, either 1.1 or 1.0.
Note
If you type in the version, type in a version exactly as it appears in the drop-down list.
- HTTP Status Code Ranges—(optional) Click Add Row to add expected HTTP status code ranges.
–
Begin—The bottom range of acceptable HTTP Status codes.
–
End— The top range of acceptable HTTP Status codes.
- HTTP Protocol—The HTTP protocol, either HTTP or HTTPS.
Note
If you type in the protocol, you can enter HTTP, HTTPS, http, or https.
- Application—(optional) Enter the web application to test the given IP address.
- Regex—(optional) Enter the regular expression to inspect the returned data from the HTTP port. This field can be edited for valid regular expression syntax.
Step 8
Click Save.
The new HTTP probe is created in the Probe Editor.
Creating a TCP Probe
TCP probes record TCP connection responses to incoming packets. TCP probes connect to the specified device and port, and then execute a script that sends and receives data from the device.
To create a TCP probe:
Step 1
Log into the Prime Performance Manager GUI as the administrator user.
Step 2
Display the Probe Editor using one of the following:
- From the Network menu, choose Probe Editor, or
- Navigate to the device where you want to add the probe and click the Probes tab.
The Probe Editor window displays.
Step 3
On the Probe Editor toolbar, click the Create Probe tool.
Step 4
In the Add Probe dialog box Probe Type field, choose TCP.
Step 5
If templates exist and you want to apply one, choose the template from the Apply Template list. Otherwise, continue with Step 6.
Step 6
If you want to create a template based on entries, click Create Template. Otherwise, continue with Step 7
.
Step 7
Enter the TCP probe parameters.
- Device—The device associated with the probe that Prime Performance Manager polls for probe data. If you chose the Probe Editor from the Network menu, you can click the field to display a list of valid devices, or type the device name. If you chose the Probe Editor from the device Probes tab, the device is automatically populated and cannot be changed.
- Name—An arbitrary name assigned to the probe. The name should be unique within Prime Performance Manager when prepended with the device name, that is, Node=abc,Probe=xyz.
- Description—An optional description you can add to help identify the probe.
- Enabled—If checked (default), enables the probe.
- Interval (seconds)— The probe interval. Valid values are 1-300 seconds.
- Open Timeout—The timeout in seconds for opening a connection to the probe, that is, the time the probe waits to open and establish the connection with the server.
- Response Timeout—The amount of time to wait for a response from the probe before a timeout is issued. Valid values are 1-60 seconds.
- IP Address—Enter the TCP server IP address associated with this probe.
- Port—The TCP port to probe. The range is 0 to 65536.
- Over SSL/TLS—Check this box if the TCP connection employs the Secure Sockets Layer (SSL) or Secure Transport Layer cryptographic protocol.
- Send Data—(optional) Data to send on the TCP port. You can enter up to 255 alphanumeric characters.
- Regex—(optional) A regular expression used to inspect the returned TCP port data.
Step 8
Click Save.
The new TCP probe is created in the Probe Editor.
Creating an NTP Probe
NTP synchronizes computer clocks over a network with a dedicated time server. NTP is required between the source and the target device to provide accurate one-way delay (latency) measurements. Using Prime Performance Manager you can configure NTP probes on the source and target devices.
To create an NTP probe:
Step 1
Log into the Prime Performance Manager GUI as the administrator user.
Step 2
Display the Probe Editor using one of the following:
- From the Network menu, choose Probe Editor, or
- Navigate to the device where you want to add the probe and click the Probes tab.
The Probe Editor window displays.
Step 3
On the Probe Editor toolbar, click the Create Probe tool.
Step 4
In the Add Probe dialog box Probe Type field, choose NTP.
Step 5
If templates exist and you want to apply one, choose the template from the Apply Template list. Otherwise, continue with Step 6.
Step 6
If you want to create a template based on entries, click Create Template. Otherwise, continue with Step 7
.
Step 7
Enter the NTP probe parameters.
- Device—The device associated with the probe that Prime Performance Manager polls for probe data. If you chose the Probe Editor from the Network menu, you can click the field to display a list of valid devices, or type the device name. If you chose the Probe Editor from the device Probes tab, the device is automatically populated and cannot be changed.
- Name—An arbitrary name assigned to the probe. The name should be unique within Prime Performance Manager when prepended with the device name, that is, Node=abc,Probe=xyz.
- Description—An optional description you can add to help identify the probe.
- Enabled—If checked (default), enables the probe.
- Interval (seconds)— The probe interval. Valid values are 1-300 seconds.
- Response Timeout—The amount of time to wait for a response from the probe before a timeout is issued. Valid values are 1-60 seconds.
- NTP Server IP Address—The target IP Address for the probe. This can be one of the IP addresses associated with the device or it may be arbitrary IP address.
- Port—The NTP port to probe. The range is 0 to 65536.
Step 8
Click Save.
The new NTP probe is created in the Probe Editor.