FeedbackTable Of Contents
Utils Commands
Published: October 26, 2010, OL-23878-01This chapter contains the following utils commands:
utils fior
utils 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
Command History
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.
Examples
admin: utils fior
utils firewall
utils firewall [ipv4 | ipv6] [list | status]
Syntax Description
ipv4
Internet Protocol version 4.
ipv6
Internet Protocol version 6.
list
Current configuration of the firewall.
status
Status of the firewall.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
This command displays the current status and configuration of either an IPv4 or IPv6 firewall.
Examples
admin: utils firewall ipv4 listTable: mangleChain PREROUTING (policy ACCEPT)target prot opt source destinationChain INPUT (policy ACCEPT)target prot opt source destinationChain FORWARD (policy ACCEPT)target prot opt source destinationChain OUTPUT (policy ACCEPT)target prot opt source destinationChain POSTROUTING (policy ACCEPT)target prot opt source destination
utils iostat
utils iostat
Syntax Description
None.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
This command provides the iostat output for the given number of iterations and interval.
Examples
admin: utils iostatExecuting command... Please be patientTue Oct 9 12:47:09 IST 2007Linux 2.4.21-47.ELsmp (csevdir60) 10/09/2007Time: 12:47:09 PMavg-cpu: %user %nice %sys %iowait %idle3.61 0.02 3.40 0.51 92.47Device: rrqm/s wrqm/s r/s w/s rsec/s wsec/s rkB/s wkB/s avgrq-sz avgqu-sz await svctm %utilsda 3.10 19.78 0.34 7.49 27.52 218.37 13.76 109.19 31.39 0.05 5.78 0.73 0.57sda1 0.38 4.91 0.14 0.64 4.21 44.40 2.10 22.20 62.10 0.02 26.63 1.62 0.13sda2 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 10.88 0.00 2.20 2.20 0.00sda3 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 5.28 0.00 1.88 1.88 0.00Related Commands
utils iothrottle disable
Disables I/O throttling enhancements.
utils iothrottle status
Displays the status of I/O throttling enhancements.
utils iothrottle enable
utils iothrottle enable
Syntax Description
None.
Command Modes
Admin
Command privilege level: 1
Command History
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 enabledRelated Commands
utils iothrottle disable
Disables I/O throttling enhancements.
utils iothrottle status
Displays the status of I/O throttling enhancements.
utils iothrottle disable
utils iothrottle disable
Syntax Description
None.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
This command disables I/O throttling enhancements. This could adversely affect the system during upgrades.
Examples
admin: utils iothrottle disableI/O throttling has been disabled.Related Commands
utils iothrottle enable
Enables I/O throttling enhancements.
utils iothrottle status
Displays the status of I/O throttling enhancements.
utils iothrottle status
utils iothrottle status
Syntax Description
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
This command displays the status of I/O throttling enhancements.
Examples
admin: utils iothrottle statusI/O throttling is disabled.Related Commands
utils iothrottle enable
Enables I/O throttling enhancements.
utils iothrottle disable
Disables I/O throttling enhancements.
utils network arp
utils network arp
list [host hostname or IP address of the host] [options]
set {host} {address}
delete host
Options
•
page—Displays the output one page at a time
•
Syntax Description
Command Modes
Admin:utils network arp list
Admin:utils network arp list host
Note: if you enter host, you must follow it with a hostname or IP address
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command lists, sets, or deletes Address Resolution Protocol (ARP) table entries.
Examples
admin: utils network arp set myhost 11:22:33:44:55:66
utils network capture eth0
utils network capture eth0 [page] [numeric] [file fname] [count num] [size bytes] [src addr] [dest addr] [port num]
Options
•
•
•
•
•
•
•
•
•
•
•
•
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command captures IP packets on the specified Ethernet interface.
Examples
admin: utils network capture eth0
utils network host
utils network host hostname [server server-name] [page] [detail] [srv]
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command resolves a host name to an address or an address to a host name.
Examples
admin: utils network host cisco.comLocal Resolution:Nothing foundExternal Resolution:cisco.com resolves to 192.0.2.0Related Commands
utils network ping
Sends one or more ping packets to a remote destination.
utils network tracet
Traces an IP packets to a remote destination.
utils network ipv6
utils network ipv6 [host] [ping | traceroute destination]
Syntax Description
host
Look up an IPv6 address or hostname.
ping
Ping an IPv6 address or hostname.
traceroute
Traceroute IPv6 address or hostname.
destination
IPv6 address.
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command display IPv6 information including host, ping and traceroute.
Examples
admin: utils network ipv6 host fd00:5::21b:78ff:fed1:7da6IPv6 address fd00:12::250:56ff:feba:532f resolves to bldr-vcm6.example.comadmin:utils network ipv6 ping fd00:5::21b:78ff:fed1:7da6PING fd00:5::21b:78ff:fed1:7da6(fd00:5::21b:78ff:fed1:7da6) 56 data bytes64 bytes from fd00:5::21b:78ff:fed1:7da6: icmp_seq=0 ttl=63 time=0.392 ms64 bytes from fd00:5::21b:78ff:fed1:7da6: icmp_seq=1 ttl=63 time=0.376 ms64 bytes from fd00:5::21b:78ff:fed1:7da6: icmp_seq=2 ttl=63 time=0.380 ms64 bytes from fd00:5::21b:78ff:fed1:7da6: icmp_seq=3 ttl=63 time=0.408 ms--- fd00:5::21b:78ff:fed1:7da6 ping statistics ---4 packets transmitted, 4 received, 0% packet loss, time 3071msrtt min/avg/max/mdev = 0.376/0.389/0.408/0.012 ms, pipe 2admin:utils network ipv6 traceroute fd00:5::21b:78ff:fed1:7da6
utils network ping
utils network ping dest [count VALUE] [size VALUE]
Syntax Description
Command Modes
Admin:utils network ping
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command allows you to ping another server.
Examples
admin:utils network ping www.cisco.com count 5Related Commands
utils network host
Resolves a hostname to an address, or an address to a hostname.
utils network tracert
Traces an IP packets to a remote destination.
utils network traceroute
utils network traceroute dest
Syntax Description
dest
Represents the IP address or hostname of the server to which you want to send a trace.
Note
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 ms2 example-main-sw21 (209.165.200.225) 0.263 ms 0.275 ms 0.300 ms3 example21-00lab-gw1-gig2-3 (209.165.202.129) 0.714 ms 0.725 ms 1.019 ms4 example23-lab5-gw1-ten3-5 (209.165.202.130) 1.314 ms 0.861 ms 0.824 ms5 example20-sbb5-gw1-ten7-5 (209.165.202.131) 1.424 ms 1.267 ms 1.011 ms6 example20-rbb-gw1-ten6-2 (209.165.202.135) 0.475 ms 0.391 ms 0.364 ms7 example12-rbb-gw4-ten7-1 (209.165.202.140) 0.459 ms * 0.508 ms
utils ntp
utils ntp {status | config}
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
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.008unsynchronisedtime server re-startingpolling server every 16 scurrent time is : Mon Jan 31 12:01:38 PST 2005example 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.057synchronized to NTP server (171.68.10.150) at stratum 2time correct to within 188 mspolling server every 64 scurrent time is : Mon Jan 31 12:14:35 PST 2005
utils remote_account
utils remote_account
status
enable
disable
create username life
Syntax Description
Command Modes
Admin
Command privilege level: 1
Allowed during upgrade: Yes
Command History
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.
Examples
admin:utils remote_account create remacct 10Remote SupportStatus : enabledDecode Version : 1Account : remacctPassphrase : 26NWA9SG4QExpiry : 3-24-2008:13:00:00(MM-DD-YYYY:Hr:Min:Sec)
utils service
utils service
start service-name
stop service-name
Syntax Description
service-name
Represents the name of the service that you want to stop or start:
–
–
–
Command Modes
Admin
Command privilege level: 1
Allowed during upgrade: No
Command History
Usage Guidelines
This command stops, starts, or restarts a service.
Examples
admin:utils service start System NTPSystem NTP Starting...done
utils service list
utils service list [page]
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command retrieves a list of all services and their status if command out is more than 20. Minimum ssh window length is 20 lines.
Examples
admin:utils service listRequesting service status, please wait...System SSH [STARTED]Service Manager is runningCisco Apache [Running]Cisco CDP Service [Running]Cisco Certificate Expiry Monitor [Running]Cisco DB [Running]Cisco Event Subsystem [Running]Cisco Server Resource Monitor [Running]Cisco TelePresence Cluster Manager [Running]
utils snmp
utils snmp [reset | save]
Syntax Description
reset
Resets SNMP objects to their default values.
save
Saves a subset of current SNMP object values.
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command allows you to save or reset SNMP object values.
Note
Examples
admin:utils snmp resetReset Snmp objects to their default values when Snmpd is restarted.
utils snmp hardware-agents
utils snmp hardware-agents [restart | start | status | stop]
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command allows you to control and get status for the SNMP hardware agent.
Examples
admin:utils snmp resetReset 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
utils system
utils system {boot [console | serial | status] | restart | shutdown | switch-version [nodatasync]}
Syntax Description
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.
Options
•
•
•
•
Command Modes
Admin
Command privilege level: 1
Allowed during upgrade: No
Command History
1.2
This command was first documented.
1.7
This command was updated with boot command and console, serial and status options.
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):
http://cisco.com/en/US/products/sw/voicesw/ps556/products_implementation_design_guides_list.html
Note
The nodatasync option does not support command auto-completion. You must enter the entire option name.
.
Examples
admin:utils system restartEnter (yes/no)? yesAppliance is being Restarted ...Shutting down Service Manager will take some time..\Broadcast message from root (Tue Oct 26 16:53:23 2010):The system is going down for reboot NOW!\ Service Manager shutting down services... Please WaitDONE!!!!
