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 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:
# 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
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:
RPT_HOURLY_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.
|