Cisco Prime Performance Manager User Guide, 1.0
Viewing Administrative Information

Table Of Contents

Viewing Administrative Information from the Web Interface

Viewing General Tab Details

Viewing System Messages

Viewing Info Messages

Viewing Error Messages

Viewing Prime Performance Manager User Action Messages

Viewing All Archived Prime Performance Manager Messages

Viewing Console Log Archived Messages

Viewing System Status Information

Viewing System Status

Viewing System Versions

Viewing System Check

Viewing Connected Clients

Viewing System Logs

Viewing the Install Log

Viewing the Console Log

Viewing the Backup Log

Viewing the Command Log

Viewing the Event Automation Log

Viewing the Security Log

Viewing the Web Access Logs

Viewing the Web Error Logs

Viewing Properties

Viewing System Properties

Viewing Server Properties

Viewing Web Configuration Properties

Viewing System Reports Property

Viewing SNMP Tab Details

SNMP Editor Buttons

Add SNMP Entry

SNMP Editor Table

Viewing Unit Editor Tab

Adding a Unit Entry

Viewing Discovery Tab Details

Viewing Prime Network Tab Details

Discover Network Buttons

Load File DialogWindow

Save File Dialog Window

Discovery Seeds Pane

Seed Nodes File: No File Panel

Seed Details Panel

Viewing User Management Tab Details

User Management Buttons

Add New User

Add New User

User Management Table

Update User Window


Viewing Administrative Information from the Web Interface


To access the Administrative page of Prime Performance Manager web interface, click Administrative in the navigation tree in the left pane. The tabs on the Administration page appear in the right pane.

This chapter contains descriptions of these tabs and instructions on:

Viewing General Tab Details

Viewing SNMP Tab Details

Viewing Unit Editor Tab

Viewing Prime Network Tab Details

Discover Network Buttons

Viewing User Management Tab Details


Note If Prime Performance Manager User-Based Access is enabled, only users with authentication level 3 (Network Operator) and higher can see all options.


Viewing General Tab Details

The Prime Performance Manager web interface General tab provides access to Prime Performance Manager system information, including messages, logs, status, and properties.

To view the General tab information, click Administrative in the navigation tree and then click General tab in the right pane. This tab displays the information indicated in Table 6-1.

Table 6-1 General Tab Details 

Pane
GUI Elements
Description
Reference

System Status

System Status

System Versions

System Check

Connected Clients

Displays the output of these system commands:

ppm status

ppm version

ppmCheckSystemLog.txt

ppm who

For details, see Viewing System Status Information.

System Messages

Info Messages

Error Messages

User Actions

Message Archives

Console Log Archives

Displays tabular information on system messages.

For details, see Viewing System Messages.

Properties

System

Server

WebConfig

Reports

Displays the contents of these system property files:

System.properties

Server.properties

WebConfig.properties

Reports.properties

For details, see Viewing System Properties.

System Logs

Install Log

Console Log

Backup Log

Command Log

Event Automation Log

Security Log

Web Access Log

Web Error Log

Displays the contents of these system logs:

cisco_primepm_gw_install.log

sgmConsoleLog.txt

ppmBackupLog.txt

Command Log

eventAutomationLog.txt

sgmSecurityLog.txt

Web Access Logs

Web Error Logs

For details, see Viewing System Logs.


The General tab displays the following:

Viewing System Messages

Viewing System Status Information

Viewing System Logs

Viewing Properties

Viewing System Messages

To view the following Prime Performance Manager system messages from Prime Performance Manager web interface, click Administrative in the navigation tree in the left pane and then click the General tab in the right pane:


Note These messages are related to Prime Performance Manager system itself, not to your network.


Viewing Info Messages

Viewing Error Messages

Viewing Prime Performance Manager User Action Messages

Viewing All Archived Prime Performance Manager Messages

Viewing Console Log Archived Messages

Viewing Info Messages

To view information messages, click the Administrative > General tab. In the right pane, select the Info Messages link from System Messages section.

The System Messages: Last number Info Messages page displays informational messages in the Prime Performance Manager system log. These messages help you to diagnose and correct Prime Performance Manager operational problems. See Table 6-2 for more details.

Table 6-2 Info Message 

Column
Description

Period
(in heading)

Collection period of the table, such as Since Server Restart.

Timestamp
(in heading)

Date and time that Prime Performance Manager last updated the information on the page.

Row

Unique number identifying each entry in the table. You cannot edit this field.

Time

Date and time the message was logged.

To sort the messages by time, click the Time heading.

Source

Source for the message, with the format process.host.id, where:

process is the process that logged the message.

host is the hostname of the process that logged the message.

id is a Prime Performance Manager ID that uniquely identifies the process that logged the message. This is when two or more clients are running on the same node and are connected to the same Prime Performance Manager server.

Task

Task, or thread, that logged the message.

Message

Text of the message.

To sort the messages alphabetically by message text, click the Message heading.


Viewing Error Messages

The System Messages: Last number Error Messages page displays error messages that are stored in Prime Performance Manager system log. These messages help you to diagnose and correct Prime Performance Manager operational problems.

To access this page, click Administrative > General > Error Messages below the System Messages section, See Table 6-3 for more details.

Table 6-3 Error Message 

Column
Description

Period
(in heading)

Collection period of the table, such as Since Server Restart.

Timestamp
(in heading)

Date and time that Prime Performance Manager last updated the information on the page.

Row

Unique number identifying each entry in the table. You cannot edit this field.

Time

Date and time the message was logged.

To sort the messages by time, click the Time heading.

Source

Source for the message, with the format process.host.id, where:

process is the process that logged the message.

host is the hostname of the process that logged the message.

id is a Prime Performance Manager ID that uniquely identifies the process that logged the message. This is when two or more clients are running on the same node and are connected to the same Prime Performance Manager server.

Task

Task, or thread, that logged the message.

Message

Text of the message.

To sort the messages alphabetically by message text, click the Message heading.


Viewing Prime Performance Manager User Action Messages

The System Messages: Last number Action Messages page displays user action messages stored in the Prime Performance Manager system log. These messages help you to diagnose and correct Prime Performance Manager operational problems, and to monitor audit trails of user actions.

To access this page select Administrative > General> User Actions below the System Messages section.

Prime Performance Manager displays the System Messages: Last number Action Messages page. The System Messages: Last number Action Messages page has these sections:

Last Action Messages Menu

Last Action Messages Table

Last Action Messages Menu

By default, Prime Performance Manager displays action messages of all classes on the System Messages: Last number Action Messages page. However, Prime Performance Manager provides menu options that enable you to display messages that pertain only to a specific class on the page. See Table 6-4 for more details.

Table 6-4 Last Action Messages Menu 

Column
Description

Create

Opens the System Messages: Last number Action: specified web page:

Delete

Opens the Delete Messages web page, displaying only Delete action messages.

Discover

Opens the Discover Messages web page, displaying only Discover action messages.

Edit

Opens the Edit Messages web page, displaying only Edit action messages.

Ignore

Opens the Ignore Messages web page, displaying only Ignore action messages.

OverWrite

Opens the OverWrite Messages web page, displaying only OverWrite action messages.

Poll

Opens the Poll Messages web page, displaying only Poll action messages.

Purge

Opens the Purge Messages web page, displaying only Purge action messages.

LogInOut

Opens the LogInOut Messages web page, displaying only Log in and Log out action messages.

All

Opens a web page that displays all action messages.

Request

Opens the Request web page, displaying every user-initiated action messages from the gateway to a unit.


Last Action Messages Table

The Last Action Messages table contains the following items. See Table 6-5 for more details.

Table 6-5 Last Action Messages Table 

Column
Description

Period

Collection period of the table, such as Since Server Restart.

Timestamp

Date and time that the information on the page was last updated by Prime Performance Manager.

Row

Unique number identifying each entry in the table. You cannot edit this field.

Time

Date and time the message was logged.

To sort the messages by time, click the Time heading.


Viewing All Archived Prime Performance Manager Messages

The System Message Archives: All Messages page displays all archived messages in Prime Performance Manager system logs, including:

error

informational

trace

debug

dump

action

SNMP

To access the System Message Archives, select Administrative > Message Archives on the All Messages page.

On the System Message Archives: All Messages page, messages are archived by timestamp.

Each archived file contains all Prime Performance Manager system messages for a single session for the server to which you are connected, and which is currently running on the Prime Performance Manager server. If you restart the server, Prime Performance Manager creates a new file.

To view archived messages, click a timestamp. The System Messages Archive: Last number All Messages page appears that displays all messages that were in the system log at the time specified in the timestamp.

You may see an entry labeled, messageLog-old among a list of files that have timestamps in the filenames. A daily cron job creates the files with the timestamps. The cron job that runs at midnight, searches through the messageLog.txt and messageLog-old.txt files for all entries from the past day.

The messageLog-old.txt file exists only if the size of messageLog.txt exceeds the limit set by the ppm logsize command. Prime Performance Manager lists the contents of messageLog-old.txt because it could contain important data from the day the message log file rolled over. See Table 6-6 for more details.

The Last All Messages table contains this information (without column headers).

Table 6-6 Archived Message 

Description
Information

Index

Message number that Prime Performance Manager assigns to the message.

Time

Date and time the message was logged.

Type

Type of message. Possible types are:

Action

Debug

Dump

Error

Info

SNMP

Trace

Source

Source for the message, with the format process.host.id, where:

process is the process that logged the message.

host is the hostname of the process that logged the message.

id is a Prime Performance Manager ID that uniquely identifies the process that logged the message. This is when two or more clients are running on the same node and are connected to the same Prime Performance Manager server.

Task

Task, or thread, that logged the message.

Message

Text of the message.


Viewing Console Log Archived Messages

The System Console Archives: All Messages page displays all archived system console messages.

To access the System Console Archives: All Messages page, choose Administrative > Console Log Archives.

On the System Console Archives: All Messages page, messages are archived by timestamps. Each archived file contains all Prime Performance Manager system console messages for a single session for the server to which you are connected, and which is currently running on the Prime Performance Manager server. If you restart the server, Prime Performance Manager creates a new file.

To view these archived messages, click a timestamp. The Console Archive: Last number All Messages page appears that displays all console messages that were in the system log at the time specified by the timestamp.

Viewing System Status Information

You can view Prime Performance Manager system status information from Prime Performance Manager web interface by clicking Administrative in the navigation tree in the left pane and then clicking General tab in the right pane:

Viewing System Status

Viewing System Versions

Viewing System Check

Viewing Connected Clients

Viewing System Status

To access system status information, choose Administrative > System Status (Prime Performance Manager might take a few seconds to display this page). This page displays the status of all Prime Performance Manager servers, local clients, and processes.

Viewing System Versions

To access version information, choose Administrative > System Versions (Prime Performance Manager might take a few seconds to display this page). This page displays version information for all Prime Performance Manager servers, clients, and processes.

Viewing System Check

To access system information, choose Administrative > System Check. Prime Performance Manager displays the output from the following command:

/opt/CSCOppm-gw/logs/sgmCheckSystemLog.txt

Viewing Connected Clients

To access connected client information, choose Administrative > Connected Clients. This page lists all Prime Performance Manager clients that are currently connected to the Prime Performance Manager server. It also lists all Solaris and Linux users that are logged into the Prime Performance Manager server.

Viewing System Logs

You can view Prime Performance Manager system logs information from Prime Performance Manager web interface by clicking Administrative in the navigation tree in the left pane and then clicking General tab in the right pane:

Viewing the Install Log

Viewing the Console Log

Viewing the Backup Log

Viewing the Command Log

Viewing the Event Automation Log

Viewing the Security Log

Viewing the Web Access Logs

Viewing the Web Error Logs

Viewing the Install Log

The Install Log displays the contents of Prime Performance Manager installation log file for the server to which you are connected, and which is currently running Prime Performance Manager.

To access the Install Log, choose Administrative > Install Log. You can also view the Console Log with the ppm installlog command.

Viewing the Console Log

The Console Log displays the contents of Prime Performance Manager system console log file for the server to which you are connected, and which is currently running Prime Performance Manager.

The console log file contains error and warning messages from the Prime Performance Manager server, such as those that might occur if the Prime Performance Manager server cannot start. It also provides a history of start-up messages for server processes and the time each message appeared.

To access the Console Log, choose Administrative > Console Log. You can also view the Console Log with the ppm console command.

Viewing the Backup Log

The Backup Log displays the contents of Prime Performance Manager backup log file for the server to which you are connected, and which is currently running Prime Performance Manager.

The default path and filename for the backup log file is /opt/CSCOppm-gw/logs/ppmBackupLog.txt. If you installed Prime Performance Manager in a directory other than /opt, then the backup log file is in that directory.

To access the Backup Log, choose Administrative > Backup Log. You can also view the Backup Log with the ppm backuplog command.

Viewing the Command Log

The Command Log displays the contents of the Prime Performance Manager system command log file for the server to which you are connected, and which is currently running on the Prime Performance Manager server.

The system command log lists all Prime Performance Manager commands that have been entered for the Prime Performance Manager server, the time each command was entered, and the user who entered the command.

To access the Command Log, choose Administrative > Command Log. You can also view the Command Log with the ppm cmdlog command.

The Prime Performance Manager Command Log page appears. The Command Log table contains:

Column
Description

Timestamp

Date and time the command was logged.

To sort the messages by time, click the Timestamp heading.

User Name

User who entered the command.

To sort the commands by user, click the User heading.

Command

Text of the command.

To sort the messages alphabetically by command text, click the Command heading.


Viewing the Event Automation Log

The Event Automation Log displays the contents of the system event automation log file for the server to which you are connected, and which is currently running on the Prime Performance Manager server. The system event automation log lists all messages that event automation scripts generate.

The default path and filename for the system event automation log file is /opt/CSCOppm-gw/logs/eventAutomationLog.txt. If you installed Prime Performance Manager in a directory other than /opt, then the system event automation log file is in that directory.

To access the Event Automation Log, choose Administrative > Event Automation Log. You can also view the Event Automation Log with the ppm eventautolog command.

Related Topics

Viewing the Security Log

Viewing the Web Access Logs

Viewing the Web Error Logs

Viewing the Security Log

The Security Log displays the contents of Prime Performance Manager system security log file for the server to which you are connected, and which is currently running Prime Performance Manager server. The system security log lists:

All security events that have occurred for the Prime Performance Manager server

The time each event occurred

The user and command that triggered the event

The text of any associated message

The default path and filename for the system security log file is /opt/CSCOppm-gw/logs/sgmSecurityLog.txt. If you installed Prime Performance Manager in a directory other than /opt, then the system security log file is in that directory.

To access the Security Log, choose Administrative > Security Log in the System Logs section. You should be an System Administrator to access Security Log. You can also view the Security Log with the ppm seclog command.

The Last Security Entries table contains these columns:

Column
Description

Timestamp

Date and time the security event occurred.

To sort the entries by time, click the Time heading.

User

User who triggered the security event.

To sort the entries by user, click the User heading.

Message

Text of the security event message.

To sort the entries alphabetically by message text, click the Message heading.

Command

Text of the command that triggered the security event.

To sort the entries alphabetically by command text, click the Command heading.


Viewing the Web Access Logs

The Web Access Logs page displays a list of web access log files for the server to which you are connected, and which is currently running the Prime Performance Manager server.

The web access log lists all system web access messages that have been logged for the Prime Performance Manager server, providing an audit trail of all access to the Prime Performance Manager server through the Prime Performance Manager web interface.

The default path and filename for the web access log file is /opt/CSCOppm-gw/apache/logs/access_log. If you installed Prime Performance Manager in a directory other than /opt, then the web access log file is in that directory.

To access the Web Access Logs page, choose Administrative > Web Access Logs. You can also view the Web Access Logs page using the ppm webport command.

Viewing the Web Error Logs

The Web Error Logs page displays a list of web error log files for the server to which you are connected, and which is currently running on the Prime Performance Manager server. The web server error log lists all system web error messages that have been logged for the Prime Performance Manager web server.

You can use the web error log to troubleshoot the source of problems that users may have encountered while navigating Prime Performance Manager web interface.

The default path and filename for the web error log file is /opt/CSCOppm-gw/apache/logs/error_log. If you installed Prime Performance Manager in a directory other than /opt, then the web error log file is in that directory.

To access the Web Error Logs page, choose Administrative > Web Error Logs. You can also view the Web Error Logs page using the ppm webport command.

Viewing Properties

Property files for Prime Performance Manager are in the /opt/CSCOppm-gw/properties directory. You can view the Prime Performance Manager properties from the Prime Performance Manager web interface by clicking Administrative in the navigation tree in the left pane and then clicking the General tab in the right pane:

Viewing System Properties

Viewing Server Properties

Viewing Web Configuration Properties

Viewing Unit Editor Tab

Viewing System Properties

To access the System Properties file, choose Administrative > System in the Properties pane.

Prime Performance Manager displays the contents of the /opt/CSCOppm-gw/properties/System.properties file.

The System Properties file contains Prime Performance Manager server and client properties that control various Prime Performance Manager configuration parameters. See Table 6-7 for more details.

You can change some of the system properties using these commands:

Table 6-7 System Properties 

To change this system property
Use this Prime Performance Manager command

BACKUP_RMIPORT

ppm serverlist delete, page A-40

BACKUP_SERVER

BACKUP_WEBPORT

BADLOGIN_TRIES_ALARM

ppm badloginalarm, page A-10

BADLOGIN_TRIES_DISABLE

ppm badlogindisable, page A-10

CHART_MAX_WINDOW

ppm checksystem, page A-12

CONSOLE_ARCHIVE_DIR_MAX_SIZE

ppm authtype, page A-6

CONSOLE_LOG_MAX_SIZE

ppm consolelogsize, page A-14

CSV_STRING_DELIMITER

 

CW2K_SERVER

ppm datadir, page A-14

CW2K_WEB_PORT

CW2K_SECURE_WEB_PORT

JSP_PORT

ppm jspport, page A-25

LOGAGE

ppm msglogage, page A-32

LOGDIR

ppm msglogdir, page A-32

LOGSIZE

ppm logsize, page A-27

LOGTIMEMODE

ppm logtimemode, page A-29

LOG_TROUBLESHOOTING

ppm uninstall, page A-57

PERSISTENCEDIR

ppm datadir, page A-14

PROMPT_CREDS

ppm logsize, page A-27

SBACKUPDIR

ppm backupdir, page A-9

SERVER_NAME

ppm servername, page A-41

SNMPCONFFILE

ppm snmpconf, page A-43

SSL_ENABLE

ppm ssl, page A-51

TRAP_LIST_ENABLE

ppm uninstall, page A-57

WEB_PORT

ppm webport, page A-60


Viewing Server Properties

To access the Server Properties file, choose Administrative > Server in the Properties pane. Prime Performance Manager displays the contents of the /opt/CSCOppm-gw/properties/Server.properties file.

The Server Properties file contains various properties that control the Prime Performance Manager server.

You can use Prime Performance Manager commands to change these server properties:

To change this server property
Use this Prime Performance Manager command

SNMP_MAX_ROWS

ppm snmpmaxrows, page A-46


To change poller parameters in the Server Properties file, see the "Changing Prime Performance Manager Server Poller Settings" section on page 4-1.

Viewing Web Configuration Properties

To access the Web Configuration Properties file, choose Administrative > WebConfig in the Properties pane. Prime Performance Manager displays the contents of the /opt/CSCOppm-gw/properties/WebConfig.properties file.

The Web Configuration Properties file contains properties that control the configuration of Prime Performance Manager web interface. For example:

MAX_ASCII_ROWS      = 6000
MAX_HTML_ROWS       = 100

# The selectable page sizes start at MIN_SELECTABLE_PAGE_SIZE and doubles until
# the MAX_SELECTABLE_PAGE_SIZE value is reached
# (e.g. 25, 50, 100, 200, 400, 800)
MIN_SELECTABLE_PAGE_SIZE = 25
MAX_SELECTABLE_PAGE_SIZE = 800
LOG_UPDATE_INTERVAL = 300
WEB_UTIL            = percent
WEB_NAMES           = display
MAX_EV_HIST         = 15000

You can use Prime Performance Manager to change the web configuration properties. See Table 6-8 for more details.

Table 6-8 Web Configuration Properties 

Web Configuration Property
Changing Default Setting

LOG_UPDATE_INTERVAL

To control how often, in seconds, Prime Performance Manager updates certain web output, use the ppm webport command.

The valid range is 1 second to an unlimited number of seconds. The default value is 300 seconds (5 minutes).

MAX_EV_HIST

To set the maximum number of rows for Prime Performance Manager to search in the event history logs, use the ppm maxhtmlrows command.

The event history logs are the current and archived Prime Performance Manager network status logs for status change and SNMP trap messages.

Prime Performance Manager sends the results of the search to the web browser, where the results are further limited by the setting of ppm maxhtmlrows command.

The valid range is one row to an unlimited number of rows. The default value is 15,000 rows.

MAX_HTML_ROWS

To set the maximum number of rows for Prime Performance Manager HTML web output, such as displays of statistics reports, status change messages, or SNMP trap messages, use the ppm maxhtmlrows command.

This lets you select a page size (if you have not explicitly chosen a page size).

After you select a page size from any page, Prime Performance Manager remembers your preference until you delete your browser cookies. The default value is 100 rows.

MIN_SELECTABLE_PAGE_SIZE

This setting determines the minimum page size that you can select from the Page Size drop-down menu.

The page size values start with the MIN_SELECTABLE_PAGE_SIZE and double until they reach the MAX_SELECTABLE_PAGE_SIZE.

MAX_SELECTABLE_
PAGE_SIZE

This setting determines the maximum page size that you can select from the Page Size drop-down menu.

The page size values start with the MIN_SELECTABLE_PAGE_SIZE and double until they reach the MAX_SELECTABLE_PAGE_SIZE.

WEB_NAMES

To specify whether Prime Performance Manager should show real DNS names or display names in web pages, enter the ppm webport command. To show:

The real DNS names of nodes, as discovered by Prime Performance Manager, enter Prime Performance Manager webnames real.

Display names, enter Prime Performance Manager webnames display.

Display names are new names that you specify for nodes. This is the default setting. For more information about display names.

WEB_UTIL

To specify whether Prime Performance Manager should display send and receive as percentages or in Erlangs in web pages, enter the ppm who command. To display:

As a percentage, enter Prime Performance Manager webutil percent. This is the default setting.

In Erlangs (E), enter Prime Performance Manager webutil erlangs.


Each of the web configuration commands requires you to be logged in as the root user, as described in the "Becoming the Root User" section on page 2-2, as described in the "Enabling SSL Support on Gateway in Prime Performance Manager" section on page 3-15.

Viewing System Reports Property

To access the Report Properties file, choose Administrative > Reports in the Properties pane. Prime Performance Manager displays the contents of the /opt/CSCOppm-gw/properties/Reports.properties file.

The Report Properties file contains various properties that can be enabled/disabled in the Prime Performance Manager server. For example:

STATS_REPORTS       = enable

RPT_5MIN_AGE        = 3
RPT_15MIN_AGE       = 3
RPT_HOURLY_AGE      = 7
RPT_DAILY_AGE       = 31

RPT_5MIN_CSV_AGE    = 3
RPT_15MIN_CSV_AGE   = 3
RPT_HOURLY_CSV_AGE  = 7
RPT_DAILY_CSV_AGE   = 31

RPT_TIMEMODE        = 24
NODE_NAME_TYPE      = dnsname

RPT_5MIN_ENABLED    = true
RPT_15MIN_ENABLED   = true
RPT_HOURLY_ENABLED  = true
RPT_DAILY_ENABLED   = true

Viewing SNMP Tab Details

The Prime Performance Manager web interface SNMP tab provides access to SNMP (Simple Network Management Protocol) Editor to edit the SNMP settings. To view the SNMP tab information, click Administrative in the navigation tree and then click the SNMP tab in the right pane. The SNMP tab contains:


Note Prime Performance Manager does not support SNMP v3 devices.


SNMP Editor Buttons

SNMP Editor Table

SNMP Editor Buttons

The SNMP tab contains the following buttons. See Table 6-9 for more details.

Table 6-9 SNMP Editor Buttons 

Button
Description

Add a new SNMP entry

Adds the new SNMP settings to Prime Performance Manager database. It opens Add SNMP Entry window.

To add a new node or range of nodes,:

1. Enter the SNMP information in the appropriate fields of the Add SNMP Entry window

2. Click OK.

The new SNMP settings are added to Prime Performance Manager database and are displayed in the SNMP Editor table in the right pane.

Click Cancel to close the Add SNMP Entry window.

Click Help to display the online help for the window.

Save All SNMP entries

Saves all added SNMP entries.

Reload SNMP entries from the server

Reloads all the SNMP entries from the server.


Add SNMP Entry

The Add SNMP Entry Table 6-10 window contains the following fields

Table 6-10 Add SNMP Entry 

Field or Button
Description

IP Address Range or Hostname

IP address or DNS name of a node or range of nodes. An asterisk (*) indicates a wildcard value.

Read Community

SNMP community name used by the node for read access to the information maintained by the SNMP agent on the node.

Timeout (secs)

Time, in seconds, Prime Performance Manager waits for a response from the node.

Retries

Number of times Prime Performance Manager attempts to connect to the node.

Poll Interval (mins)

Time, in minutes, between polls for the node.

OK

Applies the new SNMP settings to Prime Performance Manager database.

Cancel

Closes the Add SNMP Entry window without applying any changes.

Help

Displays Online help for the current window.


SNMP Editor Table

The SNMP Editor Table 6-11 contains:

Table 6-11 SNMP Editor 

Column
Description

IP Address Range or Hostname

IP address or DNS name of a node or range of nodes. An asterisk (*) indicates a wildcard value.

Read Community

SNMP community name used by the node for read access to the information maintained by the SNMP agent on the node.

Timeout (secs)

Time, in seconds, Prime Performance Manager waits for a response from the node.

Retries

Number of times Prime Performance Manager attempts to connect to the node.

Poll Interval (mins)

Time, in minutes, between polls for the node.

Action

Deletes the entries in the corresponding row.


Viewing Unit Editor Tab

The Unit Editor tab allows you to add a new Unit to a Node that maps to a Gateway. To view the Unit Editor tab information, click Administrative in the navigation tree and then click Unit Editor tab in the right pane. See the Unit Editor tab in Table 6-12

Table 6-12 Unit Editor Tab 

Column
Description

Add a new Node

Adds the new unit to the node. It opens window Adding a Unit Entry.

To add a new unit or range of units,:

1. Enter the IP Address Range or Hostname information in the appropriate fields of the Add Unit Entry window

2. Click OK.

The new unit settings are added to Prime Performance Manager database and are displayed in the Unit Editor table in the right pane.

Click Cancel to close the Add Unit Entry window.

Click Help to display the online help for the window.

Save All Unit entries

Saves all the added Unit entries.

Reload unit entries from the server

Reloads all the Node entries from the server.

Redistribute Nodes to Units

Redistributes the nodes to a unit.


Adding a Unit Entry

The Add Unit Entry window contains the following fields:

Field or Button
Description

IP Address Range or Hostname

IP address or DNS name of a node or range of nodes. An asterisk (*) indicates a wildcard value.

Unit

Selects the Unit to manage the IP Address Range or Hostname defined above

OK

Applies the new SNMP settings to Prime Performance Manager database.

Cancel

Closes the Add SNMP Entry window without applying any changes.

Help

Displays Online help for the current window.


Viewing Discovery Tab Details

The Prime Performance Manager web interface Discovery tab allows you to discover the network. To view the Discovery tab information, click Administrative in the navigation tree and then click Discovery in the right pane. The Discovery tab contains:

Discover Network Buttons

Discovery Seeds Pane

See Discovering Your Network, page 2-4 for more information on Discovery feature.

Viewing Prime Network Tab Details

The Prime Network tab in the Prime Performance Manager web interface allows you to log in to Active Network Abstraction (ANA) to retrieve ANA inventory (IP Address, SNMP Read Community) and discover the nodes.

You can launch Cisco Active Network Abstraction from the Prime Performance Manager user interface. To log into ANA from Prime Performance Manager, the user must have either ANA Administrator or ANA Configurator user privilege with device scope set to all network elements.

To access Prime Network tab, click Administrative in the navigation tree and then click Prime Network tab in the right pane.

The Prime Network Gateway in Table 6-13 contains

Table 6-13 Prime Network Tab 

Column
Description

Host Name or IP Address

Allows you to enter the Prime Network (ANA) Host Name or IP Address.

Port

Allows you to enter values from 1 to 65535. The default ANA web services port is 6081.

User Name

Allows you to enter the username.The user must have either ANA Administrator or ANA Configurator user privilege.

Password

Allows you to enter the password

Strict Sync

Check the check box to allow Prime Performance Manager to manage devices that are in the Prime Network (ANA) inventory.

Uncheck the check box to allow Prime Performance Manager to manage devices that are not in the Prime Network (ANA) inventory.

Import Inventory

Allows Prime Network (ANA) nodes to import and synchronize with Prime Performance Manager.

See Nodes Table, page 5-23 for the list of nodes discovered by Prime Network Gateway.

Cross Launch

Allows to cross launch Prime Network Gateway with Prime Performance Manager.


Strict Sync allows you to discover only Prime Network Gateway type of devices and not other devices. So in Strict Sync mode there is no SNMP (see Viewing SNMP Tab Details) tab and Discovery (see Discover Network Buttons) tabs available to add a node explicitly.


Note Strict Sync depends on Prime Network Gateway for the source of inventory information.


Discover Network Buttons

The Discover Network pane contains the following buttons. See Table 6-14 for more details.

Table 6-14 Discover Network Button 

Button
Description

Load Seeds

Opens Load File DialogWindow window, enabling you to load a seed file into Prime Performance Manager.

Save Seeds

Saves the changes you have made to the chosen seed file.

Save As

Opens the Save File Dialog Window, using which you can save the updated seed file with a new name, or overwrite an existing seed file.

Discover Network

Begins discovering the network.

Click Discover Network to begin Discovery.

If you have not defined at least one seed node in the Seed Settings tab, Prime Performance Manager prompts you to do so.

When Discovery begins:

The Discover Network button changes to Stop Discovery.

The Discovery In Progress message appears in the title bar of all Prime Performance Manager client windows.

Discovery progresses in bursts. You might see a number of updates, followed by a pause, followed by more updates. The information that Prime Performance Manager windows displays, is not fully updated until Discovery is complete.

By default, Discovery times out after 600 seconds (10 minutes). To change the Discovery timeout, change the value of the DISCOVERY_TIMELIMIT entry in the Server.properties file:

If you installed Prime Performance Manager in the default directory, /opt, then the location of the Server.properties file is /opt/CSCOppm-gw/properties/Server.properties.

If you installed Prime Performance Manager in a different directory, then the Server.properties file resides in that directory.

Because Prime Performance Manager is an asynchronous system, with the Prime Performance Manager server contacting clients one at a time, and because clients might run at different speeds, the information that Prime Performance Manager clients display during Discovery might not always be synchronized.

All other Prime Performance Manager windows (Node) are also populated with the newly discovered network data.


Load File DialogWindow

The Load File Dialog window contains the following buttons. See Table 6-15 for more details.

Table 6-15 Load File Dialog Window 

Field or Button
Description

Seed File List

The Seed File List pane contains:

Go up one Folder—Click this icon to go up one folder in the directory structure.

Type—Icon indicating whether the item in the table is a file or a folder.

Name—Name of the seed file or folder.

Last Modified—Date and time the seed file or folder was last modified.

Size (bytes)—Size of the seed file or folder, in bytes.

Make this my preferred startup

Specifies whether the chosen seed file should be loaded automatically whenever this Prime Performance Manager client is started or the Discovery dialog box is opened.

By default, this check box is unchecked for all seed files. That is, no seed file is loaded automatically when Prime Performance Manager client is started or the Discovery dialog box is opened.

OK

Loads the chosen seed file, saves any changes you made to the list of files, and closes the dialog box.

To load a seed file:

Double-click it in the list, select it in the list and click OK,

Or

Enter the name of the file and click OK.

Prime Performance Manager saves any changes you made to the list of files, closes the Load File Dialog: Seed File List dialog box, loads the seed file, and returns to the Discovery dialog box.

Prime Performance Manager lists all of the seed nodes in the seed file in the Seed Nodes pane, and displays details of the SNMP settings for the seed nodes in the Seed Details pane.

Delete

Deletes the chosen file from the seed file list. Prime Performance Manager displays an informational message containing the name and location of the deleted file.

Cancel

Closes the dialog box without loading a seed file or saving any changes to the seed file list.

Help

Displays Online help for the dialog box.


Save File Dialog Window

The Save File Dialog window contains the following buttons. Refer Table 6-16 for more details.

Table 6-16 Save File Dialog Window 

Field or Button
Description

Seed File List

The Seed File List pane contains:

Go up one Folder—Click this icon to go up one folder in the directory structure.

New Folder

1. Click this icon to create a new folder in the current directory.

This action opens the Input dialog box.

2. Enter a folder name and click OK.

The new folder appears in the Save File dialog box.

3. Double-click the folder to open it.

You can save files in this folder or create another folder at this level.

Type—Icon indicating whether the item in the table is a file or a folder.

Name—Name of the seed file or folder.

Last Modified—Date and time the seed file or folder was last modified.

Size (bytes)—Size of the seed file or folder, in bytes.

Filename

Name by which you want to save the seed file.

If you create a new seed filename, you can use any letters, numbers, or characters in the name that are allowed by your operating system.

However, if you include any spaces in the new name, Prime Performance Manager converts those spaces to hyphens. For example, Prime Performance Manager saves file a b c as a-b-c.

Make this my preferred start option

Specifies whether the chosen seed file should be loaded automatically whenever this Prime Performance Manager client is started or the Discovery dialog box is opened.

By default, this check box is unchecked for all seed files. That is, a seed file is not loaded automatically when Prime Performance Manager client is started or when the Discovery dialog box is opened.

OK

Saves the seed file and any changes you made to the seed file list and closes the dialog box.

To save the seed file with a new name, you can either save the file with:

A completely new name. Enter the new name and click OK.

An existing name, overwriting an old seed file. Select the name in the list and click OK.

Prime Performance Manager:

1. Saves the seed file with the new name

2. Saves any changes you made to the list of files

3. Closes the Save File Dialog: Seed File List dialog box

4. Returns to the Discovery dialog box

Delete

Deletes the chosen file from the seed file list. Prime Performance Manager displays an informational message containing the name and location of the deleted file.

Cancel

Closes the dialog box without saving the seed file or saving any changes to the seed file list.

Help

Displays Online help for the dialog box.


Discovery Seeds Pane

The Discovery Seeds pane contains:

Seed Nodes File: No File Panel

Seed Details Panel

Seed Nodes File: No File Panel

The Seed Nodes File: No File panel contains the following buttons. See Table 6-17 for more details.

Table 6-17 Seeds Nodes File 

Field or Button
Description

IP Address, Address Range, Subnet, CIDR, or DNS Hostname

Address or name of the chosen seed node.

To create a new seed file, enter the name or address of a seed node in this field. Examples of acceptable input include:

IP Address: 1.2.3.4 (see the guidelines for IP addresses in).

Address Range: 1.2.3.2-15

Subnet, CIDR: 1.2.3.0/24, 1.2.3.0/255.255.255.0

DNS Hostname: Prime Performance Manager.cisco.com

Add

Adds a new seed node to Prime Performance Manager.

Delete

Deletes the chosen seed node. A confirmation message is displayed before deleting the seed node.


Seed Details Panel

The Seed Details panel contains the following buttons. See Table 6-18 for more details.

Table 6-18 Seed Details Panel 

Field
Description

IP Address Range or Hostname

IP address or DNS name of a node or range of nodes. An asterisk (*) indicates a wildcard value.

Read Community

SNMP community name used by the node for read access to the information maintained by the SNMP agent on the node.

Timeout (secs)

Time, in seconds, Prime Performance Manager waits for a response from the node.

Retries

Number of times Prime Performance Manager attempts to connect to the node.

Poll Interval (mins)

Time, in minutes, between polls for the node.


Viewing User Management Tab Details

Prime Performance Manager allows user management through the web interface. User access must be enabled for this feature. A Level 5 user must be created during installation or post-installation, using Prime Performance Manager CLI as root.

A web user with user management permissions with Prime Performance Manager access Level 5, can add or delete users and modify user passwords and roles/access levels.

To access the User Management, click Administrative in the navigation tree and then click User Management tab in the right pane. This tab displays all users in the system along with the time of their most recent login, their access level, and their account status.

The User Management tab contains:

User Management Buttons

User Management Table

User Management Buttons

The User Management tab contains the following buttons. See Table 6-19 for more details.

Table 6-19 User Management Buttons 

Button
Description



Create a new user account

When the local authentication is enabled, it opens the Add New User window. A password is required when local authentication is enabled.

When the Solaris or Linux authentication is enabled, it opens the Add New User window. However, it does not prompt for passwords since it reuses the OS-based passwords.

To add a new user:

1. Enter the user information in the appropriate fields of the Add New User window

2. Click OK.

The new user is added to Prime Performance Manager database and the new information is displayed in the User Management table.

Click Cancel to close the window.

Click Help to display the online help for the window.



Delete an existing user account

Deletes an existing user. The user interface asks for confirmation and deletes the user.

To delete multiple users, click the check box in the user row and then click the Delete an existing user account button in the toolbar.

Users users selected

Number of currently selected users.

Clear Selection

Deselects the selected list of users.


Add New User

The Add New User window contains the following options when the local authentication is enabled. See Table 6-20 for more details.

Table 6-20 Add New User - Local Authentication Enabled 

Field or Button
Description

Name

Username.

Level

Authentication level for the user. The valid values are:

Basic User, Level 1

Network Operator, Level 3

System Administrator, Level 5

Custom Level 1

Custom Level 2

Password

User's password.

Confirm Password

Retype the password to confirm the new password.

Force user to reset password at login?

Whether to force the user to change the password at the next log in. The default is not to force the user to change the password.

OK

Saves the new user information.

Cancel

Closes the window without saving the changes.

Help

Displays Online help for the window.


Add New User

The Add New User window contains the following options when Solaris or Linux authentication is enabled. See Table 6-21 for more details.

Table 6-21 Add New User - Solaris / Linux Authentication Enabled 

Field or Button
Description

Name

Username.

Level

Authentication level for the user. The valid values are:

Basic User, Level 1

Network Operator, Level 3

System Administrator, Level 5

Custom Level 1

Custom Level 2

Add users not known to system?

Whether to add the users who are not known to the system. The default is not to add the unknown users to the system.

OK

Saves the new user information.

Cancel

Closes the window without saving the changes.

Help

Displays Online help for the window.


User Management Table

The User Management table contains the following buttons. See Table 6-22 for more details.

Table 6-22 User Management Table 

Field or Button
Description

Action

Allows you to change the user's password.

1. Click the Change a user's password icon under the `Action' column,

The Update User Window appears.

2. Enter the new passwords in the appropriate fields of the window and click OK.

Click Cancel to close the window without saving the changes.

Click Help to display the Online help for the window.

User

Prime Performance Manager user for whom a User-Based Access account has been set up.

Last Login

Date and time the user last logged into Prime Performance Manager.

Access Level

Authentication level and number for the user. Valid levels and numbers are:

Basic User, Level 1

Network Operator, Level 3

System Administrator, Level 5

Custom Level 1, 11

Custom Level 2, 12

Account Status

Current status of the user's account. Valid status settings are:

Enabled—The account has been enabled and is functioning normally.

Disabled—The account has been disabled for one of these reasons:

A System Administrator disabled the account. See the "ppm disablepass" section on page A-16 and the "ppm disableuser" section on page A-17 for more information.

Prime Performance Manager disabled the account as a result of too many failed attempts to log in using the account. See the "ppm badlogindisable" section on page A-10 for more information.

Prime Performance Manager disabled the account because it was inactive for too many days. See the "ppm inactiveuserdays" section on page A-23 for more information.

Expired Password

Temporary Password


Update User Window

The Update user window contains the following buttons. See Table 6-23 for more details.

Table 6-23 Update User Window 

Field or Button
Description

Password

Enter the password.

Confirm Password

Retype the password to confirm the new password.

Force user to reset password at login?

Whether to force the user to change the password at the next log in. The default is not to force the user to change the password.

OK

Saves the new user information.

Cancel

Closes the window without saving the changes.

Help

Displays online help for the window.