FeedbackTable Of Contents
Utils Commands
Published: October 31, 2011, OL-23878-01This chapter contains the following utils commands:
utils auditd disable
utils auditd disable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
This command disables the auditd daemon.
When enabled, auditd log files for the system are retrievable through RTMT. The auditd daemon monitors for specific security-sensitive system calls at the OS kernel level, and provides an audit trail for activities such as file permission changes, failures to manipulate files due to permission settings, and changes to the system time and name.
Examples
admin:utils auditd disableutils auditd enable
utils auditd enable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
This command enables the auditd daemon.
When enabled, auditd log files for the system are retrievable through RTMT. The auditd daemon monitors for specific security-sensitive system calls at the OS kernel level, and provides an audit trail for activities such as file permission changes, failures to manipulate files due to permission settings, and changes to the system time and name.
Examples
admin:utils auditd enableutils auditd status
utils auditd status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
This command displays the status of the auditd daemon.
Examples
admin:utils auditd statusauditd is stoppedutils create report hardware
utils create report hardware
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to create a system report containing disk array, remote console, diagnostic, and environmental data.
Examples
admin:utils create report hardware*** W A R N I N G ***This process can take several minutes as the disk array, remote console,system diagnostics and environmental systems are probed for their currentvalues.Continue? Press y or Y to continue, any other key to cancel request.Continuing with System Report request...Collecting Disk Array Data...SmartArray Equipped server detected...DoneCollecting Remote Console Data...DoneCollecting Model Specific System Diagnostic Information...DoneCollecting Environmental Data...DoneCollecting Remote Console System Log Data...DoneCreating single compressed system report...DoneSystem report written to SystemReport-20070730020505.tgzTo retrieve diagnostics use CLI command:file get activelog platform/log/SystemReport-20070730020505.tgzutils create report platform
utils create report platform
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to collect the platform configuration files and copy them to a common log location.
Examples
admin:utils create report platformPlatform configuration files have been collected: platformConfig-20070829030854.tarTo retrieve the configuration files use CLI command: file get activelog platform/log/platformConfig-20070829030854.tarutils diagnose fix
utils diagnose fix
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to execute specific diagnostic tests and, if possible, to fix the system.
Examples
admin: utils diagnose fixStarting diagnostic test(s)===========================test - disk_space : Passedtest - service_manager : Passedtest - tomcat : PassedDiagnostics Completedutils diagnose list
utils diagnose list
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to list all available diagnostic commands.
Examples
admin: utils diagnose listAvailable diagnostics modules=============================disk_space - Check available disk space as well as any unusual disk usageservice_manager - Check if service manager is runningtomcat - Check if Tomcat is deadlocked or not runningutils diagnose module
utils diagnose module [module_name]
Syntax Description
module_name
Name of the module. Use the utils diagnose list command for the appropriate values for this option.
Command Modes
Admin
Command History
Usage Guidelines
Use this command to execute a single module test and attempt to fix the problem if possible.
Examples
admin: utils diagnose module tomcatStarting diagnostic test(s)===========================test - tomcat : PassedDiagnostics Completedutils diagnose test
utils diagnose test
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to execute each diagnose command but not attempt to repair system.
Examples
admin: utils diagnose testStarting diagnostic test(s)===========================test - disk_space : Passedtest - service_manager : Passedtest - tomcat : PassedDiagnostics Completedutils diagnose version
utils diagnose version
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to display the diagnostics system version.
Examples
admin: utils diagnose versionVersion: 1.0.0utils 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 [list | status]
Syntax Description
ipv4
Internet Protocol version 4.
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
None.
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 ldap config
utils ldap config
fqdn
ipaddr
Syntax Description
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
This command configures whether to use a Fully-Qualified Domain Name (FQDN) or an IP address for LDAP authentication.
Note
Using an FQDN for LDAP authentication is the preferred method. Use an IP address only if you have not configured your system for DNS.
Examples
admin: utils ldap config fqdnutils network arp
utils network arp
list [host hostname or IP address of the host] [options]
set {host} {address}
delete host
Options
•
•
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] [host protocol addr]
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
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 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 destination
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 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 2
utils ntp
utils ntp
config
restart
start
status
Syntax Description
config
Display the NTP configuration.
restart
Restart the NTP service.
start
Start the NTP service.
status
Display the NTP client status.
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
1.2
This command was first documented.
1.8
The restart and start options were added.
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 ntp server
utils ntp server
add server1 [server2] [server3] [server4] [server5] [norestart]
delete
list
Syntax Description
Command Modes
Admin
Command privilege level: 1
Allowed during upgrade: Yes
Command History
Usage Guidelines
This command allows you to add, delete, or list servers in the NTP configuration.
Examples
admin:utils ntp server add clock1.cisco.com clock2.cisco.comclock1.cisco.com : added successfully.clock2.cisco.com : added successfully.Restarting NTP on the server.
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 or starts 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 {get 3 | reset | save | walk 3}
Syntax Description
Command Modes
Admin
Command privilege level: 0
Allowed during upgrade: Yes
Command History
1.7
This command was first documented.
1.8
Added the get 3 and walk 3 options.
Usage Guidelines
This command allows you to display, 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}
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.
1.8
Removed the nodatasync option.
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.
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!!!!utils system upgrade
utils system upgrade {cancel | initiate [listall] | status}
Syntax Description
Command Modes
Admin
Command privilege level: 1
Allowed during upgrade: No
Command History
Usage Guidelines
Examples
admin:utils system upgrade initiate listallInvalid upgrades in "10.77.31.60:/home/":- UCSInstall_UCOS_7.0.0.98100-9002.iso - Can only upgrade to a version greater than the active version.- abc.txt - No match. This filename is not recognized. Renaming files is not supported.Available options and upgrades in "10.77.31.60:/home/":1) UCSInstall_UCOS_8.0.0.98000-9003.isoq) quitPlease select an option (1 - 1 or "q" ):
