This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Cisco TelePOL-23878-01
C H A P T E R 9
Utils Commands
Published: October 26, 2010, OL-23878-01
This chapter contains the following utils commands:
• utils fior
• utils firewall
• utils iostat
• utils iothrottle enable
• utils iothrottle disable
• utils iothrottle status
• utils network arp
• utils network capture eth0
• utils network host
• utils network ipv6
• utils network ping
• utils network traceroute
• utils ntp
• utils remote_account
• utils service
• utils service list
• utils snmp
• utils snmp hardware-agents
• utils system
9-1resence Manager Release 1.7 Command Reference
Chapter 9 Utils Commands utils fior
utils fiorutils fior
Options:
disable
enable
list [start=date-time] [stop=date-time]
start
status
stop
top number [read | write | read-rate | write-rate] [start=date-time] [stop=date-time]
Syntax Description
Command Modes Admin
Command privilege level: 1
Allowed during upgrade: Yes
disable Prevents the file I/O reporting service from starting automatically when the machine boots. This command does not stop the service without a reboot. Use the stop option to stop the service immediately.
enable Enables the file I/O reporting service to start automatically when the machine boots. This command does not start the service without a reboot. Use the start option to start the service immediately.
list This command displays a list of file I/O events, in chronological order, from oldest to newest.
start Starts a previously stopped file I/O reporting service. The service remains in a started state until it is manually stopped or the machine is rebooted.
status Displays the status of the file I/O reporting service.
stop Stops the file I/O reporting service. The service remains in a stopped state until it is manually started or the machine is rebooted.
top Displays a list of top processes that create file I/O. You can sort this list by the total number of bytes read, the total number of bytes written, the rate of bytes read, or the rate of bytes written.
start Specifies a starting date and time.
stop Specifies a stopping date and time.
date-time Specifies a date and time, in any of the following formats: H:M, H:M:S a, H:M, a, H:M:S Y-m-d, H:M, Y-m-d, H:M:S.
number Specifies how many of the top processes to list.
[read | write | read-rate | write-rate]
Specifies the metric that is used to sort the list of top process.
Usage Guidelines Use this command to monitor the I/O on the server. The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process.
Usage Guidelines This command enables I/O throttling enhancements. When enabled, I/O throttling enhancements lower the impact of upgrades on an active system.
Examples admin: utils iothrottle enableI/O throttling has been enabled
utils network tracerouteutils network traceroute dest
Syntax Description
Command Modes Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines This command traces IP packets that are sent to a remote destination.
Examples admin:utils network traceroute 209.165.201.1209.165.201.30 (209.165.201.30) 0.293 ms 0.208 ms 0.199 ms 2 example-main-sw21 (209.165.200.225) 0.263 ms 0.275 ms 0.300 ms 3 example21-00lab-gw1-gig2-3 (209.165.202.129) 0.714 ms 0.725 ms 1.019 ms 4 example23-lab5-gw1-ten3-5 (209.165.202.130) 1.314 ms 0.861 ms 0.824 ms 5 example20-sbb5-gw1-ten7-5 (209.165.202.131) 1.424 ms 1.267 ms 1.011 ms 6 example20-rbb-gw1-ten6-2 (209.165.202.135) 0.475 ms 0.391 ms 0.364 ms 7 example12-rbb-gw4-ten7-1 (209.165.202.140) 0.459 ms * 0.508 ms
dest Represents the IP address or hostname of the server to which you want to send a trace.
Usage Guidelines This command displays the NTP status or configuration.
Examples The following example show an ntp client out of sync:
admin:utils ntp statusntpd (pid 10561) is running... remote refid st t when poll reach delay offset jitter============================================================================== ntp-sj1.cisco.c .GPS. 1 u 3 64 1 5.885 -0.091 0.008
unsynchronised time server re-starting polling server every 16 s
current time is : Mon Jan 31 12:01:38 PST 2005
example for in sync:ntpd (pid 10561) is running... remote refid st t when poll reach delay offset jitter==============================================================================*ntp-sj1.cisco.c .GPS. 1 u 2 64 77 5.865 0.554 0.057
synchronized to NTP server (171.68.10.150) at stratum 2 time correct to within 188 ms polling server every 64 s
current time is : Mon Jan 31 12:14:35 PST 2005
destination Represents the hostname or IP address of the server to which you want to send a trace.
Usage Guidelines This command allows you to enable, disable, create, and check the status of a remote account.
A remote account generates a pass phrase that allows the Cisco Systems support team to access the system for the specified life of the account. You can have only one remote account enabled at one time.
Usage Guidelines This command stops, starts, or restarts a service.
Examples admin:utils service start System NTPSystem NTP Starting...done
service-name Represents the name of the service that you want to stop or start:
– System SSH
– Service Manager
– Cisco SNMP Service
Release Modifications
1.2 This command was first documented.
1.7 Removed restart, enable, disable and the following service-name parameters: System NTP, A Cisco DB, Cisco WebServer, Cisco Database Layer Monitor and Cisco Unified Serviceability, because of changes in the 1.7 release of CTS-Manager.
Usage Guidelines This command allows you to control and get status for the SNMP hardware agent.
Examples admin:utils snmp reset
Reset Snmp objects to their default values when Snmpd is restarted.admin:utils snmp hardware-agents restartStopping SNMP agents ...Hourly HP Agent watchdog process is deactivated. To activate the watchdog process run the command: utils snmp hardware-agents startSNMP agents stoppedStarting SNMP agents ...HP Agent watchdog process has been reactivated.SNMP agents started
restart Restarts all of the SNMP agents provided by the vendor of the hardware.
start Starts all of the SNMP agents provided by the vendor of the hardware.
status Shows the status of the SNMP agents provided by the vendor of the hardware.
Note Only the agents that provide status will be shown by this command. Not all hardware agents will provide status.
stop Stops all of the SNMP agents provided by the vendor of the hardware.
utils systemutils system {boot [console | serial | status] | restart | shutdown | switch-version [nodatasync]}
Syntax Description
Options
• console—Changes the output during system boot to the console.
• serial—Changes the output during the system boot to COM1 (serial port one).
• status—Displays where system boot messages will be sent (console or serial port one).
• nodatasync—Switches product versions without synchronizing User Facing Feature Data (UFF data) between the active and inactive partitions.
Command Modes Admin
Command privilege level: 1
Allowed during upgrade: No
Command History
Usage Guidelines The utils system shutdown command provides a 5-minute time-out. If the system does not shut down within 5 minutes, the command gives you the option of doing a forced shutdown.
A warning message displays, and you are prompted for confirmation before this command runs with the nodatasync option.
If you use the nodatasync option, any changes to UFF data on the active partition will get lost. You should use this option only to force the versions to switch if the system will not switch versions otherwise because a data synchronization failure occurred. For more information about UFF data, refer to the Cisco Unified Communications Solution Reference Network Design (SRND):
Note Administrative changes made on the active partition, such as adding new phones, do not get synchronized when you switch versions. UFF data gets synchronized when you switch versions, unless you use the nodatasync option.
boot Boots the system.
restart Restarts the system.
shutdown Shuts down the system.
switch-version Switches to the product release that is installed on the inactive partition.
Release Modifications
1.2 This command was first documented.
1.7 This command was updated with boot command and console, serial and status options.