Feedback
Table Of Contents
Cisco IPT Platform CLI Commands
file fragmentation sdi (Connection 2.1 Only)
file fragmentation sdl (Connection 2.1 Only)
run loadxml (Connection 2.1 Only)
set network restore (Connection 2.1 Only)
show ctl (Connection 2.1 Only)
show cuc dbserver sessions all
show cuc dbserver sessions list
show cuc dbserver user waiting
show cuc sysagent task results
show cuc tech dbserver integrity
show cuc tech dbserver log diagnostic
show cuc tech dbserver log message
show diskusage (Connection 2.1 Only)
show process (Connection 2.1 Version)
show process (Connection 2.0 Version)
show tech network (Connection 2.1 Version)
show tech network (Connection 2.0 Version)
show tech runtime (Connection 2.1 Version)
show tech runtime (Connection 2.0 Version)
show tech system (Connection 2.1 Version)
show tech system (Connection 2.0 Version)
utils create report (Connection 2.1 Only)
utils dbreplication clusterreset (Connection 2.1 Only)
utils dbreplication dropadmindb (Connection 2.1 Only)
utils dbreplication setrepltimeout (Connection 2.1 Only)
utils diagnose (Connection 2.1 Only)
utils disaster_recovery backup tape
utils disaster_recovery backup network
utils disaster_recovery cancel_backup
utils disaster_recovery restore tape
utils disaster_recovery restore network
utils disaster_recovery show_backupfiles network
utils disaster_recovery show_backupfiles tape
utils disaster_recovery show_registration
utils disaster_recovery show_tapeid
utils disaster_recovery status
utils firewall (Connection 2.1 Only)
utils network connectivity (Connection 2.1 Only)
utils snmp (Connection 2.1 Only)
utils soap realtimeservice test
Command Line Interface
Revised March 4, 2009Overview
This appendix describes the CLI commands that are available on the Cisco Unified Communications Operating System server.
Starting a CLI Session
You can access the Cisco Unified Communications Operating System CLI remotely or locally:
•
From a web client workstation, such as the workstation that you use for Cisco Unified Communications Operating System Administration, you can use SSH to connect securely to the Cisco Unified Communications Operating System.
•
Before You Begin
Ensure you have the following information that gets defined during installation:
•
•
•
You will need this information to log in to the Cisco IPT Platform.
Perform the following steps to start a CLI session:
Step 1
•
ssh adminname@hostname
where adminname specifies the Administrator ID and hostname specifies the hostname that was defined during installation.
For example, ssh admin@ipt-1.
•
ipt-1 login:where ipt-1 represents the host name of the system.
Enter your administrator ID.
In either case, the system prompts you for a password.
Step 2
The CLI prompt displays. The prompt represents the Administrator ID; for example:
admin:
CLI Basics
The following section contains basic tips for using the command line interface.
Completing Commands
To complete commands, use Tab:
•
•
•
Getting Help on Commands
You can get two kinds of help on any command:
•
•
Procedure
To get detailed help, at the CLI prompt, enter
help command
Where command specifies the command name or the command and parameter. See Example A-1.
To query only command syntax, at the CLI prompt, enter
command?
Where command represents the command name or the command and parameter. See Example A-2.
Note
Example A-1 Detailed Help Example:
admin:help file list activelogactivelog help:This will list active logging filesoptions are:page - pause outputdetail - show detailed listingreverse - reverse sort orderdate - sort by datesize - sort by sizefile-spec can contain '*' as wildcardsExample:admin:file list activelog platform detail02 Dec,2004 12:00:59 <dir> drf02 Dec,2004 12:00:59 <dir> log16 Nov,2004 21:45:43 8,557 enGui.log27 Oct,2004 11:54:33 47,916 startup.logdir count = 2, file count = 2Example A-2 Query Example:
admin:file list activelog?Syntax:file list activelog file-spec [options]file-spec mandatory file to viewoptions optional page|detail|reverse|[date|size]Ending a CLI Session
At the CLI prompt, enter quit. If you are logged in remotely, you get logged off, and the ssh session gets dropped. If you are logged in locally, you get logged off, and the login prompt returns.
Cisco IPT Platform CLI Commands
The following sections list and describe the CLI commands that are available for the Cisco Unified Communications Operating System.
delete account
This command allows you to delete an administrator account.
Command Syntax
delete account account-name
Parameters
•
Requirements
Command privilege level: 4
Allowed during upgrade: No
delete cuc locale
Revised March 4, 2009This command deletes from Connection the specified locale and all of the associated files and settings.
Command Syntax
delete cuc locale locale-id
Parameters
•
For a list of installed locales and their IDs, run the show cuc locales command. Locale IDs are case sensitive.
Usage Guidelines
Before you run this command, you must stop the Connection Conversation Manager and Connection Mixer services. After you run this command, you must restart the Connection Conversation Manager and Connection Mixer services.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example deletes the en-GB locale and all of the associated files and settings.
delete cuc locale en-GBen-GB uninstalleddelete dns
This command allows you to delete the IP address for a DNS server.
Command Syntax
delete dns ip-address
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
delete ipsec
This command allows you to delete IPSec policies and associations.
Command Syntax
delete ipsec
policy {ALL | policy-name}
association policy name {ALL | association-name}
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
delete process
This command allows you to delete a particular process.
Command Syntax
delete process process-id [force | terminate | crash]
Parameters
•
Options
•
•
•
Usage Guidelines
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
delete smtp
This command allows you to delete the SMTP host.
Command Syntax
delete smtp
Requirements
Command privilege level: 1
Allowed during upgrade: No
file check
This command checks the /usr directory tree to see whether any files or directories have been added, removed, or changed in size since the last fresh installation or upgrade and displays the results.
Command Syntax
file check [detection-size-kb]
Options
detection-size-kb specifies the minimum file size change that is required for the command to display the file as changed.
Usage Guidelines
The command notifies you about a possible impact to system performance and asks you whether you want to continue.
Caution
The display includes both deleted and new files.
Defaults
The default value of detection-size-kb is 100 KB.
Requirements
Command privilege level: 0
Allowed during upgrade: No
file delete
Revised January 7, 2008This command deletes one or more files.
Command Syntax
file delete
activelog directory/filename [detail] [noconfirm]
inactivelog directory/filename [detail] [noconfirm]
install directory/filename [detail] [noconfirm]
tftp directory/filename [detail]
Connection 2.1 only: dir tftp directory [detail]
Connection 2.1 only: license filename [detail]
Parameters
•
•
•
•
•
•
•
Options
•
•
Usage Guidelines
Caution
If you delete a TFTP data file on the inactive side, you may need to manually restore that file if you switch versions to the inactive side.
Connection 2.1 only: You get prompted for confirmation after entering the command.
Connection 2.1 only: You cannot delete directories or files that are in use.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example deletes the install log.
file delete install install.logfile dump
Revised January 7, 2008This command dumps the contents of a file to the screen, a page at a time.
Command Syntax
file dump
activelog directory/filename [detail] [hex]
inactivelog directory/filename [detail] [hex]
install directory/filename [detail] [hex]
tftp directory/filename [detail] [hex]
Connection 2.1 only: sftpdetails filename [hex] [regexp expression] [recent]
Parameters
•
•
•
•
•
•
•
Options
•
•
•
•
Usage Guidelines (Connection 2.1 Only)
To determine which files you can dump with this command, first enter the following command:
file list sftpdetails *
The output lists the filenames that you can dump.
Requirements
Connection 2.1 only: Command privilege level: 1
Connection 2.0 only: Command privilege level: 1 for logs, 0 for TFTP files
Allowed during upgrade: Yes
Example
This command dumps contents of file _cdrIndex.idx.
file dump activelog cm/cdr/_cdrIndex.idxfile fragmentation sdi (Connection 2.1 Only)
Added January 7, 2008This command displays file fragmentation information about SDI log files.
Command Syntax
file fragmentation sdi
all outfilename
file filename {verbose}
most fragmented number
most recent number
Parameters
•
•
•
•
•
Options
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
file fragmentation sdl (Connection 2.1 Only)
Added January 7, 2008This command displays file fragmentation information about SDL log files.
Command Syntax
file fragmentation sdl
all outfilename
file filename {verbose}
most fragmented number
most recent number
Parameters
•
•
•
•
•
Options
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
file get
Revised January 7, 2008This command sends the file to another system by using SFTP.
Command Syntax
file get
activelog directory/filename [reltime] [abstime] [match] [recurs]
inactivelog directory/filename [reltime] [abstime] [match] [recurs]
install directory/filename [reltime] [abstime] [match] [recurs]
tftp directory/filename [reltime] [abstime] [match] [recurs]
Connection 2.1 only: salog directory/filename [reltime] [abstime] [match] [recurs]
Connection 2.1 only: partBsalog directory/filename [reltime] [abstime] [match] [recurs]
Parameters
•
•
•
•
•
•
•
Options
•
•
•
•
Usage Guidelines
After the command identifies the specified files, you get prompted to enter an SFTP host, username, and password.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Examples
This command gets all files in the activelog operating system directory that match the string "plat".
file get activelog platform match platThis command gets all operating system log files for a particular time period.
file get activelog platform/log abstime 18:00:9/27/2005 18:00:9/28/2005file list
Revised January 7, 2008This command lists the log files in an available log directory.
Command Syntax
file list
activelog directory [page] [detail] [reverse] [date | size]
inactivelog directory [page] [detail] [reverse] [date | size]
install directory [page] [detail] [reverse] [date | size]
tftp directory [page] [detail] [reverse] [date | size]
Connection 2.1 only: salog directory [page] [detail] [reverse] [date | size]
Connection 2.1 only: partBsalog directory [page] [detail] [reverse] [date | size]
Connection 2.1 only: sftpdetails filespec [page] [detail] [reverse] [date | size]
Parameters
•
•
•
•
•
•
•
•
•
Options
•
•
•
•
•
Requirements
Command privilege level: 1 for logs, 0 for TFTP files
Allowed during upgrade: Yes
Examples
This example lists operating system log files with details.
file list activelog platform/log page detailThis example lists directories in CDR repository.
file list activelog cm/cdr_repositoryThis example lists CDR files in a specified directory by size.
file list activelog cm/cdr_repository/processed/20050812 sizefile search
This command searches the content of a log and displays the matching lines a page at a time.
Command Syntax
file search
activelog directory/filename reg-exp [abstime hh:mm:ss mm/dd/yyyy hh:mm:ss mm/dd/yyyy] [ignorecase] [reltime {days | hours | minutes} timevalue]
inactivelog directory/filename reg-exp [abstime hh:mm:ss mm/dd/yyyy hh:mm:ss mm/dd/yyyy] [ignorecase] [reltime {days | hours | minutes} timevalue]
install directory/filename reg-exp [abstime hh:mm:ss mm/dd/yyyy hh:mm:ss mm/dd/yyyy] [ignorecase] [reltime {days | hours | minutes} timevalue]
tftp directory/filename reg-exp [abstime hh:mm:ss mm/dd/yyyy hh:mm:ss mm/dd/yyyy] [ignorecase] [reltime {days | hours | minutes} timevalue]
Parameters
•
•
•
•
•
•
Options
•
•
•
•
•
•
Usage Guidelines
Write the search term in the form of a regular expression, which is a special text string for describing a search pattern.
If the search term is found in only one file, the filename appears at the top of the output. If the search term is found in multiple files, each line of the output begins with the filename in which the matching line was found.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Example
file search activelog platform/log/platform.log Err[a-z] ignorecasefile tail
This command tails (prints the last few lines) of a log file.
Command Syntax
file tail
activelog directory/filename [detail] [hex] [lines]
inactivelog directory/filename [detail] [hex] [lines]
install directory/filename [detail] [hex] [lines]
tftp directory/filename [detail] [hex] [lines]
Parameters
•
•
•
•
•
Options
•
•
•
Requirements
Command privilege level: 1 for logs, 0 for TFTP files
Allowed during upgrade: Yes
Example
This example tails the operating system CLI log file.
file tail activelog platform/log/cli00001.logfile view
Revised January 7, 2008This command displays the contents of a file.
Command Syntax
file view
activelog directory/filename
inactivelog directory/filename
install directory/filename
tftp directory/filename
Connection 2.1 only: system-management-log
Parameters
•
•
•
•
•
•
Usage Guidelines
Caution
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Examples
This example displays the install log.
file view install install.logThis example displays a particular CDR file.
file view activelog /cm/cdr_repository/processed/20058012/{filename}run cuc dbquery
This command runs an SQL query and displays the results.
Command Syntax
run cuc dbquery database_name sql_statement [page]
Parameters
•
–
–
–
–
•
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example runs the SQL query select alias from vw_usertemplate on the unitydirdb database.
run cuc dbquery unitydirdb select alias from vw_usertemplateAdministratorTemplateVoiceMailUserTemplaterun cuc sysagent task
This command runs a Sysagent task.
Command Syntax
run cuc sysagent task task_name
Parameters
•
For a list of Sysagent tasks, run the command show cuc sysagent task list. Sysagent task names are case sensitive.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example runs the Sysagent task CleanDeletedMessagesTask.
run cuc sysagent task CleanDeletedMessagesTaskCleanDeletedMessagesTask startedrun loadxml (Connection 2.1 Only)
Added January 7, 2008Run this command as a workaround when service parameters or product-specific information does not appear in the administration window as expected.
You may need to restart some services may be required after this command.
Command Syntax
run loadxml
Requirements
Command privilege level: 1
Allowed during upgrade: No
run sql
This command allows you to run an SQL command.
Command Syntax
run sql sql_statement
Parameters
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
Example
This example runs an SQL command.
run sql select name from deviceset account
This command sets up a new account on the operating system.
Command Syntax
set account name
Parameters
•
Usage Guidelines
After you enter the username, the system prompts you to enter the privilege level and password for the new account.
Requirements
Command privilege level: 0
Allowed during upgrade: No
set commandcount
This command changes the CLI command prompt, so it displays how many CLI commands have executed.
Command Syntax
set commandcount {enable | disable}
Parameters
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
set cuc trace
This command enables or disables the specified traces and trace levels.
Command Syntax
set cuc trace {enable | disable} trace_name level
Parameters
•
•
•
•
Usage Guidelines
To display a list of the traces and trace levels that are currently enabled, use the show cuc trace levels command.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example enables VUI traces 1, 13, and 17 through 20.
set cuc trace enable VUI 1,13,17-20VUI trace levels are now set to: 1,13,17-20The following example disables vui traces 17 through 20. VUI trace levels 1 and 13 are still set.
set cuc trace disable VUI 17-20VUI trace levels are now set to: 1,13set ipsec
This command allows you to set IPSec policies and associations.
Command Syntax
set ipsec
policy {ALL | policy-name}
association policy-name {ALL | association-name}
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
set logging
This command allows you to enable or disable logging.
Command Syntax
set logging {enable | disable}
Requirements
Command privilege level: 0
Allowed during upgrade: No
set network dhcp
Revised January 7, 2008This command configures DHCP on Ethernet interface 0. You cannot configure Ethernet interface 1.
Command Syntax
set network dhcp eth0
enable
disable node_ip net_mask gateway_ip
Parameters
•
•
•
•
•
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network dns
This command sets the IP address for the primary or secondary DNS server.
Command Syntax
set network dns {primary | secondary} ip-address
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network dns options
This command sets DNS options.
Command Syntax
set network dns options [timeout seconds] [attempts number] [rotate]
Parameters
•
•
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
set network domain
This command sets the domain name for the system.
Command Syntax
set network domain domain-name
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network failover
This command enables and disables Network Fault Tolerance on the Media Convergence Server network interface card.
Command Syntax
failover {enable | disable}
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network gateway
This command enables you to configure the IP address of the network gateway.
Command Syntax
set network gateway ip-address
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network ip
This command sets the IP address for Ethernet interface 0. You cannot configure Ethernet interface 1.
Command Syntax
set network ip eth0 ip-address ip-mask
Parameters
•
•
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network mtu
This command sets the maximum MTU value.
Command Syntax
set network mtu mtu_max
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
set network max_ip_conntrack
This command sets the ip_conntrack_max value.
Command Syntax
set network max_ip_conntrack ip_conntrack_max
Parameters
•
set network nic
This command sets the properties of the Ethernet Interface 0. You cannot configure Ethernet interface 1.
Command Syntax
set network nic eth0 [auto en | dis] [speed 10 | 100] [duplex half | full]
Parameters
•
•
•
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Note
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set network pmtud
This command enables and disables Path MTU Discovery.
Command Syntax
set network pmtud [enable | disable]
Parameters
•
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
set network restore (Connection 2.1 Only)
Added January 7, 2008This command configures the specified Ethernet port to use a specified static IP address.
Caution
Caution
Command Syntax
set network restore eth0 ip-address network-mask gateway
Parameters
eth0 specifies Ethernet interface 0.
ip-address specifies the IP address.
network-mask specifies the subnet mask.
gateway specifies the IP address of the default gateway.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
set network status
This command sets the status of Ethernet 0 to up or down. You cannot configure Ethernet interface 1.
Command Syntax
set network status eth0 {up | down}
Parameters
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set password
This command allows you to change the administrator and security passwords.
Command Syntax
set password {admin | security}
Parameters
•
Usage Guidelines
The systems prompts you for the old and new passwords.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
set smtp
This command sets the SMTP server hostname.
Command Syntax
set smtp hostname
Parameters
•
Requirements
Command privilege level: 0
Allowed during upgrade: No
set timezone
This command lets you change the system time zone.
Command Syntax
set timezone timezone
Parameters
•
Usage Guidelines
Enter enough characters to uniquely identify the new time zone. Be aware that the time-zone name is case-sensitive.
Caution
Requirements
Command privilege level: 0
Allowed during upgrade: No
Example
This example sets the time zone to Pacific time.
set timezone Pacset trace
This command sets trace activity for the specified task.
Command Syntax
set trace
enable Error tname
enable Special tname
enable State_Transition tname
enable Significant tname
enable Entry_exit tname
enable Arbitrary tname
enable Detailed tname
disable tname
Parameters
•
•
•
•
•
•
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
set web-security
This command sets the web security certificate information for the operating system.
Command Syntax
set web-security orgunit orgname locality state country
Parameters
•
•
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: No
set workingdir
This command sets the working directory for active, inactive, and installation logs.
Command Syntax
set workingdir
activelog directory
inactivelog directory
install directory
tftp directory
Parameters
•
•
•
•
•
Requirements
Command privilege level: 0 for logs, 1 for TFTP
Allowed during upgrade: Yes
show account
This command lists current administrator accounts, except the master administrator account.
Command Syntax
show account
Requirements
Command privilege level: 4
Allowed during upgrade: Yes
show cert
This command displays certificate contents and certificate trust lists.
Command Syntax
show cert
own filename
trust filename
list {own | trust}
Parameters
•
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
This command displays own certificate trust lists.
show cert list ownshow ctl (Connection 2.1 Only)
Added January 7, 2008This command displays the contents of the Certificate Trust List (CTL) file on the server. It notifies you if the CTL is not valid.
Command Syntax
show ctl
show cuc config groups
This command displays a list of the valid configuration group names.
Command Syntax
show cuc config groups [page]
Option
•
Usage Guidelines
To see a list of the settings for a specified group, run the command show cuc config settings.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc config groupsCiscoLicensingConfigurationAssistantConversationsDirectoryGroupwareLogMgrMessaging::Telephonyshow cuc config settings
This command displays the settings and values for a specified group of Connection configuration settings.
Command Syntax
show cuc config settings group_name [page]
Parameter
•
To see a list of valid group names, run the command show cuc config groups. Group names are case sensitive.
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example shows the configuration settings for the group SA.
show cuc config settings SASA Setting Value------------------ -----SessionTimeout 20Use24HrClockFormat 0show cuc dbconsistency
This command checks the tables and indexes of a specified database for inconsistencies.
Command Syntax
show cuc dbconsistency database_name
Parameters
•
–
–
–
–
Usage Guidelines
When the command completes, detailed information is saved in a log file, and a summary of the results is displayed, including the location of the log file. Use the file commands to display the contents of the file.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example checks the consistency of the unityrptdb database.
show cuc dbconsistency unityrptdbChecking consistency of unityrptdb tables. Please wait.Consistency check of unityrptdb tables successful.Validation of unityrptdb indexes successful.Output is in file: cuc/cli/consistency_unityrptdb_070404-123636.txtshow cuc dbcontents
This command exports the data from a specified database to a CSV file.
Command Syntax
show cuc dbcontents database_name
Parameters
•
–
–
–
–
Usage Guidelines
When the command completes, the location of the CSV file is displayed. Use the file commands to display the contents of the file.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example exports the data from the unitydirdb database to a CSV file and displays the location of the file.
show cuc dbcontents unitydirdbThis operation may take a few minutes to complete. Please wait.Output is in file: cuc/cli/contents_unitydirdb_070404-124027.csvshow cuc dbschema
This command exports to a file the SQL statements necessary to replicate the schema for a specified database.
Command Syntax
show cuc dbschema database_name
Parameters
•
–
–
–
–
Usage Guidelines
When the command completes, the location of the file is displayed. Use the file commands to display the file.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example exports the schema of the unitydirdb database to a file and displays the location of the file.
show cuc dbschema unitydirdbOutput is in file: cuc/cli/schema_unitydirdb_061013-115815.sqlshow cuc dbserver disk
This command displays summary information about Informix storage space for all Connection databases on the current server.
Command Syntax
show cuc dbserver disk [page | file]
Options
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbserver diskDbspaces========Dbspace Dbspace Size Used Free PercentNumber Name MB MB MB Free------- ------------------ ------ ----- ------ -------1 rootdbs 300.0 107.3 192.7 642 ciscounity_sbspace 20.0 19.0 1.0 5Chunks======Size FreeChunk Offset MB MB Path----- ------ ------ ------ -------------------------------------------------1 0 300.0 192.7 /var/opt/cisco/connection/db/root_dbspace2 250 20.0 1.0 /usr/local/cm/db/informix/databases/ciscounity_sbspaceshow cuc dbserver session
This command displays summary information about a specified Informix database user session.
Command Syntax
show cuc dbserver session session_id [page | file]
Parameter
•
Options
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example displays summary information about database user session 63.
show cuc dbserver session 63IBM Informix Dynamic Server Version 10.00.UC4W3 -- On-Line -- Up 5 days 20:38:40 -- 255716 Kbytessession #RSAM total used dynamicid user tty pid hostname threads memory memory explain63 dbuser - 11488 smilliga 1 184320 143808 offtid name rstcb flags curstk status108 sqlexec 4bedd2b0 Y--P--- 4064 cond wait(netnorm)Memory pools count 1name class addr totalsize freesize #allocfrag #freefrag63 V 4e774020 180224 38064 134 30name free used name free usedsql 0 40 rdahead 0 448Sess SQL Current Iso Lock SQL ISAM F.E.Id Stmt type Database Lvl Mode ERR ERR Vers Explain63 - ccm0500v0000 CR Wait 30 0 0 9.03 OffLast parsed SQL statement :select paramvalue from processconfig whereparamName='RisCleanupTimeOftheDay'show cuc dbserver sessions all
This command displays summary information about all of the current Informix database user sessions.
Command Syntax
show cuc dbserver sessions all [page | file]
Options
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbserver sessions allIBM Informix Dynamic Server Version 10.00.UC4W3 -- On-Line -- Up 5 days 20:38:40 -- 255716 Kbytessession #RSAM total used dynamicid user tty pid hostname threads memory memory explain63 dbuser - 11488 smilliga 1 184320 143808 offtid name rstcb flags curstk status108 sqlexec 4bedd2b0 Y--P--- 4064 cond wait(netnorm)Memory pools count 1name class addr totalsize freesize #allocfrag #freefrag63 V 4e774020 180224 38064 134 30name free used name free usedopentable 0 3256 filetable 0 704Sess SQL Current Iso Lock SQL ISAM F.E.Id Stmt type Database Lvl Mode ERR ERR Vers Explain63 - ccm0500v0000 CR Wait 30 0 0 9.03 OffLast parsed SQL statement :select paramvalue from processconfig whereparamName='RisCleanupTimeOftheDay 'show cuc dbserver sessions list
This command displays a list of the current Informix database user sessions.
Command Syntax
show cuc dbserver sessions list [page]
Option
•
Usage Guidelines
The names of internal database users generally correspond with the names of Connection components. Run this command before you run show cuc dbserver session to obtain the required session id.
Results are sorted by session id.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbserver sessions listSession Database User PID------- ----------- ------------------ ----14 unitydirdb tomcat 47074986 unitydirdb cudbeventpublisher 5818show cuc dbserver user list
This command displays a list of the active Connection internal database users.
Command Syntax
show cuc dbserver user list [page]
Option
•
Usage Guidelines
The names of internal database users generally correspond with the names of Connection components.
Results are sorted first by database and then by user.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbserver user listDatabase User Session PID----------- ------------------ ------- ----unitydirdb tomcat 18 4707unitydirdb cunotifier 5064 8690unitydirdb cumta 5028 8504unitydirdb cumixer 5018 8190unitydirdb cuscavenger 5114 8943show cuc dbserver user waiting
This command displays a list of the Connection internal users, if any, that are waiting for a resource.
Command Syntax
show cuc dbserver user waiting [page]
Option
•
Usage Guidelines
The names of internal database users generally correspond with the names of Connection components.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbserver user waitingUser Session Waiting OnName ID Latch Lock Buffer Chkpt Trans In Crit------------------ ------- ----- ---- ------ ----- ----- -------cucsmgr 5403 N N N N N Ncudbeventpublisher 4989 N N N N N Ncugalsvc 5097 N N N N N Nshow cuc dbtable contents
This command exports the contents of a specified table to a CSV file.
Command Syntax
show cuc dbtable contents database_name table_name
Parameters
•
–
–
–
–
•
For a list of the tables in a specified database, use the show cuc dbtable list command. Table names are case sensitive.
Usage Guidelines
When the command completes, the location of the CSV file is displayed. Use the file commands to display the contents of the file.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbtable contents unitydirdb tbl_cosOutput is in file: cuc/cli/contents_tbl_cos_1013-113910.csvshow cuc dbtable list
This command displays a list of the tables in a specified database.
Command Syntax
show cuc dbtable list database_name [page]
Parameter
•
–
–
–
–
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc dbtable list unitydirdbtbl_accountlogonpolicytbl_agencytbl_agencyextensionrangetbl_aliastbl_alternatenametbl_broadcastmessagetbl_broadcastmessagerecipient...tbl_waveformatshow cuc dbtable schema
This command displays a description for a specified table and a list of the columns in the table.
Command Syntax
show cuc dbtable schema database_name table_name [page]
Parameters
•
–
–
–
–
•
For a list of the tables in a specified database, use the show cuc dbtable list command. Table names are case sensitive.
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example displays the schema for the table tbl_user in the database unitydirdb.
show cuc dbtable schema unitydirdb tbl_cosA collection of service privileges for subscribers that control access tofeatures and use of the system into classes. Class Of Service objectsdetermine which features a subscriber is licensed to use, the maximum lengthof their greetings and messages, what numbers they are allowed to dial, andwhat options are available to the subscriber among other things.Columns:displaynamemovetodeletefolderaccessunifiedclient...accesslivereplyshow cuc dbview contents
This command saves the results from a specified SQL view in a CSV file.
Command Syntax
show cuc dbview contents database_name view_name
Parameters
•
–
–
–
–
•
For a list of the views in a specified database, use the show cuc dbview list command. View names are case sensitive.
Usage Guidelines
When the command completes, the location of the CSV file is displayed. Use the file commands to display the contents of the file.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example saves the results from the view vw_cos, in the database unitydirdb, to a CSV file.
show cuc dbview contents unitydirdb vw_cosOutput is in file: cuc/cli/contents_vw_cos_061013-113910.csvshow cuc dbview list
This command displays a list of the views in a specified database.
Command Syntax
show cuc dbview list database_name [page]
Parameter
•
–
–
–
–
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example displays a list of the views in the unitydirdb database.
show cuc dbview list unitydirdbvw_agencyvw_agencyextensionrangevw_aliasvw_alternatenamevw_broadcastmessagevw_broadcastmessagerecipientvw_callaction...vw_waveformatshow cuc dbview schema
This command displays the schema for a specified view.
Command Syntax
show cuc dbview schema database_name view_name [page]
Parameters
•
–
–
–
–
•
For a list of the views in a specified database, use the show cuc dbview list command. View names are case sensitive.
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example displays the schema for the view vw_user in the database unitydirdb.
show cuc dbview schema unitydirdb vw_cosA simple view for tbl_Cos.Columns:objectidaccessfaxmailaccessttscallholdavailablecallscreenavailablecanrecordname...requiresecuremessagesshow cuc locales
This command displays a list of the locales currently installed.
Command Syntax
show cuc locales
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc localesInstalled Locale Package Locale------------------------- ------uc-locale-en_GB-6.0.0.0-0 en-GBuc-locale-fr_CA-6.0.0.0-0 fr-CAshow cuc sysagent task list
This command displays a list of the Sysagent tasks.
Command Syntax
show cuc sysagent task list [page]
Option
•
Usage Guidelines
To run a sysagent task, use the run cuc sysagent task command.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc sysagent task listBroadcastMessagePurgeCallManagerSubscriberTemplateSynchTaskCallManagerUserSynchTaskCertificateManagementCleanDeletedMessagesTaskCleanDirectoryStreamFilesTaskCleanOrphanAttachmentFilesTask...UpdateDatabaseStatsshow cuc sysagent task results
This command displays the time(s) at which the specified task started and completed, with the most recent time listed first.
Command Syntax
show cuc sysagent task results task_name [page]
Parameters
•
For a list of task names, run the show cuc sysagent task list command. Task names are case sensitive.
Option
•
Usage Guidelines
To run a Sysagent task, use the run cuc sysagent task command.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
The following example displays the times at which the Sysagent task CleanDeletedMessages started and completed.
show cuc sysagent task results CleanDeletedMessagesTaskTime Started Time Completed----------------------- -----------------------2006-10-25 17:31:45.689 2006-10-25 17:31:45.7852006-10-25 17:16:45.702 2006-10-25 17:16:45.7422006-10-25 17:01:45.690 2006-10-25 17:01:45.730show cuc tech dbschemaversion
This command displays the schema version information for each database.
Command Syntax
show cuc tech dbschemaversion [page]
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbschemaversionunitydirdb==========Schema Version Product Version Date-------------- --------------- ---------------------1.2.363 2.1 2007-02-13 19:10:50.0show cuc tech dbserver all
This command runs all of the show cuc tech commands in sequence and saves the results in a text file.
Command Syntax
show cuc tech dbserver all
Usage Guidelines
When the command completes, detailed information is saved in a text file, and the location of the text file is displayed. Use the file commands to display the contents of the file.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbserver allOutput is in file: cuc/cli/dbserverall_061013-111801.txtshow cuc tech dbserver integrity
This command checks the integrity of the Informix database server storage space structure.
Command Syntax
show cuc tech dbserver integrity
Usage Guidelines
When the command completes, detailed information is saved in a text file, and a summary of the results is displayed, including the location of the file. Use the file commands to display the contents of the file.
The following warning is expected and should be ignored in the output file:
WARNING: No syssyntable records foundRequirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbserver integrityDatabase system catalog tables were successfully validated.Database disk extents were successfully validated.Database reserved pages were successfully validated.Output is in file: cuc/cli/integrity_061013-95853.txtshow cuc tech dbserver log diagnostic
This command checks for the existence of Informix assertion-failure and shared-memory-dump logs.
Command Syntax
show cuc tech dbserver log diagnostic
Usage Guidelines
If the logs exist, their location is displayed. Use the file commands to display the contents of the files.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbserver log diagnosticThe following Informix logs are available for the UC database server:core/af.3599ccore/af.36858show cuc tech dbserver log message
This command displays the last n lines of the Informix message log.
Command Syntax
show cuc tech dbserver log message [lines] [page]
Parameter
•
Option
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbserver log messageMessage Log File: online.ciscounity.log18:09:01 Fuzzy Checkpoint Completed: duration was 0 seconds, 6 buffers not flushed.18:09:01 Checkpoint loguniq 57, logpos 0x208418, timestamp: 0x33b80718:09:01 Maximum server connections 15918:14:01 Fuzzy Checkpoint Completed: duration was 0 seconds, 6 buffers not flushed.18:14:01 Checkpoint loguniq 57, logpos 0x20a57c, timestamp: 0x33b9fcshow cuc tech dbserver status
This command saves a detailed status report of the database server instance to a file.
Command Syntax
show cuc tech dbserver status
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc tech dbserver statusOutput is in file: cuc/cli/status_061013-95031.txtshow cuc trace levels
This command displays a list of all the diagnostic traces and trace levels that are currently enabled.
Command Syntax
show cuc trace levels [page]
Option
•
Usage Guidelines
To enable or disable specified traces and trace levels, use the set cuc trace command.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc trace levelsTrace Name Levels------------------------- --------------Arbiter -AudioStore 0AxlAccess -BulkAdministrationTool 0CCL 10,11CDE 3,14CDL 11,13,15,17::VirtualQueue -show cuc version
This command displays the Cisco Unity Connection version currently installed on the active and inactive partitions.
Command Syntax
show cuc version
Usage Guidelines
This command always displays the version in the active partition. If the active partition contains an upgrade, then the command will also show the version in the inactive partition. The current Engineering Special, if any, is also displayed.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
show cuc versionActive version: 2.0(1.0)show diskusage (Connection 2.1 Only)
This command displays information about disk usage on the server.
Command Syntax
show diskusage
activelog {filename filename | directory | sort}
common {filename filename | directory | sort}
inactivelog {filename filename | directory | sort}
install {filename filename | directory | sort}
tftp {filename filename | directory | sort}
tmp {filename filename | directory | sort}
Parameters
•
•
•
•
•
•
Options
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show environment
This command displays information about the server hardware.
Command Syntax
show environment
fans
power-supply
temperatures
Options
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show firewall list
This command displays system aspects of the server.
Command Syntax
show firewall list [detail] [page] [file filename]
Options
•
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show hardware
This command displays the following information on the platform hardware.
Command Syntax
show hardware
Usage Guidelines
This command displays the following information on the platform hardware:
•
•
•
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show ipsec
This command displays information on IPSec policies and associations.
Command Syntax
show ipsec
policy
association policy
information policy association
status
Parameters
•
•
•
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: yes
Example
This example displays IPSec policies.
show ipsec policyshow logins
This command lists recent logins to the server.
Command Syntax
show logins number
Parameters
number specifies the number of most recent logins to display. The default is 20.
show memory
This command displays information about the server memory.
Command Syntax
show memory
count
module [ALL | module_number]
size
Options
•
•
•
Parameters
ALL displays information about all installed memory modules.
module_number specifies which memory module to display.
show myself
This command displays information about the current account.
Command Syntax
show myself
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show network
This command displays network information.
Command Syntax
show network
eth0 [detail]
failover [detail] [page]
route [detail]
status [detail] [listen] [process] [all] [nodns] [search stext]
ip_conntrack
max_ip_conntrack
dhcp eth0 status
all [detail]
Parameters
•
•
•
•
•
•
•
•
Options
•
•
•
•
•
•
•
Usage Guidelines
The eth0 parameter displays Ethernet port 0 settings, including DHCP and DNS configurations and options.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Example
This example displays active Internet connections.
show network statusshow open
This command displays open files and ports on the system.
Syntax Description
show open
files [all] [process processID] [regexp reg_exp]
ports [all] [regexp reg_exp]
Parameters
•
•
Options
•
•
•
•
•
show packages
This command displays the name and version for installed packages.
Command Syntax
show packages
active name [page]
inactive name [page]
Parameters
name represents the package name. To display all active or inactive packages, use the wildcard character, *.
Options
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf counterhelp
This command displays the explanation text for the specified perfmon counter.
Command Syntax
show perf counterhelp class-name counter-name
Parameters
•
•
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf list categories
This command lists all categories in the perfmon system.
Command Syntax
show perf list categories
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf list classes
This commands lists the perfmon classes or objects.
Command Syntax
show perf list classes [cat category] [detail]
Options
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf list counter
This command lists perfmon counters for the specified perfmon class.
Command Syntax
list counters class-name [detail]
Parameters
class-name represents a perfmon class name for which you want to list the counters.
Note
Options
detail—Displays detailed information
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf list instances
The command lists the perfmon instances for the specified perfmon class.
Command Syntax
list instances class-name [detail]
Parameters
class-name represents a perfmon class name for which you want to list the counters.
Note
Options
detail—Displays detailed information
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf query class
This command queries a perfmon class and displays all the instances and counter values of each instance.
Command Syntax
show perf query class class-name [,class-name...]
Parameters
class-name specifies the perfmon class that you want to query. You can specify a maximum of 5 classes per command.
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf query counter
This command queries the specified counter and displays the counter value of all instances.
Command Syntax
show perf query counter class-name counter-name [,counter-name...]
Parameters
•
•
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf query instance
This command queries the specified instance and displays all its counter values.
Command Syntax
show perf query instance class-name instance-name [,instance-name...]
Parameters
•
•
Note
Usage Guidelines
This command does not apply to singleton perfmon classes.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show perf query path
This command queries a specified perfmon path.
Command Syntax
show perf query path path-spec [,path-spec...]
Parameters
•
•
You can specify a maximum of 5 paths per command.
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Example
show perf query path "Cisco Phones(phone-0)\CallsAttempted", "Cisco Unified Communications Manager\T1ChannelsActive"show process (Connection 2.1 Version)
Revised January 7, 2008This command displays process and load information.
The command syntax was completely reorganized for Connection 2.1. For the Connection 2.0 version, see the "show process (Connection 2.0 Version)" section.
Command Syntax
show process
list [file filename] [detail]
load [cont] [clear] [noidle] [num number] [thread] [cpu | memory | time] [page]
name process [file filename]
open-fd process-id [, process-id2]
search regexp [file filename]
using-most cpu [number] [file filename]
using-most memory [number] [file filename]
Parameters
•
•
•
•
•
•
•
Options
•
•
•
•
•
•
•
•
•
•
•
•
•
show process (Connection 2.0 Version)
This command displays process and load information.
The command syntax was completely reorganized for Connection 2.1. For the Connection 2.1 version, see the "show process (Connection 2.1 Version)" section.
Command Syntax
show process
load [cont] [clear] [noidle] [num xx] [thread] [cpu] [memory] [time] [specified] [page]
list [page] [short] [detail] [thread] [fd] [cont] [clear] [process id id] [argument id id] [owner name name]
Parameters
•
•
Options
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
This example shows detailed process listing one page at a time.
show process list detail pageshow registry
This command displays the contents of the registry.
Command Syntax
show registry system component [name] [page]
Parameters
•
•
•
Note
Options
page—Displays one page at a time
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
This example shows contents of the cm system, dbl/sdi component.
show registry cm dbl/sdishow risdb
This command displays RIS database table information.
Command Syntax
show risdb
list [file filename]
query table1 table2 table3 ... [file filename]
Parameters
•
•
Options
file filename—Outputs the information to a file
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Example
This example displays a list of RIS database tables.
show risdb listshow smtp
This command displays the name of the SMTP host.
Command Syntax
show snmp
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show stats io
This command displays system IO statistics.
Command Syntax
show stats io [kilo] [detail] [page] [file filename]
Options
•
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show status
This command displays basic platform status.
Command Syntax
show status
Usage Guidelines
This command displays the following basic platform status:
•
•
•
•
•
•
•
•
Requirements
Command privilege level: 0
show tech all
This command displays the combined output of all show tech commands.
Command Syntax
all [page] [file filename]
Options
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech ccm_service
This command displays information on all Cisco Unified Communications Manager services that can run on the system.
Command Syntax
show tech ccm_service
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show tech database
This command creates a CSV file of the entire database.
Command Syntax
show tech database
Connection 2.1 only: dump
Connection 2.1 only: sessions
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech dbintegrity
This command displays the database integrity.
Command Syntax
show tech dbintegrity
show tech dbinuse
This command displays the database in use.
Command Syntax
show tech dbinuse
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech dbschema
This command displays the database schema in a CSV file.
Command Syntax
show tech dbschema
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech dbstateinfo
This command displays the state of the database.
Command Syntax
show tech dbstateinfo
show tech devdefaults
This command displays the device defaults table.
Command Syntax
show tech devdefaults
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech gateway
This command displays the gateway table from the database.
Command Syntax
show tech gateway
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech locales
This command displays the locale information for devices, device pools, and end users.
Command Syntax
show tech locales
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech network (Connection 2.1 Version)
This command displays information about the network aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech network (Connection 2.0 Version)" section.
Command Syntax
show tech network
all [page] [search text] [file filename]
hosts [page] [search text] [file filename]
interfaces [page] [search text] [file filename]
resolv [page] [search text] [file filename]
routes [page] [search text] [file filename]
sockets {numeric}
Parameters
•
•
•
•
•
•
Options
•
•
•
•
Usage Guidelines
The file option saves the information to platform/cli/filename.txt. The file name cannot contain the "." character.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech network (Connection 2.0 Version)
This command displays network aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech network (Connection 2.1 Version)" section.
Command Syntax
show tech network [page] [file filename]
Options
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech notify
This command displays the database change notify monitor.
Command Syntax
show tech notify
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech params all
This command displays all the database parameters.
Command Syntax
show tech params all
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech params enterprise
This command displays the database enterprise parameters.
Command Syntax
show tech params enterprise
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech params service
This command displays the database service parameters.
Command Syntax
show tech params service
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech prefs
This command displays database settings.
Command Syntax
show tech prefs
show tech procedures
This command displays the procedures that are in use for the database.
Command Syntax
show tech procedures
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech routepatterns
This command displays the route patterns that are configured for the system.
Command Syntax
show tech routepatterns
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech routeplan
This command displays the route plan that are configured for the system.
Command Syntax
show tech routeplan
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech runtime (Connection 2.1 Version)
This command displays runtime aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech runtime (Connection 2.0 Version)" section.
Command Syntax
show tech runtime
all [page] [file filename]
cpu [page] [file filename]
disk [page] [file filename]
env [page] [file filename]
memory [page] [file filename]
Parameters
•
•
•
•
•
Options
•
•
Usage Guidelines
The file option saves the information to platform/cli/filename.txt. The file name cannot contain the "." character.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech runtime (Connection 2.0 Version)
This command displays runtime aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech runtime (Connection 2.1 Version)" section.
Command Syntax
show tech params runtime [page] [file filename]
Options
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech systables
This command displays the name of all tables in the sysmaster database.
Command Syntax
show tech systables
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech system (Connection 2.1 Version)
This command displays system aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech system (Connection 2.0 Version)" section.
Command Syntax
show tech system
all [page] [file filename]
bus [page] [file filename]
hardware [page] [file filename]
host [page] [file filename]
kernel [page] [file filename]
software [page] [file filename]
tools [page] [file filename]
Parameters
•
•
•
•
•
•
•
Options
•
•
Usage Guidelines
The file option saves the information to platform/cli/filename.txt. The file name cannot contain the "." character.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech system (Connection 2.0 Version)
This command displays system aspects of the server.
The command syntax was significantly enhanced for Connection 2.1. For the Connection 2.1 version, see the "show tech system (Connection 2.1 Version)" section.
Command Syntax
show tech system [page] [file filename]
Options
•
•
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech table
This command displays the contents of the specified database table.
Command Syntax
show tech table table_name [page] [csv]
Parameters
table_name represents the name of the table to display.
Options
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech triggers
This command displays table names and the triggers that are associated with those tables.
Command Syntax
show tech triggers
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show tech version
This command displays the version of the installed components.
Command Syntax
show tech version [page]
Options
Page—Displays the output one page at a time
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
show timezone
This command displays time zone information.
Command Syntax
show timezone
config
list [page]
Parameters
•
•
Options
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show trace
This command displays trace information for a particular task.
Command Syntax
show trace [task_name]
Parameters
task_name represents the name of the task for which you want to display the trace information.
Note
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
Example
This example displays trace information for cdp.
show trace cdpsshow ups status
This command shows the current status of the USB-connected APC smart-UPS device and starts the monitoring service if not already started.
This command to give full status is only available on 7835-H2 and 7825-H2 servers.
Command Syntax
show ups status
show version
This command displays the software version on the active or inactive partition.
Command Syntax
show version
active
inactive
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show web-security
This command displays the contents of the current web-security certificate.
Command Syntax
show web-security
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
show workingdir
This command retrieves the current working directory for activelog, inactivelog, install, and TFTP.
Command Syntax
show workingdir
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
unset ipsec
This command allows you to disable IPSec policies and associations.
Command Syntax
unset ipsec
policy {ALL | policy-name}
association policy-name {ALL | association-name}
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
unset network
This command unsets DNS options.
Command Syntax
unset network dns options [timeout] [attempts] [rotate]
Parameters
•
•
•
Usage Guidelines
The system asks whether you want to continue to execute this command.
Caution
utils core list
This command lists all existing core files.
Command Syntax
utils core list
utils core analyze
This command generates a backtrace for the specified core file, a thread list, and the current value of all CPU registers.
Command Syntax
utils core analyze core file name
Parameters
•
Usage Guidelines
The command creates a file of the same name as the core file, with a .txt extension, in the same directory as the core file. This command works only on the active partition.
utils create report (Connection 2.1 Only)
This command creates reports about the server in the platform/log directory.
Command Syntax
utils create report
hardware
platform
Parameters
•
•
Usage Guidelines
You are prompted to continue after you enter the command.
To get the report, use the command file get activelog platform/log/filename, where filename specifies the report filename that displays after the command completes.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils csa disable
This command stops Cisco Security Agent (CSA).
Command Syntax
utils csa disable
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils csa enable
This command enables Cisco Security Agent (CSA).
Command Syntax
utils csa enable
Usage Guidelines
The system prompts you to confirm that you want to enable CSA.
Caution
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils csa status
This command displays the current status of Cisco Security Agent (CSA).
Command Syntax
utils csa status
Usage Guidelines
The system indicates whether CSA is running.
Requirements
Command privilege level: 0
Allowed during upgrade: No
utils dbreplication clusterreset (Connection 2.1 Only)
This command resets database replication on an entire cluster.
Command Syntax
utils dbreplication clusterreset
Usage Guidelines
Before you run this command, run the command utils dbreplication stop on all subscribers servers, and then on the publisher server.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils dbreplication dropadmindb (Connection 2.1 Only)
This command drops the Informix syscdr database on any server in the cluster.
Command Syntax
utils dbreplication dropadmindb
Usage Guidelines
You should run this command only if database replication reset or cluster reset fails and replication cannot be restarted.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils dbreplication setrepltimeout (Connection 2.1 Only)
You can use this command to set the timeout for database replication on large clusters.
Command Syntax
utils dbreplication setrepltimeout timeout
Options
•
Usage Guidelines
The default database replication timeout equals 5 minutes. All subscriber servers that are requesting replication within 5 minutes get on the broadcast list and get replicated. For large clusters, you can use the command to increase the default timeout.
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils dbreplication status
This command displays the status of database replication. You should run this command only on the first node (Publisher server) of a cluster.
Command Syntax
utils dbreplication status
utils dbreplication stop
This command stops the automatic setup of database replication.
Command Syntax
utils dbreplication stop
utils dbreplication repair
This command repairs database replication.
Command Syntax
utils dbreplication repair
utils dbreplication reset
This command resets and restarts database replication.
Command Syntax
utils dbreplication reset
utils diagnose (Connection 2.1 Only)
This command enables you to diagnose and attempt to automatically fix system problems.
Command Syntax
utils diagnose
fix
list
module module_name
test
version
Parameters
•
•
•
•
•
•
utils disaster_recovery backup tape
This command starts a backup job and stores the resulting tar file on tape.
Command Syntax
backup tape featurelist tapeid
Parameters
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils disaster_recovery backup network
This command starts a backup job and stores the resulting tar file on a remote server.
Command Syntax
backup network featurelist path servername username
Parameters
•
•
•
•
Usage Guidelines
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils disaster_recovery cancel_backup
This command cancels the ongoing backup job.
Command Syntax
utils disaster_recovery cancel_backup
Usage Guidelines
The system prompts you to confirm that you want to cancel the backup job.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils disaster_recovery restore tape
This command starts a restore job and takes the backup tar file from tape.
Command Syntax
restore tape server tarfilename tapeid
Parameters
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils disaster_recovery restore network
This command starts a restore job and takes the backup tar file from a remote server.
Command Syntax
restore network restore_server tarfilename path servername username
Parameters
•
•
•
•
•
Usage Guidelines
Note
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils disaster_recovery show_backupfiles network
This command starts a restore job and takes the backup tar file from a remote server.
Command Syntax
utils disaster_recovery show_backupfiles network path servername username
Parameters
•
•
•
Usage Guidelines
Note
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils disaster_recovery show_backupfiles tape
This command displays information about the backup files that are stored on a tape.
Command Syntax
utils disaster_recovery show_backupfiles tape tapeid
Parameters
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils disaster_recovery show_registration
This command displays the registered features and components on the specified server.
Command Syntax
utils disaster_recovery show_registration hostname
Parameters
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils disaster_recovery show_tapeid
This command displays a list of tape device IDs.
Command Syntax
utils disaster_recovery show_tapeid
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils disaster_recovery status
This command displays the status of the current backup or restore job.
Command Syntax
utils disaster_recovery status operation
Parameters
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils firewall (Connection 2.1 Only)
This command manages the firewall on the node.
Command Syntax
utils firewall
disable {time}
enable
list
status
Parameters
•
•
–
–
–
If you do not specify a time, the default equals 5 minutes.
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils iothrottle enable
This command enables I/O throttling enhancements. When enabled, I/O throttling enhancements lower the impact of upgrades on an active system.
Command Syntax
utils iothrottle enable
utils iothrottle disable
This command disables I/O throttling enhancements. This could adversely affect the system during upgrades.
Command Syntax
utils iothrottle disable
utils iothrottle status
This command displays the status of I/O throttling enhancements.
Command Syntax
utils iothrottle status
utils netdump client
This command configures the netdump client.
Command Syntax
utils netdump client
start ip-address-of-netdump-server
status
stop
Parameters
•
•
•
•
Usage Guidelines
In the event of a kernel panic crash, the netdump client sends diagnostic information about the crash to a netdump server.
Requirements
Command privilege level: 0
Allowed during upgrade: No
utils netdump server
This command configures the netdump server.
Command Syntax
utils netdump server
add-client ip-address-of-netdump-client
delete-client ip-address-of-netdump-client
list-clients
start
status
stop
Parameters
•
•
•
•
•
•
•
Usage Guidelines
In the event of a kernel panic crash, a netdump-enabled client system sends diagnostic information about the crash to the netdump server.
netdump diagnostic information gets stored in the following location on the netdump server: crash/. The subdirectories whose names comprise a client IP address and a date contain netdump information.
You can configure each Cisco Unified Communications Operating System server as both a netdump client and server.
If the server is on another Cisco Unified Communications Operating System server, only the kernel panic trace signature gets sent to the server; otherwise, an entire core dump gets sent.
Requirements
Command privilege level: 0
Allowed during upgrade: No
utils network arp
This command lists, sets, or deletes Address Resolution Protocol (ARP) table entries.
Command Syntax
utils network arp
list [host host] [page] [numeric]
set {host} {address}
delete host
Parameters
•
•
•
•
•
Options
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils network capture eth0
This command captures IP packets on the specified Ethernet interface.
Command Syntax
utils network capture eth0 [page] [numeric] [file fname] [count num] [size bytes] [src addr] [dest addr] [port num]
Parameters
•
Options
•
When you use the page or file options, the complete capture of all requested packets must occur before the command completes.
•
•
The file option saves the information to platform/cli/fname.cap. The filename cannot contain the "." character.
•
For screen output, the maximum count equals 1000, and, for file output, the maximum count equals 10,000.
•
For screen output, the maximum number of bytes equals 128, for file output, the maximum of bytes can be any number or ALL
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils network connectivity (Connection 2.1 Only)
This command verifies the node network connection to the first node in the cluster. Be aware that it is only valid on a subsequent node.
Command Syntax
utils network connectivity
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils network host
This command resolves a host name to an address or an address to a host name.
Command Syntax
utils network host hostname [server server-name] [page] [detail] [srv]
Parameters
•
Options
•
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils network ping
This command allows you to ping another server.
Command Syntax
utils network ping destination [count]
Parameters
•
Options
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils network tracert
This command traces IP packets that are sent to a remote destination.
Command Syntax
utils network tracert destination
Parameters
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils ntp
This command displays the NTP status or configuration.
Command Syntax
utils ntp {status | config}
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils remote_account
This command allows you to enable, disable, create, and check the status of a remote account.
Command Syntax
utils remote_account
status
enable
disable
create username life
Parameters
•
•
Usage Guidelines
A remote account generates a pass phrase that allows Cisco Systems support personnel to get access to the system for the specified life of the account. You can have only one remote account that is enabled at a time.
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
Example
utils remote_account statusutils service list
This command retrieves a list of all services and their status.
Command Syntax
utils service list [page]
Options
•
Requirements
Command privilege level: 0
Allowed during upgrade: Yes
utils service
This command stops, starts, or restarts a service.
Command Syntax
utils service
start service-name
stop service-name
restart service-name
auto-restart {enable | disable | show} service-name
Parameters
•
–
–
–
–
–
–
–
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils sftp handshake
This command exchanges SFTP SSH keys to all members of the cluster.
Command Syntax
utils sftp handshake
utils snmp (Connection 2.1 Only)
Command Syntax
utils snmp
get version community ip-address object [file]
hardware-agents [status | restart]
walk version community ip-address object [file]
Parameters
•
•
•
•
•
•
•
•
•
Requirements
Command privilege level: 1
Allowed during upgrade: Yes
utils snmp test
This commands tests the SNMP host by sending sample alarms to local syslog, remote syslog, and SNMP trap.
Command Syntax
utils snmp test
Requirements
Command privilege level: 0
Allowed during upgrade: No
utils soap realtimeservice test
This command executes a number of test cases on the remote server.
Command Syntax
utils soap realtimeservice test remote-ip remote-https-user remote-https-password
Parameters
•
•
•
Requirements
Command privilege level: 0
Allowed during upgrade: No
utils system
This command allows you to restart the system on the active partition or shut down the system.
Command Syntax
utils system {restart | shutdown }
Usage Guidelines
The utils system shutdown command provides a 5-minute timeout. If the system does not shut down within 5 minutes, the command gives you the option of doing a forced shutdown.
Requirements
Command privilege level: 1
Allowed during upgrade: No
utils system switch-version
Revised March 4, 2009This command allows you to restart the system on the inactive partition.
Command Syntax
utils system switch-version
Usage Guidelines
Administrative changes that are made on the active partition, such as adding new phones, are not synchronized when you switch versions.
utils system upgrade
This command allows you to upgrade the server.
Command Syntax
utils system upgrade
cancel
get {local | remote} filename
list {local | remote] path
start
Parameters
•
•
•
•
•
•
•
•
Usage Guidelines
To upgrade the system, follow these major steps:
1.
2.
3.
