Utils Commands
Available Languages
Table Of Contents
utils ipsla responder initiators add
utils ipsla responder initiators del
utils ipsla responder initiators list
utils logs generate presentation
Utils Commands
Revised: July 22, 2009, OL-19335-01This chapter contains the following utils commands:
•
utils ipsla responder disable
•
•
•
•
•
utils arp delete
utils network arp delete host
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to delete an entry in the Address Resolution Protocol table.
Examples
admin: utils network arp delete myhostRelated Commands
Lists the contents of the Address Resolution Protocol table.
Sets an entry in the Address Resolution Protocol table.
utils arp list
utils network arp list [host hostname][numeric]
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to list the contents of the Address Resolution Protocol table. If you select the option keyword numeric, host names are shown as dotted IP addresses.
For the Flags column:
•
•
•
Examples
admin: utils network arp listAddress HWtype HWaddress Flags Mask Ifacesjc21-3f-hsrp.cisco.com ether 00:00:0C:07:AC:71 C eth0philly.cisco.com ether 00:D0:B7:85:98:8E C eth0Entries: 2 Skipped: 0 Found: 2Related Commands
Deletes an entry in the Address Resolution Protocol table.
Sets an entry in the Address Resolution Protocol table.
utils arp set
utils network arp set {host addr}
Syntax Description
host
Required. Name or dotted IP address of the host to add.
addr
Required. Hardware address (MAC) of the host to be added in the format XX:XX:XX:XX:XX:XX
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to set an entry in the Address Resolution Protocol table.
Examples
admin: utils network arp set myhost 11:22:33:44:55:66Related Commands
Deletes an entry in the Address Resolution Protocol table.
Lists the contents of the Address Resolution Protocol table.
utils ipsla responder disable
utils ipsla responder disable
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to disable the Cisco IP Service Level Agreements (IP SLA) responder functionality.
Examples
admin: utils ipsla responder disableRelated Commands
utils ipsla responder enable
utils ipsla responder enable [start port | end port]
Syntax Description
Command Default
start—Minimum value is 32770. Default is 32770.
end—Maximum value is 65535. Default is 33000.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to enable the Cisco IP Service Level Agreements (IP SLA) responder probe functionality. To restrict the allowed IP SLA responder ports, use the start and end port range option. Use the utils ipsla responder initiators command to set access control restrictions.
You can also use this command to check whether IP SLA is already enabled. If IP SLA is already enabled, the system provides output regarding the ports that have already been configured.
Examples
admin: utils ipsla responder enableStarting IPSLA responder using port range 32770 - 33000...Related Commands
utils ipsla responder initiators add
utils ipsla responder initiators add {net net/prefix}
Syntax Description
net net/prefix
Required. Network/prefix for the Cisco IP Service Level Agreements (IP SLA) initiators.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to add a Cisco IP Service Level Agreements (IP SLA) initiator/sender device IP address to the list of allowed initiators. When you configure probes on sender devices (which are normally Cisco IOS-based routers), you specify a source IP address to be used when sending probe requests. Use the utils ipsla responder initiators add command to add the source IP address to the initiators list so that Cisco TelePresence System (CTS) can respond to the probe. The default is to have no initiators or senders.
Note
Examples
admin: utils ipsla responder initiators add net 00.000.00.00Related Commands
utils ipsla responder initiators del
utils ipsla responder initiators del {net net/prefix}
Syntax Description
net net/prefix
Required. Network/prefix for the Cisco IP Service Level Agreements (IP SLA) initiators.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to delete a Cisco IP Service Level Agreements (IP SLA) initiator from the list of allowed initiators that can interact with this Cisco TelePresence System (CTS) device.
Note
Examples
admin: utils ipsla responder initiators del net 00.000.00.00Related Commands
utils ipsla responder initiators list
utils ipsla responder initiators list
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to list all active allowed Cisco IP Service Level Agreements (IP SLA) initiators for this Cisco TelePresence System (CTS) device.
Note
Examples
admin: utils ipsla responder initiator listAllow Host/Network List:Related Commands
utils logs abort
utils logs abort
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to abort the last generated log files.
Examples
admin:utils logs abortAborting current generate log files...Related Commands
To FTP log files to an external server.
Generates log files.
Displays the status of the last generated log files.
utils logs ftp
utils logs ftp {user pass destination}
Syntax Description
user
Name of the FTP account.
pass
Password of the FTP account.
destination
Dotted IP address or host name of the FTP account.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to FTP the generated log files to an external server. To transfer the log files to an anonymous FTP server with no password, use quotation marks for the password:
utils logs ftp anonymous " " ftpserverThe filename of the log sent to the FTP server is based on the Cisco TelePresence System (CTS) hostname and the time the log file was created. The format is as follows:
logFiles_SEPXXXXXXXXXXXX_YYYY.MM.DD.HHmm_tar.gz
So a log file created on 15 May 2009 at 13:48 would be:
logFiles_SEP0019AA043ABF_2009.05.15.1348_tar.gzThat same file year later would be:
logFiles_SEP0019AA043ABF_2009.05.15.0000_tar.gzIf an error occurs with the FTP command, the error and the error code are displayed.
Examples
admin:utils logs ftp testuser testpass ftpserverLogs (logFiles_SEP0019AA043ABF_2008.05.15.1348_tar.gz) sent successfullyRelated Commands
Aborts the last generated log files.
Generates log files.
Displays the status of the last generated log files.
utils logs generate audio
utils logs generate audio
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate audio log files.
Examples
admin:utils logs generate audioGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
utils logs generate other
utils logs generate other
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate log files for other devices, such as Auxiliary Control Unit (ACU), LEDs, and digital media player (DMP).
Examples
admin:utils logs generate otherGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
Generates audio log files.
Generates phone log files.
Generates presentation device log files.
Generates sound recording log files.
Generates video log files.
utils logs generate phone
utils logs generate phone
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate phone log files.
Examples
admin:utils logs generate phoneGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
utils logs generate presentation
utils logs generate presentation
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate presentation device log files.
Examples
admin:utils logs generate presentationGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
utils logs generate recording
utils logs generate recording
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate sound recording log files.
Examples
admin:utils logs generate recordingGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
utils logs generate video
utils logs generate video
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
1.4.0
This command was introduced.
1.5.0
This command was expanded to include specific log output.
Usage Guidelines
Use this command to generate video log files.
Examples
admin:utils logs generate videoGenerating log files... this may take a while0% preparing to get logs10% add system state15% add application state40% add application logs60% add configuration files65% add calendar files70% add boot log files75% add secondary logs80% compress log files100% get logs completeRelated Commands
utils logs status
utils logs status
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to display the status of the last generated log files.
Examples
admin:utils logs statusDate : Apr 28 00:39Size : 877020 bytesTrouble Reason : RecordingRelated Commands
Aborts the last generated log files.
To FTP log files to an external server.
Generates log files.
utils network host
utils network host {name [server]}
Syntax Description
name
Required. Name of the host or address to resolve.
server
Optional. Name of an alternate name server to use.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to resolve a hostname to an address, or an address to a hostname.
Examples
admin:utils network host cisco.comLocal Resolution:Nothing foundExternal Resolution:cisco.com resolves to 192.0.2.0Related Commands
Pings all nodes to a remote destination.
Sends one or more ping packets to a remote destination.
Traces an IP packets to a remote destination.
utils network mtr
utils network mtr {dest [count] [tos] [options]}
Syntax Description
Note
Command Default
count—Default is 43200 (12 hours).
tos—The TOS field can have a value between 0 and 255. Default is 0.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to ping all nodes to a remote destination.
Examples
admin:utils network mtr 192.0.2.0 12Related Commands
Resolves a hostname to an address, or an address to a hostname.
Sends one or more ping packets to a remote destination.
Traces an IP packets to a remote destination.
utils network ping
utils network ping {dest [count]}
Syntax Description
Command Default
count—Default is 2.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to send one or more ping packets to a remote destination. The ping command should be used o test network functionality.
Note
Examples
admin:utils network ping www.cisco.com count 5Related Commands
Resolves a hostname to an address, or an address to a hostname.
Pings all nodes to a remote destination.
Traces an IP packets to a remote destination.
utils network tracert
utils network tracert {dest}
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to trace an IP packets to a remote destination.
Examples
admin:utils network tracert 192.0.2.0Related Commands
Resolves a hostname to an address, or an address to a hostname.
Pings all nodes to a remote destination.
Sends one or more ping packets to a remote destination.
utils ntp config
utils ntp config
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to show the current configuration of the Network Time Protocol (NTP) client and server on this machine.
Examples
admin:utils ntp configservers (this machine is an NTP client):171.58.10.150171.58.10.80clients (this machine is an NTP server):192.168.0.2192.168.1.2192.168.2.4Related Commands
Adds a new NTP server.
Deletes an existing NTP server.
Shows the current status of NTP client in the appliance.
utils ntp server add
utils ntp server add [address]
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to add a new Network Time Protocol (NTP) server. This command is available only if you are not using Cisco Unified Communications Manager (Cisco Unified CM) in non-Cisco Unified CM mode.
Examples
admin:utils ntp server add 192.0.2.0Related Commands
Shows the current configuration of the NTP client and server on this machine.
Deletes a existing NTP server.
Shows the current status of NTP client in the appliance.
utils ntp server delete
utils ntp server delete [address]
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to delete a existing Network Time Protocol (NTP) server. This command is available only if you are not using Cisco Unified Communications Manager (Cisco Unified CM).
Examples
admin:utils ntp server delete 192.0.2.0Related Commands
Shows the current configuration of the NTP client and server on this machine.
Adds a new NTP server.
Shows the current status of NTP client in the appliance.
utils ntp status
utils ntp status
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 0
Command History
Usage Guidelines
Use this command to show the current status of the Network Time Protocol (NTP) client in the appliance.
Examples
The following example show an NTP client out of sync:
admin:utils ntp statusntpd (pid 6492) is running...remote refid st t when poll reach delay offset jitter==============================================================================100.100.1.0 70.70.03.84 5 l 13 64 377 0.000 0.000 0.008*100.00.10.100 60.104.193.12 2 u 347 512 377 1.525 -0.713 0.266+100.00.10.80 100.204.05.100 2 u 256 512 377 2.164 -0.358 0.169Current time in UTC is : Tue Apr 28 00:53:45 2009Current time in GMT is : Tue Apr 28 00:53:45 2009Related Commands
Shows the current configuration of the NTP client and server on this machine.
Adds a new NTP server.
Deletes a existing NTP server.
utils remote_account create
utils remote_account create {name life}
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to create a remote support account.
Examples
admin:utils remote_account create remacct 10Remote SupportStatus : enabledDecode Version : 1Account : remacctPassphrase : 26NWA9SG4QExpiry : 3-24-2009:13:00:00(MM-DD-YYYY:Hr:Min:Sec)Related Commands
Disables the remote support account.
Enables the remote support account.
Shows the current status of the remote support account.
utils remote_account disable
utils remote_account disable
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to disable the remote support account.
Examples
admin:utils remote_account disableRemote Support is now disabledRelated Commands
Creates the remote support account.
Enables the remote support account.
Shows the current status of the remote support account.
utils remote_account enable
utils remote_account enable
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to enable the remote support account.
Examples
admin:utils remote_account enableRemote Support is now enabledRelated Commands
Creates the remote support account
Disables the remote support account
Shows the current status of the remote support account
utils remote_account status
utils remote_account status
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to show the current status of the remote support account.
Examples
admin:utils remote_account statusRemote SupportStatus : enabledDecode Version : 1Account : remacctPassphrase : LSSTBD6RYKExpiry : 3-24-2009:13:00:00(MM-DD-YYYY:Hr:Min:Sec)Related Commands
Creates the remote support account.
Disables the remote support account.
Enables the remote support account.
utils service list
utils service list [service]
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to retrieve all service statuses.
Examples
admin:utils service listService State---------- --------System_Log [Running]Cisco_Log [Running]Appl_Log [Running]DHCP_Srvr [Running]NTP [Running]SNMP_Srvr [Running]Discovery_Protocol [Running]Calling_Services [Running]HTTP_Srvr [Running]TFTP_Srvr [Running]Security_Srvr [Running]Telephone_Srvr [Running]Related Commands
utils service restart
utils service restart {service}
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to restart a service.
Examples
admin:utils service restart System_LogSystem_Log Restarting...doneRelated Commands
utils service start
utils service start {service}
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to start a service.
Examples
admin:utils service start System_LogSystem_Log Starting...doneRelated Commands
utils service stop
utils service stop {service}
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to stop a service.
Examples
admin:utils service stop System_LogRelated Commands
utils snmp reset
utils snmp reset
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to reset SNMP objects to their default values. Current SNMP objects values will not be affected. The default values will be used next time when SNMPD is restarted.
Examples
admin:utils snmp resetReset Snmp object to default next time when it is restarted.Related Commands
utils snmp save
utils snmp save
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to save a set of current SNMP object values. The saved value will replace the object default value when SNMP is restarted.
Examples
admin:utils snmp saveSaving a set of current Snmp object values.Related Commands
utils system presentation
utils system presentation
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to access the presentation device in the system, if present.
Examples
admin:utils system presentationThe unit is not presentRelated Commands
Resets the system and run with the factory default configuration.
Restarts the system.
Switches to the other installed load on the system.
utils system reset factory
utils system reset factory
Syntax Description
This command has no arguments or keywords.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to reset the system and run with the factory default configuration.
Examples
admin:utils system reset factoryAre you sure you want to set the system back to the factory defaults ?This will cause a system restart !Enter "yes" to reset to factory defaults and restart or any other key to abortcontinue: yesThe factory reset is now in progress - this will take a few moments...The system is going down for restart NOW!Related Commands
Allows access to the presentation unit in the system, if present.
Restarts the system.
Switches to the other installed load on the system.
utils system restart
utils system restart [force | wait]
Syntax Description
force
Optional. Forces a system restart.
wait
Optional. If in a call, schedules the system restart at the end of the call.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to restart the system. If the system is in a call, the restart will occur at the end of the call. This can be overridden using the force option to restart immediately.
Note
The System Restart has been aborted
Examples
admin:utils system restartAre you sure you want to restart the system ?Enter "yes" to restart or any other key to abortcontinue: yesThe system is going down for restart NOW!Related Commands
Allows access to the left unit in the system, if present.
Resets the system and run with the factory default configuration.
Switches to the other installed load on the system.
utils system switch-version
utils system switch-version [force | factory [1 | 2]]
Syntax Description
force
Optional. Forces a switch.
factory
Optional. Switches to the factory image.
1
Optional. Switches to slot 1 image from factory image.
2
Optional. Switches to slot 2 image from factory image.
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 1
Command History
Usage Guidelines
Use this command to switch to the other installed load on the system. If you do not configure an optional value, the system will toggle between slots 1 and 2. If the system is currently in a call, the version change will not be allowed. To override, use the force option to switch immediately.
Note
The system switch has been aborted.
This command is available only if you are not using Cisco Unified Communications Manager (Cisco Unified CM).
Examples
admin:utils system switch-versionCurrently running the slot 1Target is slot 2 imageAre you sure you want to switch the system, this will cause a system restart ?Enter "yes" to switch and restart or any other key to abortcontinue: yesSetting to slot 2 image ...preparing, please wait....The system is going down for restart NOW!Related Commands
Allows access to the left unit in the system, if present.
Resets the system and run with the factory default configuration.
Restarts the system.
utils upgrade peripherals
utils upgrade peripherals [nowarn]
Syntax Description
Command Default
No default behavior or values.
Command Modes
Admin
Command privilege level: 3
Command History
Usage Guidelines
Use this command to initiate an immediate peripheral upgrade. You can also enter help in the command string to upgrade peripherals that have been marked for a forced upgrade with the set upgrade command:
utils upgrade peripherals helpTo determine the peripherals that have been set to forced upgrade, enter show upgrade detail.
Note
Examples
admin:utils upgrade peripheralschecking...doneNo system restart is required after the peripheral upgradeIt will be required to stop calling servicesEnter "yes" to continue or any other key to abortcontinue: yespreparing...doneupgrading the peripheralsplease check the phone and display for progress...upgrade completerestarting calling services, please wait...doneRelated Commands
show upgrade detail
Shows the status of an upgrade.
Resets the system and run with the factory default configuration.
Forces an upgrade of the audio peripheral
Forces an upgrade of the auxiliary control peripheral.
Forces an upgrade of the camera peripheral.
Forces an upgrade of the display peripheral.
Forces an upgrade of the firmware peripheral.
Forces an upgrade of the graphic driver.
Forces an upgrade of the graphic icons.
Feedback