Feedback
Table Of Contents
CTRS Utils Commands
September 2010This chapter contains Cisco TelePresence Recording Server (CTRS) utils commands:
Note
For information about using the CTRS administration software, refer to the Cisco TelePresence Recording Server Release 1.7 Administration Guide at the following URL:
http://www.cisco.com/en/US/products/ps10341/prod_maintenance_guides_list.html
utils 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 platformConfiguration files are being gathered now...Platform configuration files have been collected: platformConfig-20091202083407.tarTo retrieve the configuration files use CLI command: file get activelog platform/log/platformConfig-20091202083407.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 repair 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 listLog file: platform/log/diag1.logAvailable diagnostics modules=============================Group: Platformdisk_space - Check disk space and verify critical OS filesdisk_files* - Check for unusually large files in rootservice_manager - Check if service manager is runningvalidate_network - Validate network settingsraid - Check raid and disk statussystem_info - Collect system information into diagnostic logntp_reachability - Checks the reachability of external NTP server(s)ntp_clock_drift - Checks the local clock's drift from the NTP server(s)ntp_stratum - Checks the stratum level of the refrence clock.sdl_fragmentation* - Checks the fragementaion of files in SDL directorysdi_fragmentation* - Checks the fragementaion of files in SDI directoryipv6_networking - Checks the IPv6 network settingsutils 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 command but not attempt to repair the 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 disable
utils fior disable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to prevent the file I/O reporting service from being started automatically when the machine boots.
Note
Examples
admin: utils fior disableFile I/O Statistics has been disabled.Disabling fiostats : okFile I/O Statistics has been stopped.utils fior enable
utils fior enable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to enable the File I/O Reporting Service to be started automatically when the machine boots.
Note
Examples
admin: utils fior enableFile I/O Statistics has been enabled.Loading fiostats module: okEnabling fiostats : okFile I/O Statistics has been started.utils fior list
utils fior list [start=date-time] [stop=date-time]
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process. Use this command to provide a chronological list, oldest to newest, of file I/O events.
Examples
admin: utils fior list12/02/2009 21:26:13 modprobe 13695 282791 0 112/02/2009 21:26:13 modprobe 13685 282791 0 1##########12/02/2009 21:30:01 io stats for currently alive processes over the past 2522 seccmasm2d 7820 0 17390806java 11480 6291 68942##########utils fior start
utils fior start
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process. Use this command to start a previously stopped file I/O reporting service. The service will remain in a started state until it is either stopped or the machine is rebooted.
Examples
admin: utils fior startFile I/O Statistics has been started.utils fior status
utils fior status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process. Use this command to provide the status of the file I/O reporting service.
Examples
admin: utils fior statusDisabling fiostats : okFile I/O Statistics has been stopped.admin:utils fior startEnabling fiostats : okFile I/O Statistics has been started.admin:utils fior statusfiostats will start on reboot.kernel module is loaded.status: enabledsyscall use count: 8current time interval for counters: 1259790117 to 1259790140number of stats structures: 36only reads > 265000 and writes > 51200 are loggedutils fior stop
utils fior stop
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process. Use this command to stop the file I/O reporting service. The service will remain in a stopped state either until it is either started or the machine is rebooted.
Examples
admin: utils fior stopDisabling fiostats : okFile I/O Statistics has been stopped.utils fior top
utils fior top number [start=date-time] [stop=date-time]
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
The File I/O Reporting service provides a kernel-based daemon for collecting file I/O per process. Use this command to provide a list of top processes that create file I/O. This list can be sorted by the total number of bytes read, the total number of bytes written, the rate of bytes read or the rate of bytes written.
Examples
admin: utils fior toputils firewall ipv4 list
utils firewall ipv4 list
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to retrieve the current configuration of the firewall.
Examples
admin: utils firewall ipv4 listTable: natChain PREROUTING (policy ACCEPT)target prot opt source destinationREDIRECT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:443 redir ports 8443REDIRECT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:80 redir ports 8080Chain POSTROUTING (policy ACCEPT)target prot opt source destinationChain OUTPUT (policy ACCEPT)target prot opt source destinationDNAT tcp -- 0.0.0.0/0 127.0.0.1 tcp dpt:443 to::8443DNAT tcp -- 0.0.0.0/0 172.28.70.109 tcp dpt:443 to::8443DNAT tcp -- 0.0.0.0/0 127.0.0.1 tcp dpt:80 to::8080DNAT tcp -- 0.0.0.0/0 172.28.70.109 tcp dpt:80 to::8080Table: filterChain INPUT (policy DROP)target prot opt source destinationDROP all -- 127.0.0.0/8 0.0.0.0/0ACCEPT all -- 0.0.0.0/0 0.0.0.0/0ACCEPT udp -f 0.0.0.0/0 0.0.0.0/0DROP all -- 0.0.0.0/0 0.0.0.0/0 state INVALIDACCEPT all -- 0.0.0.0/0 0.0.0.0/0 state RELATED,ESTABLISHEDACCEPT icmp -- 0.0.0.0/0 0.0.0.0/0 icmp type 8 limit: avg 10/sec burst 5LOG icmp -- 0.0.0.0/0 0.0.0.0/0 icmp type 8 limit: avg 1/min burst 5 LOG flags 0 level 4 prefix `ping flood 'DROP icmp -- 0.0.0.0/0 0.0.0.0/0 icmp type 8ACCEPT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:22 flags:0x02/0x02ACCEPT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:8443 flags:0x02/0x02ACCEPT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:8080 flags:0x02/0x02ACCEPT udp -- 0.0.0.0/0 0.0.0.0/0 udp dpt:123ACCEPT tcp -- 0.0.0.0/0 0.0.0.0/0 tcp dpt:1533 flags:0x02/0x02...utils firewall ipv4 status
utils firewall ipv4 status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to retrieve the current status of the firewall.
Examples
admin: utils firewall ipv4 statusfirewall (iptables) is enabledfirewall (iptables) debugging is offutils firewall ipv6 list
utils firewall ipv6 list
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to retrieve the current configuration of the firewall.
Examples
admin: utils firewall ipv6 listTable: filterChain INPUT (policy DROP)target prot opt source destinationDROP all ::1/128 ::/0ACCEPT all ::/0 ::/0ACCEPT icmpv6 ::/0 ::/0 ipv6-icmp type 128 limit: avg 10/sec burst 5LOG icmpv6 ::/0 ::/0 ipv6-icmp type 128 limit: avg 1/min burst 5 LOG flags 0 level 4 prefix `ping flood'DROP icmpv6 ::/0 ::/0 ipv6-icmp type 128ACCEPT icmpv6 ::/0 ::/0ACCEPT tcp ::/0 ::/0 tcp dpt:22ACCEPT tcp ::/0 ::/0 tcp dpt:8443ACCEPT tcp ::/0 ::/0 tcp dpt:8080ACCEPT udp ::/0 ::/0 udp dpt:123ACCEPT tcp ::/0 ::/0 tcp dpt:1533ACCEPT tcp ::/0 ::/0 tcp dpts:32768:61000ACCEPT udp ::/0 ::/0 udp dpts:32768:61000DROP udp ::/0 ::/0 frag firstACCEPT udp ::/0 ::/0 frag moreACCEPT udp ::/0 ::/0 frag lastDROP tcp ::/0 ::/0 frag firstACCEPT tcp ::/0 ::/0 frag moreACCEPT tcp ::/0 ::/0 frag lastChain FORWARD (policy DROP)target prot opt source destinationChain OUTPUT (policy ACCEPT)target prot opt source destinationutils firewall ipv6 status
utils firewall ipv6 status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to retrieve the current status of the firewall.
Examples
admin: utils firewall ipv6 statusfirewall (ip6tables) is enabledfirewall (ip6tables) debugging is offutils iostat
utils iostat [interval iterations] [filename]
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to display iostat output. To indicate the interval between two iostat readings, and the number of iostat iterations to be performed, use the interval iteration option.
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.00sda4 0.00 0.00 0.00 0.00 0.00 0.00 0.00 0.00 1.83 0.00 1.67 1.67 0.00sda5 0.00 0.08 0.01 0.01 0.04 0.73 0.02 0.37 64.43 0.00 283.91 69.81 0.08sda6 2.71 14.79 0.20 6.84 23.26 173.24 11.63 86.62 27.92 0.02 2.98 0.61 0.43utils iothrottle disable
utils iothrottle disable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to disable I/O throttling enhancements.
Note
Examples
admin: utils iothrottle disableI/O throttling has been disabledutils iothrottle enable
utils iothrottle enable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to enable I/O throttling enhancements.
Note
Examples
admin: utils iothrottle enableI/O throttling has been enabledutils iothrottle status
utils iothrottle status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to show the status of the I/O throttling enhancements.
Examples
admin: utils iothrottle statusI/O throttling is enabledutils network arp delete
utils network arp delete host
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to delete an entry in the Address Resolution Protocol table.
Examples
admin: utils network arp delete myhostutils network arp list
utils network arp list [host hostname] [page] [numeric]
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to list the contents of the Address Resolution Protocol table.
Examples
admin: utils network arp listAddress HWtype HWaddress Flags Mask Ifacectms-vmware5.cisco.com ether 00:0C:29:C5:CF:68 C eth0tsbu-68net-gw.cisco.com ether 00:19:E8:7C:20:C2 C eth0Entries: 2 Skipped: 0 Found: 2utils network arp set
utils network arp set host address
Syntax Description
host
Identifies the name or dotted IP address of the host to add.
address
Identifies the hardware address (MAC address) of the host to be added in the following format: XX:XX:XX:XX:XX:XX
Command Modes
Admin
Command History
Usage Guidelines
Use this command to set an entry in the Address Resolution Protocol table.
Note
Examples
admin: utils network arp set myhost 11:22:33:44:55:66utils network capture
utils network capture [page] [numeric] [file filename] [count number] [size bytes]
[src address port number] [dest address port number] [host | address protocol ]Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to capture IP packets on the Ethernet interface. ETH0 is used as the default device.
You can either display the packets on screen or save them to a file. When using the page or file options, the capture of all requested packets must occur before the command will complete.
Note
Examples
admin:utils network capture count 5 numericExecuting command with options:size=128 count=5 interface=eth0src= dest= port=11:31:57.900286 philly.cisco.com.5901 > dhcp-128-107-142-57.cisco.com.3313: P 2869804405:2869805083(678) ack 1220658143 win 6420 (DF)11:31:57.900733 vv1-stern.cisco.com.38536 > dns-sj.cisco.com.domain: 6113+[|domain] (DF)11:31:57.902032 dns-sj.cisco.com.domain > vv1-stern.cisco.com.38536: 6113*[|domain] (DF)11:31:57.902172 vv1-stern.cisco.com.38536 > dns-sj.cisco.com.domain: 60216+[|domain] (DF)11:31:57.903282 dns-sj.cisco.com.domain > vv1-stern.cisco.com.38536: 60216*[|domain] (DF)utils network host
utils network host name
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to resolve a hostname to an address, or an address to a hostname. This command looks for the host locally first; if it cannot resolve it locally and Domain Name System (DNS) is configured, then it performs a DNS lookup.
Examples
admin: utils network host test1.comHostname test1.com resolves to <IP ADDRESS>admin: utils network host <IP ADDRESS>IP address <IP ADDRESS> resolves to test1.comutils network ping
utils network ping dest [count]
Syntax Description
dest
Identifies the host name or dotted IP address of the host to ping.
count
Defines number of ping packets to send. Default is 4.
Command Modes
Admin
Command History
Usage Guidelines
Use this command to send one or more ping packets to a remote destination.
Examples
admin:utils network ping www.cisco.com 5PING www.cisco.com (198.133.219.25) from 172.22.119.166 : 56(84) bytes of data.64 bytes from 198.133.219.25: icmp_seq=1 ttl=246 time=0.837 ms64 bytes from 198.133.219.25: icmp_seq=2 ttl=246 time=0.962 ms64 bytes from 198.133.219.25: icmp_seq=3 ttl=246 time=1.04 ms64 bytes from 198.133.219.25: icmp_seq=4 ttl=246 time=0.635 ms64 bytes from 198.133.219.25: icmp_seq=5 ttl=246 time=0.666 msutils network traceroute
utils network traceroute dest
Syntax Description
Command Modes
Admin
Command History
Usage Guidelines
Use this command to trace the route of IP packets to a remote destination.
Examples
admin:utils network traceroute <IP ADDRESS>traceroute to <IP ADDRESS>(<IP ADDRESS>), 30 hops max, 38 byte packets1 vns-gateway1-119 (<IP ADDRESS>) 0.599 ms 0.439 ms 0.381 ms2 <IP ADDRESS> (<IP ADDRESS>) 0.358 ms 0.242 ms 0.231 ms3 sjc20-lab-gw2 (<IP ADDRESS>) 0.347 ms * 0.514 msutils ntp config
utils ntp config
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to show the current configuration of the NTP client and server on this device.
Examples
admin: utils ntp configThis node is configured to synchronize with one of the following NTP server(s):171.68.10.80utils ntp restart
utils ntp restart
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to restart the NTP service.
Examples
admin: utils ntp restartRestarting the NTPutils ntp start
utils ntp start
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to start the NTP service if it is not already running; if the NTP service is already running, this command has no effect.
Note
Examples
admin: utils ntp startThe NTP is startingutils ntp status
utils ntp status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to show the current status of the NTP client on this device.
Examples
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.008utils remote_account create
utils remote_account create account life
Syntax Description
account
Identifies the name of the remote account.
life
Identifies the life of the remote account in days.
Command Modes
Admin
Command History
Usage Guidelines
Use this command to create a remote account so that Cisco Technical Support can access the system.
Note
Examples
admin:utils remote_account create ciscotech 1Account Successfully createdAccount : ciscotechPassphrase : 7RZT7ARZK5Expiry : 12-14-2005:15:50:21 (MM-DD-YYYY:Hr:Min:Sec)utils remote_account disable
utils remote_account disable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to remove remote accounts.
Examples
admin:utils remote_account disableutils remote_account enable
utils remote_account enable
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to enable existing remote accounts so that Cisco Technical Support can access the system.
Examples
admin:utils remote_account enableutils remote_account status
utils remote_account status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to retrieve status information for remote accounts used by Cisco Technical Support to access the system.
Examples
admin:utils remote_account statusRemote SupportStatus : enabledDecode Version : 1Account : dhrootPassphrase : BDLHBP4JMYExpiry : 8-24-2008:20:00:00(MM-DD-YYYY:Hr:Min:Sec)utils service snmp restart
utils service snmp restart
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to stop and then restart Simple Network Management Protocol (SNMP) processes.
Examples
admin:utils service snmp restartPassword:utils service snmp start
utils service snmp start
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to start Simple Network Management Protocol (SNMP) processes if not running and to enable external access to SNMP.
Examples
admin:utils service snmp startPassword:utils service snmp status
utils service snmp status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to display the current Simple Network Management Protocol (SNMP) process status.
Examples
admin:utils service snmp statusPassword:snmpd (pid 11326) is running...utils service snmp stop
utils service snmp stop
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to disable external access to Simple Network Management Protocol (SNMP).
Examples
admin:utils service snmp stoputils snmp reset
utils snmp reset
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to reset Simple Network Management Protocol (SNMP) objects to their default values. Current SNMP objects value will not be affected; the default values will be used the next time SNMPD is restarted.
Examples
admin:utils snmp resetReset Snmp object to default next time when it is restarted.utils snmp save
utils snmp save
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to save a set of current Simple Network Management Protocol (SNMP) object values. The saved values will replace the object default value when SNMPD is restarted.
Examples
admin:utils snmp saveSaving a set of current Snmp object values.utils system boot console
utils system boot console
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to change the output to the console during system boot.
Examples
admin:utils system boot consoleBoot output has been redirected to the console.utils system boot serial
utils system boot serial
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to change the output to the COM1 (serial port 1) during system boot.
Examples
admin:utils system boot serialBoot output has been redirected to COM1 (serial port 1).utils system boot status
utils system boot status
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to display where system boot messages are sent (console or serial port 1).
Examples
admin:utils system boot statusBoot output is redirected to the console.utils system restart
utils system restart
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to reboot the CTRS device.
Examples
admin:utils system restartDo you really want to restart ?Enter "yes" to restart or any other key to abortAppliance is being Restarted ...Broadcast message from root (Thu Jun 10 10:10:10 2004):The system is going down for restart NOW!Operation succeededrestart now.utils system shutdown
utils system shutdown
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to power off the CTRS device.
Examples
admin:utils system shutdownDo you really want to shutdown ?Enter "yes" to shutdown or any other key to abortAppliance is being Powered - Off ...Broadcast message from root (Thu Jun 10 10:10:10 2004):The system is going down for system halt NOW!utils system switch-version
utils system switch-version
Syntax Description
None
Command Modes
Admin
Command History
Usage Guidelines
Use this command to switch to another software version installed on the CTRS device.
Note
Examples
admin:utils system switch-versionActive Master Version: 2.0.0.0-44Inactive Master Version: 1.6.0.0-213Do you really want to switch versions ?Enter (yes/no)?Switching Version and Restarting the Appliance ...Warning: Version switch could take up to 20 minutes.Broadcast message from root (Thu Jun 10 10:10:10 2004):The system is going down for restart NOW!
