-
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
-
FeedbackTable Of Contents
Command Reference
This appendix provides the format and a brief description of Cisco Prime Performance Manager commands, listed alphabetically. Each command is available on the:
•
Server and Solaris or Linux both gateway and unit.
•
•
You can run commands from:
•
where install_directory is the directory where Prime Performance Manager server is installed (by default, /opt/CSCOppm-gw or /opt/CSCOppm-unit)
•
This appendix contains:
General Commands
General commands for Prime Performance Manager include:
Prime Performance Manager
Command Description
Displays the command syntax for the Prime Performance Manager command and all of its options. The function of this command is identical to /opt/CSCOppm-gw/bin/ppm help.
Prime Performance Manager help is network specific, so only the commands pertaining to each network type appear. If you set all network types, you can see all the commands.
Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm addcreds
Syntax
/opt/CSCOppm-gw/bin/ppm addcreds -i ipaddress/hostname [-u user name -n enable_username] [-r protocoltype] [-o port] [-s sub_system]
Command Description
Adds the Telnet and SSH credentials to access the device with the given IP address or host name.
•
•
•
•
•
•
ppm addsnmpcomm
Syntax
/opt/CSCOppm-gw/bin/ppm addsnmpcomm -i ipaddress [-r retry | -t timeout | -p poll] -c community
Command Description
Adds an SNMP configuration to Prime Performance Manager server.
•
•
•
•
•
You do not need to restart Prime Performance Manager server.
Related Topic
ppm addunitconf
Syntax
/opt/CSCOppm-gw/bin/ppm addunitconf {-i ipaddress | -u unitname }
Command Description
Command uses the option -i (ipaddress) and -u (unitname) to add a unit configuration.
ppm adduser
Syntax
/opt/CSCOppm-gw/bin/ppm adduser [username]
Command Description
If you enable Prime Performance Manager User-Based Access, adds the specified user to the authentication list.
When you add a user, Prime Performance Manager prompts you for this information:
•
•
•
–
–
–
–
–
You must log in as the root user to use this command.
Note
Related Topic
•
ppm authtype
Syntax
/opt/CSCOppm-gw/bin/ppm authtype [local | solaris | linux]
Command Description
Configures Prime Performance Manager security authentication:
•
•
–
Or
–
•
Note
You must log in as the root user to use this command.
Related Topic
•
ppm backup
Syntax
/opt/CSCOppm-gw/bin/ppm backup
Command Description
Note
Backs up Prime Performance Manager data files to Prime Performance Manager installation directory. Prime Performance Manager automatically backs up all data files nightly at 1:30 AM. However, you can use this command to back up the files at any other time. If you installed Prime Performance Manager in:
•
•
To restore Prime Performance Manager data files from the previous night's backup, use /opt/CSCOppm-gw/bin/ppm restore command. Do not try to extract the backup files manually.
You must log in as the root user to use this command.
Note
Related Topics
ppm backupdays
Syntax
/opt/CSCOppm-gw/bin/ppm backupdays [days]
Command Description
This command sets the number of days to save backup files on Prime Performance Manager server and client. The default value is one day, but you can configure Prime Performance Manager to save multiple days of backup files.
This command accepts values from 1 to 30 days. If you attempt to set a value outside of this range, Prime Performance Manager responds with this message:
Value out of range of 1-30.Prime Performance Manager stores backup files in the backup directory (see ppm backupdir). Prime Performance Manager uses this file naming convention when there are multiple backup files:
ppm<releasenumber>- [gateway|unit]-backup.tar.[date]
For example:
ppm10-gateway-ems-lnx001-backup.tar[date]
ppm10-unit-ems-lnx001-backup.tar[date]
If the number of backup days is more than one, and you run the /opt/CSCOppm-gw/bin/ppm restore command, Prime Performance Manager prompts you for a server or client backup file to restore from. This is because there would be more than one backup file to choose from). See ppm restore.
The following is an example of setting the number of backup days to five days:
# ./ppm backupdaysCurrent value is: 1Enter number of days to save backup files <1-30>: [1] 5Setting number of days to save backup files to 5 days.In this example, Prime Performance Manager saves backup files for the last five days. Prime Performance Manager deletes backup files that are older than five days.
Note
Related Topic
•
ppm backupdir
Syntax
/opt/CSCOppm-gw/bin/ppm backupdir [directory]
Command Description
Note
You can change the directory in which Prime Performance Manager stores its nightly backup files. The default backup directory is the directory in which Prime Performance Manager is installed. If you installed Prime Performance Manager in:
•
•
If you specify a new directory that does not exist, Prime Performance Manager does not change the directory and issues an appropriate message.
You must log in as the root user to use this command.
Related Topic
ppm backuplog
Syntax
/opt/CSCOppm-gw/bin/ppm backuplog [clear | -r]
Command Description
Uses PAGER to display the contents of the system backup log.
To clear the log, enter /opt/CSCOppm-gw/bin/ppm backuplog clear.
To display the contents of the log in reverse order, with the most recent commands at the beginning of
the log, enter /opt/CSCOppm-gw/bin/ppm backuplog -r.
You must log in as the root user to use this command.
ppm backupstats
Syntax
/opt/CSCOppm-gw/bin/ppm backupstats
Command Description
This command displays statistics on backup process. You must log in as the root user to use this command.
ppm badloginalarm
Syntax
/opt/CSCOppm-gw/bin/ppm badloginalarm [tries | clear]
Command Description
Number of unsuccessful log-in attempts allowed before Prime Performance Manager generates an alarm.
There can be an unlimited number of unsuccessful attempts. The default value is five unsuccessful attempts.
Prime Performance Manager records alarms in the system security log file. 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 resides in that directory.
To view the system security log file, enter /opt/CSCOppm-gw/bin/ppm seclog. You can also view the system security log on Prime Performance Manager System Security Log web page (see Displaying the Contents of the System Security Log).
To disable this function (that is, to prevent Prime Performance Manager from automatically generating an alarm after unsuccessful log-in attempts), enter /opt/CSCOppm-gw/bin/ppm badloginalarm clear.
You must log in as the root user to use this command.
Related Topic
Automatically Disabling Users and Passwords
ppm badlogindisable
Syntax
/opt/CSCOppm-gw/bin/ppm badlogindisable [tries | clear]
Command Description
Number of unsuccessful log-in attempts by a user allowed before Prime Performance Manager disables the user's authentication. To re-enable the user's authentication, use /opt/CSCOppm-gw/bin/ppm enableuser command.
There can be an unlimited number of unsuccessful attempts. The default value is 10 unsuccessful attempts.
To disable this function (that is, to prevent Prime Performance Manager from automatically disabling a user's authentication after unsuccessful log-in attempts), enter /opt/CSCOppm-gw/bin/ppm badlogindisable clear.
You must log in as the root user to use this command.
Related Topic
Automatically Disabling Users and Passwords
ppm certtool
Syntax
/opt/CSCOppm-gw/bin/ppm certtool [clear | delete alias | export alias [-file filename] | import alias [-file filename] | list]
Command Description
If you enable the Secure Sockets Layer (SSL) icon your Prime Performance Manager system, you can use this command to manage SSL certificates on Prime Performance Manager web interface from the command line.
Note
Use these keywords and arguments with this command:
•
The alias argument can be any character string; the hostname of the server from which you are importing the certificate is a good choice.
To import the certificate from a file, specify the optional -file keyword and a filename.
•
To export the certificate to a file, specify the optional -file keyword and a filename.
•
•
•
Solaris Only: You must log in as the root user to use this command in Solaris.
Related Topic
Viewing and Exporting SSL Certificates
ppm crosslaunch
Syntax
/opt/CSCOppm-gw/bin/ppmcrosslaunch [install | uninstall ]
Command Description
Manages the cross launch points for Prime Network (Cisco ANA) through Prime Performance Manager.
install—Creates the cross-launch menu items in Prime Network (Cisco ANA) Network Vision , so Prime Performance Manager reports can be launched from Prime Network.
uninstall— Removes the cross-launch menu items from Prime Network (Cisco ANA) Network Vision.
ppm changes
Command Description
Displays the contents of the Prime Performance Manager CHANGES file. The CHANGES file lists all bugs that have been resolved in Prime Performance Manager, sorted by release. If you installed Prime Performance Manager in:
•
•
ppm checksystem
Command Description
Checks the system for a server installation and reviews the:
•
•
•
•
•
You must log in as the root user to use all features of this command. The logs/troubleshooting folder has limited permissions to read when the user is not a root user.
ppm clitimeout
Syntax
/opt/CSCOppm-gw/bin/ppm clitimeout [mins | clear]
Command Description
Specifies how long, in minutes, an Prime Performance Manager client can be inactive before Prime Performance Manager automatically disconnects it.
This function is disabled by default. If you do not specify this command, clients are never disconnected as a result of inactivity.
If you enter /opt/CSCOppm-gw/bin/ppm clitimeout command, the valid range is one minute to an unlimited number of minutes. No default value exists.
If you enable this function and you want to disable it (that is, never disconnect a client as a result of inactivity), enter /opt/CSCOppm-gw/bin/ppm clitimeout clear command.
You must log in as the root user to use this command.
Related Topic
Automatically Disabling Users and Passwords
ppm cmdlog
Syntax
/opt/CSCOppm-gw/bin/ppm cmdlog [clear | -r]
Command Description
Uses PAGER to display the contents of the system command log. The system command log lists:
•
•
•
To clear the log, enter ppm cmdlog clear.
To display the contents of the log in reverse order, with the most recent commands at the beginning of the log, enter ppm cmdlog -r.
You must log in as the root user to use this command.
ppm compilemibs
Syntax
/opt/CSCOppm-gw/bin/ppm compilemibs
Command Description
Compiles MIB files in the /opt/CSCOppm-gw/etc/mibs folder and generates a compiled output file. During execution the system reports inconsistencies like duplicate varaibles names, duplicate OIDs and missing dependant MIBs. After it has completed, you are prompted to reload the compiled output to the Prime Performance Manager server.
This command is available only on the gateway.
ppm console
Command Description
Displays the contents of the console log file, sgmConsoleLog.latest.
The console log file contains unexpected error and warning messages from Prime Performance Manager server, such as those that might occur if Prime Performance Manager server cannot start.
You must log in as the root user to use this command.
ppm consolelogsize
Syntax
/opt/CSCOppm-gw/bin/ppm consolelogsize [megs]
Command Description
Sets the maximum size (in megabytes) of the console log file.
To view help for this command, include the following parameter: -h.
ppm countnodes
Command Description
Displays the number of nodes in the current Prime Performance Manager database.
You must log in as the root user to use this command.
ppm datadir
Syntax
/opt/CSCOppm-gw/bin/ppm datadir [directory | nostart]
Command Description
Note
Sets the directory in which Prime Performance Manager stores data files. Use this command when you want to move the data directory to a larger filing system to accommodate the increasing size of the directory.
The default directory for data files resides in the Prime Performance Manager installation directory. If you installed Prime Performance Manager in:
•
•
Use this command if you want to store data files in a different directory; for example, in a Network File System location on another server.
After you change the directory, Prime Performance Manager prompts to confirm whether you want to restart Prime Performance Manager server. The new directory takes effect when you restart Prime Performance Manager server.
You must log in as the root user to use this command.
ppm delete
Syntax
/opt/CSCOppm-gw/bin/ppm delete [all | node [all | node [node]...] | sp [all | point-code:net [point-code:net]...] | linkset [all | node/linkset [node/linkset]...]
Command Description
Deletes objects from Prime Performance Manager database.
•
•
•
•
•
•
•
You must log in as the root user to use this command.
ppm deletecreds
Syntax
/opt/CSCOppm-gw/bin/ppm deletecreds -i [ipaddress/hostname] -a
Command Description
Deletes the Telnet and SSH device credentials for the specified device or all credentials on the Prime Performance Manager gateway.
-i ipaddress/hostname—Deletes the Telnet and SSH device credentials for the specified IP address or host name.
-a—Deletes all Telnet and SSH device credentials on the gateway.
ppm deletesnmpcomm
Syntax
/opt/CSCOppm-gw/bin/ppm deletesnmpcomm -i ipaddress
Command Description
Deletes an SNMP configuration from Prime Performance Manager server.
-i ipaddress—The IP address of the device (required)
You do not need to restart Prime Performance Manager server.
Related Topic
ppm deluser
Syntax
/opt/CSCOppm-gw/bin/ppm deluser [username]
Command Description
If you enable Prime Performance Manager user-based access, deletes the specified user from the authentication list. To add the user back to the list, use /opt/CSCOppm-gw/bin/ppm adduser command.
You must log in as the root user to use this command.
Related Topic
Manually Disabling Users and Passwords
ppm deleteunitconf
Syntax
/opt/CSCOppm-gw/bin/ppm deleteunitconf [-i (ipaddress)]
Command Description
This command deletes the existing configuration that specifies the relationship between nodes and their managed units.
ppm disablepass
Syntax
/opt/CSCOppm-gw/bin/ppm disablepass [username]
Command Description
If you enable Prime Performance Manager User-Based Access, and set ppm authtype to local, disables the specified user's authentication and password. Prime Performance Manager does not delete the user from the authentication list.
Prime Performance Manager only disables the user's authentication and password. To re-enable the user's authentication with:
•
•
Note
If you set /opt/CSCOppm-gw/bin/ppm authtype to Solaris or Linux, you cannot use this command; instead, you must manage passwords on the external authentication servers.
You must log in as the root user to use this command. You must also set /opt/CSCOppm-gw/bin/ppm authtype to local.
Related Topic
Manually Disabling Users and Passwords
ppm disableuser
Syntax
/opt/CSCOppm-gw/bin/ppm disableuser [username]
Command Description
If you enable Prime Performance Manager User-Based Access, this disables the specified user's authentication. Prime Performance Manager does not delete the user from the authentication list, Prime Performance Manager only disables the user's authentication. To re-enable the user's authentication with:
•
•
You must log in as the root user to use this command.
Related Topic
Manually Disabling Users and Passwords
ppm discover
Syntax
/opt/CSCOppm-gw/bin/ppm discover [seed-node] [seed-node]...
Command Description
You use this command to discover the network from the command line. Use the seed-node arguments to specify the DNS names or IP addresses of one or more seed nodes.
You must log in as the root user to use this command.
Related Topic
ppm diskmonitor
Syntax
/opt/CSCOppm-gw/bin/ppm diskmonitor [enable | disable | status] | warning [megs] | shutdown [megs] | stopscript [path]
Command Description
Monitors the disk space usage of Prime Performance Manager installed directories. When enabled, a script (diskWatcher.sh) runs every hour to check two thresholds:
•
WARNING: The following partition is getting low on free disk space:/optSpace left = 905 MB•
The parameters of Prime Performance Manager diskmonitor command are:
•
•
•
•
•
•
You must log in as the root user to use this command.
ppm enableuser
Syntax
/opt/CSCOppm-gw/bin/ppm enableuser [username]
Command Description
If you enable Prime Performance Manager user-based access, re-enables the specified user's authentication, which had been disabled either automatically by Prime Performance Manager root user.
The user's authentication is re-enabled with the same password as before.
You must log in as the root user to use this command.
Related Topic
Enabling and Changing Users and Passwords
ppm eventautolog
Syntax
/opt/CSCOppm-gw/bin/ppm eventautolog [clear | -r]
Command Description
Uses PAGER to display the contents of Prime Performance Manager event automation log. The event automation log lists all messages generated by scripts launched by event automation.
To clear the log and restart the server, enter /opt/CSCOppm-gw/bin/ppm eventautolog clear.
To display the contents of the log in reverse order, with the most recent events at the beginning of the log, enter /opt/CSCOppm-gw/bin/ppm eventautolog -r.
You must log in as the root user to use this command.
ppm eventconfig
Syntax
/opt/CSCOppm-gw/bin/ppm eventconfig [view | edit |restore | master]
Command Description
Allows you to manage the event configuration:
•
•
•
•
You must log in as the root user to use this command.
ppm eventtool
Syntax
/opt/CSCOppm-gw/bin/ppm eventtool {-a actionName} {parameters}
Command Description
Invokes Prime Performance Manager event API operations.
These action names (and any corresponding required parameters) can be specified with the -a option:
These parameters can be used:
You must log in as the root user to use this command.
Related Documentation
See http://www.cisco.com/go/performance
ppm evilstop
Command Description
Forcefully stops all Prime Performance Manager servers on the local host.
You must log in as the root user to use this command.
ppm export
Syntax
/opt/CSCOppm-gw/bin/ppm export
Command Description
Exports current Prime Performance Manager data.
You must log in as the root user to use this command.
ppm exportcustnames
Syntax
/opt/CSCOppm-gw/bin/ppm exportcustnames
Command Description
Allows to export custom names for import to another server.
ppm export cw
Syntax
/opt/CSCOppm-gw/bin/ppm export cw
Command Description
Exports current Prime Performance Manager node names, and read and write SNMP community names, in CiscoWorks v2 import format, with fields separated by commas (,). You can export this data to a file, then use the file to import the nodes into the CiscoWorks database.
You must log in as the root user to use this command.
ppm export cwv3
Syntax
/opt/CSCOppm-gw/bin/ppm export cwv3
Command Description
Exports current Prime Performance Manager node names, and read and write SNMP community names, in CiscoWorks v3 import format, with fields separated by commas (,). You can export this data to a file, then use the file to import the nodes into the CiscoWorks database.
You must log in as the root user to use this command.
ppm exportusers
Syntax
/opt/CSCOppm-gw/bin/ppm exportusers
Command Description
Allows to export users for import to another server.
ppm genkey
Syntax
/opt/CSCOppm-gw/bin/ppm genkey[gw|unit|both|]
Command Description
Creates SSL keys and certificates. The command provides an easy way to regenerate SSL keys and certificates after the Prime Performance Manager has been running for a while with SSL enabled. This might be needed if a certificate expires or if you have a policy to regenerate the certificates after a period of time. The command is normally used as:
ppm genkey bothThe both option generates new keys and certificates, then exchanges them between gateway and unit automatically so you can regenerate the set of keys and certifications at one time. If you use only the gw or unit option, you must import the certificates to the other side.
Note
ppm help
Syntax
/opt/CSCOppm-gw/bin/ppm help [keyword]
Command Description
Displays the command syntax for the Prime Performance Manager command and all of its options. The function of this command is identical to Prime Performance Manager.
Prime Performance Manager help is network specific, so only the commands pertaining to each network type appear. If you set all network types, you can see all the commands.
To see the syntax for a specific command, enter /opt/CSCOppm-gw/bin/ppm help and that command. For example, if you enter /opt/CSCOppm-gw/bin/ppm help restart, Prime Performance Manager displays:
ppm restart - Restarts all ppm Servers on the local host.ppm restart web - Restarts Web servers on the local host.ppm restart jsp - Restarts JSP servers on the local host.ppm restart pm - Restarts Process Manager on the local host.Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm importcustnames
Syntax
/opt/CSCOppm-gw/bin/ppm importcustnames [inputfile]
Command Description
Allows to import custom names from another server.
ppm importcw
Syntax
/opt/CSCOppm-gw/bin/ppm importcw [cwfile]
Command Description
Imports node hostname and read-community strings from the CiscoWorks server to Prime Performance Manager.
cwfile—File name of the CiscoWorks export file (export format must be in CSV file format).
You must log in as the root user to use this command. You do not need to restart the server to activate this command. After running this command, Prime Performance Manager discovers the imported nodes.
ppm inactiveuserdays
Syntax
/opt/CSCOppm-gw/bin/ppm inactiveuserdays [days | clear]
Command Description
If you enable Prime Performance Manager user-based access, number of days a user can be inactive before disabling that user account.
This function is disabled by default. If you do not specify this command, user accounts are never disabled as a result of inactivity.
If you enter the ppm inactiveuserdays command, the valid range is one day to an unlimited number of days. There is no default setting.
If you have enabled this function and you want to disable it (that is, prevent Prime Performance Manager from automatically disabling user accounts as a result of inactivity), enter /opt/CSCOppm-gw/bin/ppm inactiveuserdays clear.
To re-enable the user's authentication, use /opt/CSCOppm-gw/bin/ppm enableuser command.
You must log in as the root user to use this command.
Related Topics
•
•
ppm installlog
Syntax
/opt/CSCOppm-gw/bin/ppm installlog [server | client]
Command Description
Displays the latest install log for the server or client. If you do not specify server or client, displays the latest install log for both the server and client.
You must log in as the root user to use this command.
ppm inventoryimport
Syntax
/opt/CSCOppm-gw/bin/ppm inventoryimport [- strictSync | - looseSync]
Command Description
Imports device information from Prime Network (Cisco ANA) device inventory.
strictSync — In Strict Synchronization mode, only Prime Network type of devices are discovered.
looseSync — In Loose Synchronization mode, beside the devices imported from Prime Network, Prime Performance Manager can manage devices that are not in Prime Network inventory.
ppm iosreport
Syntax
/opt/CSCOppm-gw/bin/ppm iosreport
Command Description
Lists the IOS versions of all devices that are managed by Prime Performance Manager. The command's CSV output format is:
node name, custom name, node type, IOS version, serial number, system name, system location. IP address
Note
ppm ipaccess
Syntax
ppm ipaccess [add [ip-addr] | clear | edit | list | rem [ip-addr] | sample]
Command Description
You use this command to create and manage a list of client IP addresses that can connect to the Prime Performance Manager server.
The list of allowed client IP addresses resides in the ipaccess.conf file. By default, when you first install Prime Performance Manager, the ipaccess.conf file does not exist and all client IP addresses can connect to Prime Performance Manager server.
To create the ipaccess.conf file and specify the list of allowed client IP addresses, use one of these keywords:
•
•
•
•
•
•
Any changes you make take effect when you restart Prime Performance Manager server.
See Implementing Secure User Access for more information about using this command.
You must log in as the root user to use this command.
ppm ipslaftpfilesize
Syntax
/opt/CSCOppm-gw/bin/ppm ipslaftpfilesize [file size in bytes]
Command Description
When an IP SLA probe sends FTP transfer requests to a remote server, it retrieves a file with a specified size from the FTP server. This command tells Prime Performance Manager the size of the file, so it can compute the transfer rate. Unless you use this command to specify otherwise, Prime Performance Manager assumes the FTP file size is 1 MB.
Note
ppm jspport
Syntax
/opt/CSCOppm-gw/bin/ppm jspport [port-number]
Command Description
Sets a new port number for the JSP server, where port-number is the new, numeric port number. Prime Performance Manager verifies that the new port number is not already in use.
This command is needed only if you change the port number after you install Prime Performance Manager. This is because another application must use the current port number.
The new port number must contain only numbers. If you enter a port number that contains nonnumeric characters, such as ppm13, an error message appears, and Prime Performance Manager returns to the command prompt without changing the port number.
You must log in as the root user to use this command.
ppm keytool
Syntax
/opt/CSCOppm-gw/bin/ppm keytool [clear | genkey | import_cert cert_filename | import_key key_filename cert_filename | list | print_csr | print_crt]
Command Description
If you implement SSL in your Prime Performance Manager system, manages SSL keys and certificates on Prime Performance Manager server.
Use these keywords and arguments with this command:
•
•
•
•
•
•
•
You must log in as the root user to use this command.
Related Topic
Managing Prime Performance Manager Users
ppm listusers
Syntax
/opt/CSCOppm-gw/bin/ppm listusers [username]
Command Description
If you enable Prime Performance Manager User-Based Access, lists all currently defined users in the authentication list, including this information for each user:
•
•
•
•
To list information for a specific user, use the username argument to specify the user.
You must log in as the root user to use this command.
Related Topic
Listing All Currently Defined Users
ppm logger
Command Description
Displays the system messages messageLog.txt file with tail -f.
To stop the display, press Ctrl-C.
ppm logsize
Syntax
/opt/CSCOppm-gw/bin/ppm logsize [number-of-lines]
Command Description
Sets the maximum size for truncating and rolling log files.
•
•
If you enter this command without the number-of-lines argument, Prime Performance Manager displays the current maximum number of lines. You can change this value.
The message and network log process archives the log file when the maximum number of lines is reached. The filename format of archived log files is:
•
or
•
where:
•
•
•
•
•
•
When messageLog.txt or networkLog.txt reaches the number of lines specified by /opt/CSCOppm-gw/bin/ppm logsize command, Prime Performance Manager creates a new log archive file by using the filename format above.
When the maximum number of lines is reached, the log filename contains a counter value to differentiate itself from other archived files (for example, messageLog.2011:0328:1427:1.txt.Z and messageLog.2011:0328:1427:2.txt.Z).
The default value for number-of-lines is 500,000 lines.
The valid range is 1,000 lines to an unlimited number of lines. The default value is 500,000 lines. If you specify a larger file size for the log file, the log file and its copy require proportionally more disk space.
When changing the number of lines to display, remember that every 5,000 lines require approximately 1 MB of disk space. You need to balance your need to refer to old messages against the amount of disk space they occupy.
Note
You must log in as the root user to use this command. If you change the number-of-lines value, you must restart the server (/opt/CSCOppm-gw/bin/ppm restart).
ppm logtimemode
Syntax
/opt/CSCOppm-gw/bin/ppm logtimemode [12 | 24]
Command Description
Sets the time mode for dates in log files:
•
•
You must log in as the root user to use this command.
ppm maxhtmlrows
Syntax
/opt/CSCOppm-gw/bin/ppm maxhtmlrows [number-of-rows]
Command Description
Sets the maximum number of rows for Prime Performance Manager HTML web output; for example, statistics reports, status change messages, or SNMP trap messages.
Note
If you enter this command without the number-of-rows argument, Prime Performance Manager displays the current maximum number of rows. You can then change that value or leave it. The valid range is one row to an unlimited number of rows. The default value is 100 rows.
You must log in as the root user to use this command.
Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm mldebug
Syntax
/opt/CSCOppm-gw/bin/ppm mldebug [mode]
Command Description
Sets the mode for logging Prime Performance Manager debug messages:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
This command can adversely affect Prime Performance Manager performance. Use this command only under guidance from the Cisco Technical Assistance Center (TAC).
You must log in as the root user to use this command.
ppm modifysnmpcomm
Syntax
/opt/CSCOppm-gw/bin/ppm modifysnmpcomm -i ipaddress {-r retry | -t timeout | -p poll -c community}
Command Description
Modifies an existing SNMP configuration on Prime Performance Manager server.
•
•
–
–
–
–
You do not need to restart Prime Performance Manager server.
Related Topic
ppm modifyunitconf
Syntax
/opt/CSCOppm-gw/bin/ppm modifyunitconf {-i ipaddress | -u unitname }
Command Description
Command uses the option -i (ipaddress) and -u (unitname) to modify a unit configuration.
ppm motd
Syntax
/opt/CSCOppm-gw/bin/ppm motd [cat | disable | edit | enable]
Command Description
Manages Prime Performance Manager Message of the Day file, which is a user-specified Prime Performance Manager system notice. You can set the Message of the Day to inform users of important changes or events in Prime Performance Manager system.
The Message of the Day also provides users with the chance to exit Prime Performance Manager or GTT client before launching.
If you enable the Message of the Day, it appears whenever a user attempts to launch an Prime Performance Manager or GTT client. If the user:
•
•
Use these keywords with this command:
•
•
•
•
You must log in as the root user to use this command.
Related Topic
Displaying a Message of the Day
ppm msglog
Syntax
/opt/CSCOppm-gw/bin/ppm msglog [clear | -r]
Command Description
Uses PAGER to display the contents of the system message log.
To save the current contents of the log, clear the log, and restart the server, enter /opt/CSCOppm-gw/bin/ppm msglog clear.
To display the contents of the log in reverse order, with the most recent messages at the beginning of the log, enter /opt/CSCOppm-gw/bin/ppm msglog -r.
You must log in as the root user to use this command.
ppm msglogage
Syntax
/opt/CSCOppm-gw/bin/ppm msglogage [number-of-days]
Command Description
Sets the maximum number of days to archive all types of log files before deleting them from Prime Performance Manager server.
If you enter this command without the number-of-days argument, Prime Performance Manager displays the current maximum number of days. You can then change that value or leave it. The valid range is one day to an unlimited number of days. The default value is 31 days.
The start date for aging out and deleting files is always yesterday at 12 AM. For example, say that you set the value to one day and you run the ppm msglogage command at 3 PM on January 10th.
To find files that will be deleted by the aging process, count back to 12 AM on January 10th, then add the number of days set in the command. In this example, we added one more day, so any file with an earlier timestamp than January 9th at 12 AM will be removed.
You must log in as the root user to use this command.
ppm msglogdir
Syntax
/opt/CSCOppm-gw/bin/ppm msglogdir [directory]
Command Description
Note
Changes the default location of all Prime Performance Manager system message log files. By default, the system message log files reside on Prime Performance Manager server at /opt/CSCOppm-xxx/logs. Where xxx denotes a unit or gateway.
Note
After you change the directory, Prime Performance Manager asks if you want to restart Prime Performance Manager server. The new directory takes effect when you restart Prime Performance Manager server.
You must log in as the root user to use this command. If you change to a default location outside Prime Performance Manager, you must have appropriate permissions for that location.
ppm netlog
Syntax
/opt/CSCOppm-gw/bin/ppm netlog [clear | -r]
Command Description
Uses PAGER to display the contents of the network status log. To:
•
•
You must log in as the root user to use this command.
ppm netlogger
Server Only
Command Description
Displays the current contents of the network status log file with tail -f command.
To stop the display, enter Ctrl-c.
ppm newlevel
Syntax
/opt/CSCOppm-gw/bin/ppm newlevel [username]
Command Description
If you enable Prime Performance Manager User-Based Access, changes the authentication level for the specified user. Valid levels are:
•
•
•
•
You must log in as the root user to use this command.
Related Topic
Enabling and Changing Users and Passwords
ppm osinfo
Command Description
Depending on the networks that you have set, displays the operating system versions of software that Prime Performance Manager supports.
ppm passwordage
Note
Syntax
/opt/CSCOppm-gw/bin/ppm passwordage [days | clear]
Command Description
If you enable Prime Performance Manager User-Based Access and you set /opt/CSCOppm-gw/bin/ppm authtype to local, number of days allowed before forcing users to change passwords. The number of days start to accrue beginning yesterday at 12 AM.
Note
This function is disabled by default. If you do not specify this command, users will never need to change their passwords.
If you enter /opt/CSCOppm-gw/bin/ppm passwordage command, the valid range is one day to an unlimited number of days. No default setting exists.
If you enabled this function and you want to disable it (that is, prevent Prime Performance Manager from forcing users to change passwords), enter /opt/CSCOppm-gw/bin/ppm passwordage clear.
Note
You must log in as the root user to use this command.
Related Topic
Automatically Disabling Users and Passwords
ppm patchlog
Syntax
/opt/CSCOppm-gw/bin/ppm patchlog
Command Description
Uses PAGER to display the contents of the patch log, which lists the patches that you installed on Prime Performance Manager server.
The default path and filename for the patch log file is /opt/CSCOppm-gw/install/sgmPatch.log. If you installed Prime Performance Manager in a directory other than /opt, then the patch log file resides in that directory.
You must log in as the root user to use this command.
ppm poll
Syntax
/opt/CSCOppm-gw/bin/ppm poll [node] [node]...
Command Description
You use this command to poll one or more known nodes from the command line. Use the node arguments to specify the DNS names or IP addresses of one or more known nodes.
You must log in as the root user to use this command.
ppm print
Syntax
/opt/CSCOppm-gw/bin/ppm print {all | device | snmp | task | alarmsummary [severity] [quiet]}
Command Description
Displays information about device versions, SNMP settings, running tasks, summary of alarms, or all of this information.
Use these keywords with this command:
•
•
•
•
–
–
•
You must log in as the root user to use this command.
ppm props
Command Description
Displays the contents of the System.properties files for both Prime Performance Manager server and client installs.
You must log in as the root user to use this command.
ppm purgedb
Command Description
Permanently deletes all components in Prime Performance Manager database marked for deletion.
Prime Performance Manager retains information about older objects in its database even after they have been deleted. This is considered a logically deleted state.
Prime Performance Manager retains this information to maintain any user customized data associated with an object (for instance, a customized name) in case the object is rediscovered in the future. Logically deleted data is physically deleted after seven days if it is not reused by then.
You can use the ppm purgedb command to immediately remove this logically deleted data from Prime Performance Manager database.
Unfortunately, this benefit may have a side effect. In certain cases, rediscovery of a deleted object may cause Prime Performance Manager to use obsolete information in the database, rather than the new information. Ultimately, some configuration changes are not detected, and the viewable data from the client application is incorrect.
Note
You must log in as the root user to use this command.
ppm readme
Command Description
Displays the contents of the README file for Prime Performance Manager.
Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm reboot
Command Description
Reboots the Solaris Prime Performance Manager system.
You must log in as the root user to use this command.
ppm redundancygroup
Syntax
/opt/CSCOppm-gw/bin/ppm redundancygroups [list | detail | create | add | remove | delete | redundant | delay | enable | disable | failover | failback | import | export]
Command Description
Creates and manages unit protection groups. Use the following keywords with this command:
•
ppm redundancygroups listgroupA, Enabled, Number of Units: 2groupB, Enabled, Number of Units: 4•
ppm redundancygroups detail groupAID: 54001Name: groupAEnabledCreated: Wed Sep 21 11:44:36 EDT 2011Create User: localhostLast Modified: Wed Sep 21 11:44:36 EDT 2011Last Modified User: localhostEnabledFail over delay: 60Units: [unit1, Primary,unit2, Redundantunit3, Primaryunit4, Primary•
•
•
Note
•
•
•
•
•
•
•
•
•
Related Topic
Creating Unit Protection Groups
ppm reloadmibs
Syntax
/opt/CSCOppm-gw/bin/ppm reloadmibs
Command Description
Command to reload the snmpinfo.dat file
ppm repdir
Syntax
/opt/CSCOppm-gw/bin/ppm repdir [dir] [nostart]
Command Description
Command to set directory used for reports. You must log in as the root user to use this command.
ppm rephelp
Command Description
Displays Help for all commands that are related to Prime Performance Manager reports.
You must log in as the root user to use this command.
ppm restart
Syntax
/opt/CSCOppm-gw/bin/ppm restart [jsp | pm | web]
Command Description
Restarts Prime Performance Manager servers on the local host:
•
•
•
If you do not specify a keyword, /opt/CSCOppm-gw/bin/ppm restart restarts all Prime Performance Manager servers.
You must log in as the root user to use this command.
ppm restore
Syntax
/opt/CSCOppm-gw/bin/ppm restore [ logs | reports | security]
Command Description
Restores Prime Performance Manager data files from a previous backup, stored in Prime Performance Manager installation directory. If you installed Prime Performance Manager in:
•
•
You can restore data files on the same Solaris or Linux server; or, on a different Solaris or Linux server that is running Prime Performance Manager 1.x.
To restore only specific parts of Prime Performance Manager data files, use these keywords:
•
•
•
Note
To change the directory in which Prime Performance Manager stores these backup files, use /opt/CSCOppm-gw/bin/ppm backupdir command.
The server is restarted automatically after running /opt/CSCOppm-gw/bin/ppm restore command.
You must log in as the root user to use this command.
Related Topic
•
ppm restore all
Syntax
/opt/CSCOppm-gw/bin/ppm restore all [nostart]
Command Description
Restores all system files.
The server is restarted automatically after running /opt/CSCOppm-gw/bin/ppm restore all command.
The server is not restarted automatically after running /opt/CSCOppm-gw/bin/ppm restore all nostart command.
You must log in as the root user to use this command.
ppm restoreprops
Command Description
Restores Prime Performance Manager server and client System.properties files and other important configuration files to the backup versions of the files.
You must log in as the root user to use this command.
ppm rootvars
Command Description
Displays the contents of the /etc/CSCOppm.sh file, which determines the root location of Prime Performance Manager server and client installation.
ppm sechelp
Command Description
Displays help for all commands that are related to Prime Performance Manager security.
You must log in as the root user to use this command.
Related Topic
Chapter 6 "Setting Up and Managing Users"
ppm seclog
Syntax
/opt/CSCOppm-gw/bin/ppm seclog [clear | -r]
Command Description
Uses PAGER to display the contents of the system security log.
These security events are recorded in the log:
•
•
•
•
•
•
•
•
To clear the log, enter /opt/CSCOppm-gw/bin/ppm seclog clear.
To display the contents of the log in reverse order, with the most recent security events at the beginning of the log, enter /opt/CSCOppm-gw/bin/ppm seclog -r.
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 resides in that directory.
You must log in as the root user to use this command.
Related Topic
Displaying the Contents of the System Security Log
ppm serverlist delete
Syntax
ppm serverlist delete [servername | all ]
Command Description
Deletes Prime Performance Manager server from the list, where servername is the name of the server deleted.
You must log in as the root user to use this command.
ppm serverlist list
Syntax
/opt/CSCOppm-gw/bin/ppm serverlist list
Command Description
Lists all Prime Performance Manager servers configured.
•
•
You must log in as the root user to use this command.
ppm servername
Syntax
/opt/CSCOppm-gw/bin/ppm servername [hostname] [nostopstart]
Command Description
Command resets Prime Performance Manager server default hostname, where hostname is the new default hostname.
•
•
•
Related Topic
•
ppm setpath
Syntax
/opt/CSCOppm-gw/bin/ppm setpath [username]
Command Description
Appends binary (bin) directories to the path for a user. Users can then append the proper Prime Performance Manager binary directories to their paths without manually editing the .profile and .cshrc files.
This command appends lines such as these to the user's .profile file:
PATH=$PATH:/opt/CSCOppm-gw/bin:/opt/CSCOppm-gw Client/bin # CiscoPPM
and appends lines such as these to the user's .cshrc file:
set path=($path /opt/CSCOppm-gw/bin /opt/CSCOppm-gw Client/bin) # CiscoPPM
Thereafter, you can enter Prime Performance Manager commands as:
/opt/CSCOppm-gw/bin/ppm help
When entering this command, remember that:
•
•
–
–
–
•
ppm showcreds
Syntax
/opt/CSCOppm-gw/bin/ppm showcreds -i ipaddress/hostname
Command Description
Displays the Telnet and SSH device credentials on the Prime Performance Manager gateway.
-i ipaddress/hostname—The IP address or host name of the device (required)
ppm showsnmpcomm
Syntax
/opt/CSCOppm-gw/bin/ppm showsnmpcomm [-i ipaddress]
Command Description
Shows the specified SNMP configuration, or all SNMP configurations, on Prime Performance Manager server.
-i ipaddress—the IP address of the device (optional). If not specified, displays all SNMP configurations on the server.
Related Topic
ppm showunitconf
Syntax
/opt/CSCOppm-gw/bin/ppm showunitconf [-i (ipaddress)]
Command Description
Shows the configuration that specifies the relationship between nodes and their managed units.
-i ipaddress - IP address of the node is optional. If not specified, displays all configured entries on the server.
Note
ppm singlesess
Syntax
/opt/CSCOppm-gw/bin/ppm singlesess [enable | disable | status]
Command Description
This command manages single session per user..
•
Logging into a web interface as a user ends all the existing web interface sessions for that user.
•
This command allows logging in as the same user from multiple web interfaces.
•
You must log in as the root user to use this command.
ppm snmpcomm
Syntax
/opt/CSCOppm-gw/bin/ppm snmpcomm [name]
Command Description
You use this command to set a new default SNMP read community name. Prime Performance Manager automatically updates the name in the SNMP parameters file. The default path and filename for the SNMP parameters file is /opt/CSCOppm-gw/etc/communities.conf.
You must log in as the root user to use this command.
ppm snmpconf
Syntax
/opt/CSCOppm-gw/bin/ppm snmpconf [filename]
Command Description
Sets the file used for SNMP parameters, such as community names, timeouts, and retries.
The default path and filename for the SNMP parameters file is /opt/CSCOppm-gw/etc/communities.conf. If you installed Prime Performance Manager in a directory other than /opt, then the file resides in that directory.
When you specify a new path or filename, Prime Performance Manager restarts the servers.
Note
You must log in as the root user to use this command.
ppm snmpget
Syntax
/opt/CSCOppm-gw/bin/ppm snmpget [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-d output_delimiter] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname by using SNMP GetRequests. Use these optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory. However, if you are working in a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use this syntax:
-J-Xmx256m
•
•
•
•
•
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error; others are not. If this occurs and you:
–
–
•
ppm snmpget --instance 172.18.16.10 node_1 ipAdEntIfIndex ipAdEntNetMask
ppm snmpget node_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
ppm snmpget --str-instance link_1 node_1 cItpSpLinksetState
ppm snmpget node_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOppm-gw/etc/
communities.conf. If you installed Prime Performance Manager in a directory other than /opt, then the file resides in that directory. You can edit the file manually or using Prime Performance Manager web interface.You must log in as the root user to use this command.
ppm snmphelp
Command Description
Displays help for all commands that are related to SNMP queries.
You must log in as the root user to use this command.
ppm snmpmaxrows
Syntax
/opt/CSCOppm-gw/bin/ppm snmpmaxrows [number-of-rows]
Command Description
Sets the value of maximum rows for SNMP walk.
Prime Performance Manager collects network information from device MIBs using SNMP protocol. In certain ITP networks, some MIB tables can be very large (such as GTT tables, MTP3 accounting statistics tables, etc.)
The default value of 100,000 rows is usually sufficient even for large networks. However, for very large networks, if the limit needs to be increased, you can customize the this parameter. It is not recommended to exceed 300,000 rows.
If you enter this command without the number-of-rows argument, Prime Performance Manager displays the current maximum number of rows. You can then change that value or leave it. The valid range is 1 row to an unlimited number of rows. However, it is not recommended to set this number at less than 10,000. The default value is 100,000 rows.
You must log in as the root user to use this command.
ppm snmpnext
Syntax
ppm snmpnext [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-d output_delimiter] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname by using SNMP GetNextRequests. Use these optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory; however, if you explore a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use this option:
-J-Xmx256m
•
•
•
•
•
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error; others are not. If this occurs and you:
–
–
•
ppm snmpget --instance 172.18.16.10 node_1 ipAdEntIfIndex ipAdEntNetMask
ppm snmpget node_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
ppm snmpget --str-instance link_1 node_1 cItpSpLinksetState
ppm snmpget node_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOppm-gw/etc/communities.conf. If you installed Prime Performance Manager in a directory other than /opt, then the file resides in that directory. You can edit the file manually or by using Prime Performance Manager client.
You must log in as the root user to use this command.
ppm snmpsetup
Syntax
/opt/CSCOppm-gw/bin/ppm snmpsetup
Command Description
Set SNMP community strings for multiple devices and discover. You do not need to restart the server when using this command.
Related Topic
ppm snmpwalk
Syntax
/opt/CSCOppm-gw/bin/ppm snmpwalk [-JJVM_ARG1 [-JJVM_ARG2]...] [-v snmp_version] [-c community_string] [-r retry] [-t timeout] [-x maximum_rows] [-d output_delimiter] [--tabular|--no-tabular] [--getbulk|--no-getbulk] [--header|--no-header] [--raw-octets|--no-raw-octets] [--str-octets|--no-str-octets] [--raw-timeticks|--no-raw-timeticks] [--resolve-integer|--no-resolve-integer] [--resolve-bits|--no-resolve-bits] [--get-sysuptime|--no-get-sysuptime] [--detect-mib-error] [--instance oids] [--int-instance integer] [--str-instance string] [hostname] [oid] [oid]...
Command Description
Queries the specified hostname by using SNMP GetNextRequests to go through the MIB. Use these optional keywords and arguments with this command:
•
For example, by default JVM uses a maximum of 64 MB of memory; however, if you are going through a large table, JVM might require more memory. To enable JVM to use a maximum of 256 MB of memory, use this option:
-J-Xmx256m
•
•
•
•
•
However, for every 10,000 rows gone through, JVM requires an additional 10 MB of memory. You can use the -J keyword and argument to increase the memory available to JVM.
•
•
–
–
•
–
–
•
–
–
•
–
–
The other option for displaying octets is --str-octets|--no-str-octets.
•
–
–
The other option for displaying octets is --raw-octets|--no-raw-octets.
•
–
–
•
–
–
•
–
–
•
–
–
•
Sometimes multiple MIB variables are returned at the same time, some of which are in error; others are not. If this occurs and you:
–
–
•
ppm snmpget --instance 172.18.16.10 node_1 ipAdEntIfIndex ipAdEntNetMask
ppm snmpget node_1 ipAdEntIfIndex.172.18.16.10 ipAdEntNetMask.172.18.16.10
•
•
ppm snmpget --str-instance link_1 node_1 cItpSpLinksetState
ppm snmpget node_1 cItpSpLinksetState.6.108.115.110.97.109.101
•
•
The default path for the SNMP parameters file, communities.conf, is /opt/CSCOppm-gw/etc/communities.conf. If you installed Prime Performance Manager in a directory other than /opt, then the file resides in that directory. You can edit the file manually or using Prime Performance Manager client.
You must log in as the root user to use this command.
ppm ssl
Syntax
/opt/CSCOppm-gw/bin/ppm ssl [enable | disable | status]
Command Description
If you enable the SSL on Prime Performance Manager and you have an SSL key-certificate pair on Prime Performance Manager, you can use this command to manage SSL support in Prime Performance Manager:
•
•
•
You must log in as the root user to use this command. See Managing Prime Performance Manager Users for more information.
ppm sslstatus
Syntax
/opt/CSCOppm-gw/bin/ppm sslstatus
Command Description
Displays the current status for SSL that Prime Performance Manager supports, including whether you enabled or disabled SSL support; and, which SSL keys and certificates exist.
You must log in as the root user to use this command.
Related Topic
Managing Prime Performance Manager Users
ppm start
Syntax
/opt/CSCOppm-gw/bin/ppm start
Command Description
Starts the Prime Performance Manager gateway and unit (if installed on the same machine).
You must log in as the root user to use this command.
Note
Related Topic
Managing Gateways and Units Using the Command Line Interface
ppm start jsp
Syntax
/opt/CSCOppm-gw/bin/ppm startjsp
Command Description
Starts Prime Performance Manager JSP Server on the local host.
You must log in as the root user to use this command.
ppm start pm
Syntax
/opt/CSCOppm-gw/bin/ppm startpm
Command Description
Starts Prime Performance Manager Application Server and all managed processes on the local host.
You must log in as the root user to use this command.
ppm start web
Syntax
/opt/CSCOppm-gw/bin/ppm startweb
Command Description
Starts Prime Performance Manager web server on the local host.
You must log in as the root user to use this command.
ppm statreps
Full Syntax
/opt/CSCOppm-gw/bin/ppm statreps [none] [default] [all] [enable | disable] [noexport | export] status, [status [node]] status config, status reps, config, reps, [setstatus[category] [enable | disable]], [setstatus[category] [enable | disable] [node]], [5min [enable|disable]], [15min [enable|disable]], [hourly [enable|disable]], [hourly [enable|disable]], [daily [enable |disable]], [5mincsvage [days]], [15mincsvage [days]], [hourlycsvage [days]], [dailycsvage [days]], [5minage [days]], [15minage [days]], [hourlyage [days]], [dailyage [days]] , [ nodiskcheck | diskcheck], [timemode [ 12 | 24 ]], [csvnames [ ppm | 3gpp ]], [nametype[dnsname] [customname | sysname]], [csvtype [ allnodes | pernodeuniq]], [zipcsvdelay [ mins]]
Optionally, you can specify a hostname or IP address to enable or disable the specified report for a specific device. For example the following command enables CPU reports for the device name
ppm statreps cpu <ip address>If you specify a command in which the hostname or IP address is not applicable, the host parameter is ignored and does not cause an error.
Command Description
[ enable | disable] - Enable/Disable master report.
[ all ] - Enable all report types.
[ default ] - Enable all default report types.
[ none ] - Disable all report types.
[ noexport | export ] - Enable/Disable all csv files.
[ nodiskcheck | diskcheck] - Checks for available disk space.
status - Display network report settings.
status [ node] - Display node report settings.
status config - Display master report config settings.
status reps - Display individual report enable status.
config - Display master report config settings.
reps - Display individual report enable status.
setstatus [[category] [enable | disable]] - Enable/Disable Network report settings.
setstatus [[category] [enable | disable] [node]] - Enable/Disable Node report settings.
5min [enable | disable] - Enable/Disable 5 minute master report.
15min [enable | disable] - Enable/Disable 15 minute master report.
hourly [enable | disable] - Enable/Disable hourly master report.
daily [enable | disable] - Enable/Disable daily master report.
5mincsvage [days] - Specifies the days to keep 5 min csv files.
15mincsvage [days] - Specifies the days to keep 15 min csv files.
hourlycsvage [days] - Specifies the days to keep hourly csv files.
dailycsvage [days] - Specifies the days to keep daily csv files.
5minage [days] - Specifies the days to keep 5min data.
15minage [days] - Specifies the days to keep 15min data.
hourlyage [days] - Specifies the days to keep hourly data.
dailyage [days] - Specifies the days to keep daily data.
timemode [12 | 24] - Display in 12 or 24 hour time.
csvnames [ ppm | 3gpp ] - Specifies the format for csv filenames.
nametype [dnsname | customname | sysname] - Specifies the nodename type for csv files.
csvtype [allnodes | pernodeuniq] - Specifies the combined or pernode csv Files.
zipcsvdelay [mins] - Specifies the minutes to wait before zipping csv Files.
ppm syncunits
Syntax
/opt/CSCOppm-gw/bin/ppm syncunits [enable | disable| status]
Command Description
Command manages file synchronization between the gateway and units.
ppm status
Syntax
/opt/CSCOppm-gw/bin/ppm status
Command Description
Displays the status of all Prime Performance Manager servers on the local host.
Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm stop
Syntax
/opt/CSCOppm-gw/bin/ppm stop
Command Description
Stops all Prime Performance Manager servers on the local host.
You must log in as the root user to use this command.
ppm stop jsp
Syntax
/opt/CSCOppm-gw/bin/ppm stopjsp
Command Description
Stops Prime Performance Manager JSP Server on the local host.
You must log in as the root user to use this command.
ppm stop pm
Syntax
/opt/CSCOppm-gw/bin/ppm stoppm
Command Description
Stops Prime Performance Manager Application Server and all managed processes on the local host.
You must log in as the root user to use this command.
ppm stop web
Syntax
/opt/CSCOppm-gw/bin/ppm stopweb
Command Description
Stops Prime Performance Manager web server on the local host.
You must log in as the root user to use this command.
ppm tac
Syntax
/opt/CSCOppm-gw/bin/ppm tac [short]
Command Description
Collects important troubleshooting information for the Cisco Technical Assistance Center and writes the information to the /opt/CSCOppm-gw/tmp/cisco_ppm_tshoot.log file.
short—Collects the basic information required for diagnosis of the problem.
You must log in as the root user to use this command.
ppm trapratelimit abate
Syntax
/opt/CSCOppm-gw/bin/ppm trapratelimit abate [offset]
Command Description
This option configures the trap abate offset.
By default, a node generating 2,000 or more traps (major limiting count) in the last 30 minutes (limiting interval) is considered to generate too many traps.
Prime Performance Manager raises a TrapRateStatus major alarm and stops trap processing for this node. If the node no longer experiences a trap storm in the next cycle (limiting interval), Prime Performance Manager will automatically reset the ProcessTrap flag and begin processing traps again.
The abate offset is the offset value from the trap major limit count. The abate threshold limit is the limiting count minus the offset value. By default, the offset value is 200.
For example, if a node generates 2,000 traps (major limiting count) minus 200 traps (the default offset value), which equals 1,800 or more traps, it is considered to be faulty and Prime Performance Manager stops trap processing for this node.
You must log in as the root user to use this command.
ppm trapratelimit major
Syntax
/opt/CSCOppm-gw/bin/ppm trapratelimit major [count]
Command Decription
This option configures the trap major limiting count or the major threshold limit.
By default, a node generating 2,000 or more traps (major limiting count) in the last 30 minutes (limiting interval) is considered to generate too many traps.
Prime Performance Manager raises a TrapRateStatus major alarm and stops trap processing for this node. If the node no longer experiences a trap storm in the next cycle (limiting interval), Prime Performance Manager will automatically reset the ProcessTrap flag and begin processing traps again.
You must log in as the root user to use this command.
ppm trapratelimit interval
Syntax
/opt/CSCOppm-gw/bin/ppm trapratelimit interval [min]
Command Decription
This option configures the interval at which nodes are checked for a trap storm.
By default, a node generating 2,000 or more traps (major limiting count) in the last 30 minutes (limiting interval) is considered to generate too many traps.
Prime Performance Manager raises a TrapRateStatus major alarm and stops trap processing for this node. If the node no longer experiences a trap storm in the next cycle (limiting interval), Prime Performance Manager will automatically reset the ProcessTrap flag and begin processing traps again.
You must log in as the root user to use this command.
ppm trapratelimit minor
Syntax
/opt/CSCOppm-gw/bin/ppm trapratelimit minor [count]
Command Description
This option configures the trap minor limiting count or the minor threshold limit.
By default, if a node generates 1,000 or more traps (minor limiting count) in the last 30 minutes (limiting interval) Prime Performance Manager raises a TrapRateStatus minor alarm. Prime Performance Manager will continue to process traps from the node.
•
•
You must log in as the root user to use this command.
ppm uninstall
Syntax
/opt/CSCOppm-gw/bin/ppm uninstall
Command Description
Uninstalls Prime Performance Manager.
You must log in as the root user to use this command.
ppm unknownage
Syntax
/opt/CSCOppm-gw/bin/ppm unknownage [number-of-days]
Command Description
Sets the maximum number of days to retain Unknown objects before deleting them from Prime Performance Manager database.
If you enter this command without the number-of-days argument, Prime Performance Manager displays the current maximum number of days. You can then change that value or leave it. The valid range is one day to an unlimited number of days. The default value is seven days. Setting this value to 0 days means that, after one hour, the system deletes Unknown.
You must log in as the root user to use this command.
ppm updateuser
Syntax
/opt/CSCOppm-gw/bin/ppm updateuser [username]
Command Description
If you enable Prime Performance Manager User-Based Access, changes the authentication level for the specified user. Valid levels are:
•
•
•
•
If you set ppm authtype to local, you also use this command to change the user's password. When setting the password, follow the rules and considerations in Creating Secure Passwords.
See Enabling and Changing Users and Passwords for more information on authentication levels and the use of this command.
You must log in as the root user to use this command.
Note
ppm useraccess
Syntax
/opt/CSCOppm-gw/bin/ppm useraccess [disable | enable]
Command Description
Enables or disables Prime Performance Manager User-Based Access. User-Based Access provides multilevel password-protected access to Prime Performance Manager features. Each user can have a unique username and password. You can also assign each user to one of five levels of access, which control the list of Prime Performance Manager features accessible by that user.
Note
The ppm useraccess command goes through the following stages, checking the status of:
•
•
•
You must log in as the root user to use this command.
Related Topic
ppm userpass
Syntax
/opt/CSCOppm-gw/bin/ppm userpass [username]
Command Description
If you enable Prime Performance Manager User-Based Access and /opt/CSCOppm-gw/bin/ppm authtype is set to local, changes the specified user's Prime Performance Manager security authentication password.
If Prime Performance Manager automatically disables the user's authentication, this command re-enables the user's authentication with a new password.
If /opt/CSCOppm-gw/bin/ppm authtype is set to Solaris or Linux, you cannot use this command; instead, you must manage passwords on the external authentication servers.
You must log in as the root user to use this command.
Related Topic
Enabling and Changing Users and Passwords
ppm version
Syntax
/opt/CSCOppm-gw/bin/ppm version
Command Description
Displays version information for Prime Performance Manager servers and clients on the local host.
Related Topic
Chapter 3 "Using the Prime Performance Manager Web Interface"
ppm webport
Syntax
/opt/CSCOppm-gw/bin/ppm webport [port-number]
Command Description
Sets a new port number for the web server, where port-number is the new, numeric port number. Prime Performance Manager verifies that the new port number is not already in use.
The new port number must contain only numbers. If you enter a port number that contains nonnumeric characters, such as ppm13, Prime Performance Manager displays an error message and returns to the command prompt without changing the port number.
You must log in as the root user to use this command.
ppm who
Syntax
/opt/CSCOppm-gw/bin/ppm who
Command Description
Displays a list of all client usernames and processes connected to the server.
ppm xmlpoll
Syntax
/opt/CSCOppm-gw/bin/ppm xmlpoll -i ipaddress/hostname -p -a [-d parameters]
Command Description
Runs the XML poller to get the device XML output.
-i ipaddress/hostname—The IP address or host name of the device (required)
-p—Package
-a—Action
-d—Parameters
