-
Cisco Prime Performance Manager User Guide, 1.1
-
Preface
-
Prime Performance Manager Overview
-
Managing Gateways and Units Using the Command Line Interface
-
Using the Prime Performance Manager Web Interface
-
Discovering Devices
-
Configuring SSL between Gateways and Units
-
Managing Users
-
Managing Reports and Dashboards
-
Using Summary Lists
-
Using Alarms and Events
-
Configuring Thresholds
-
Viewing Home Page Information
-
Viewing System Logs and Messages
-
Managing Prime Performance Manager Units
-
Configuring Polling Groups
-
Configuring Upstream Alarm Hosts and Tuning Event and Alarm Parameters
-
Configuring Device Access Credentials for Y.1731 and Ethernet Flow Point Reports
-
Configuring Firewalls
-
Backing Up and Restoring Prime Performance Manager
-
Prime Performance Manager and IPv6
-
Commands Reference
-
Glossary
-
Index
-
Feedback
Table Of Contents
Viewing System Properties, Statuses, Messages, and Logs
System Properties, Statuses, Messages, and Logs Overview
Viewing Prime Performance Manager User Action Messages
Viewing All Archived Prime Performance Manager Messages
Viewing Console Log Archived Messages
Viewing Network Status Archives
Viewing the Event Automation Log
Viewing Web Configuration Properties
Viewing System Reports Property
Viewing System Properties, Statuses, Messages, and Logs
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:
•
System Properties, Statuses, Messages, and Logs Overview
Note
System Properties, Statuses, Messages, and Logs Overview
The Prime Performance Manager web interface General tab provides access to Prime Performance Manager system information, including messages, logs, status, and properties.
To view general system information, click Administrative in the navigation tree and then click the General tab in the right pane. This tab displays the information indicated in Table 12-1.
.
Table 12-1 General Tab Details
System Status
•
•
•
•
Displays the output of these system commands:
•
•
•
•
For details, see Viewing System Statuses.
System Messages
•
•
•
•
•
Displays tabular information on system messages.
For details, see Viewing System Messages.
Properties
•
•
•
•
Displays the contents of these system property files:
•
•
•
•
For details, see Viewing System Properties.
System Logs
•
•
•
•
•
•
•
•
Displays the contents of these system logs:
•
•
•
•
•
•
•
•
For details, see Viewing System Logs.
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
•
•
•
Viewing Information 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 12-2 for more details.
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 12-3 for more details
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
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 12-4 for more details.
Last Action Messages Table
The Last Action Messages table contains the following items. See Table 12-5 for more details.
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:
•
•
•
•
•
•
•
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 12-6 for more details.
The Last All Messages table contains this information (without column headers).
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 Network Status Archives
The Network Status Archives page displays all archived network status messages.
To access the System Console Archives: All Messages page, choose Administrative > Network Status Archives.
On the Network Status Archives: All Messages page, messages are archived by timestamps. Each archived file contains all Prime Performance Manager network status 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 Network Status Archive: Last number All Messages page appears that displays all network status messages that were in the system log at the time specified by the timestamp.
Viewing System Statuses
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
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
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, shown in Table 12-7page appears.
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
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:
•
•
•
•
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, the system security log file is in that directory.
To access the Security Log, choose Administrative > Security Log in the System Logs section. You must be an System Administrator to access Security Log. You can also view the Security Log with the ppm seclog command. Table 12-8 shows the Security Log columns.
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
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. Table 12-9 shows commands that you can use to change system properties.
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 change the SNMP_MAX_ROWS property using the ppm snmpmaxrows command (See ppm snmpmaxrows.) To change poller parameters in the Server Properties file, see the "Changing the GUI Polling Refresh Setting" section.
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 = 6000MAX_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 = 25MAX_SELECTABLE_PAGE_SIZE = 800LOG_UPDATE_INTERVAL = 300WEB_UTIL = percentWEB_NAMES = displayMAX_EV_HIST = 15000You can use Prime Performance Manager to change the web configuration properties. See Table 12-10 for more details.
Table 12-10 Web Configuration Properties
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_SIZEThis 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:
•
•
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:
•
•
Each of the web configuration commands requires you to be logged in as the root user, as described in the "Before you begin device discovery, review the devices that Prime Performance Manager officially supports. These can be found at:" section, as described in the "Managing Prime Performance Manager Users" section.
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 = enableRPT_5MIN_AGE = 3RPT_15MIN_AGE = 3RPT_HOURLY_AGE = 7RPT_DAILY_AGE = 31RPT_WEEKLY_AGE = 365RPT_MONTHLY_AGE = 1825RPT_5MIN_CSV_AGE = 3RPT_15MIN_CSV_AGE = 3RPT_HOURLY_CSV_AGE = 7RPT_DAILY_CSV_AGE = 31RPT_WEEKLY_CSV_AGE = 365RPT_MONTHLY_CSV_AGE = 1825RPT_TIMEMODE = 24NODE_NAME_TYPE = dnsnameRPT_5MIN_ENABLED = trueRPT_15MIN_ENABLED = trueRPT_HOURLY_ENABLED = trueRPT_DAILY_ENABLED = trueManaging Log Files
You can use the following commands to change the Prime Performance Manager log file location, file size, time mode, and maximum number of archive days:
•
•
•
•
