CLI Commands

Delete Commands

delete account

This command allows you to delete an administrator account.

Command Syntax

delete account account-name

Syntax Description

Parameters

Description

account-name

The name of an administrator account

Requirements

Command privilege level: 4

Allowed during upgrade: No

delete dns

This command allows you to delete the IP address for a DNS server.

Command Syntax

delete dns ip-address

Syntax Description

Parameters

Description

ip-address

The IP address of the DNS server that you want to delete.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes a temporary loss of network connectivity.


Requirements

Command privilege level: 1

Allowed during upgrade: No

delete dscp

This command deletes a DSCP port tag.

Command Syntax

delete dscp [port-tag]

Syntax Description

Parameters

Description

[port-tag]

Represents a DSCP port tag, which is a string that is mapped to a TCP or UDP port to identify the application that uses the port. This value is for the portTag field displayed when you use the command show dscp defaults. The set of port tags is predefined.

Useage Guideline

After you delete an enabled port tag, DSCP marking on that port tag stops. You can recreate a deleted port tag when you use the set dscp marking command; enter the name of the port tag that you previously deleted.


Tip

Use the command show dscp defaults to list the configured port tags


Command Mode

Administrator (admin:)

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}

Syntax Description

Parameters

Description

policy-name

An IPsec policy.

association-name

An IPsec association

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]

Syntax Description

Parameters

Description

process-id

The process ID number.

force

(Optional) Tells the process to stop.

terminate

(Optional) Tells the operating system to terminate the process.

crash

(Optional) Crashes the process and produces a crash dump.

Usage Guidelines

Use the force option only if the command alone does not delete the process and use the terminate option only if force does not delete the process.

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

File Commands

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]

Syntax Description

Parameters

Description

[detection-size-kb]

Specifies the minimum file size change that is required for the command to display the file as changed.

Default value: 100 KB.

Usage Guidelines

The command notifies you about a possible impact to system performance and asks you whether you want to continue. The display includes both deleted and new files.


Caution

This command can affect system performance. We recommend that you use the command during off-peak hours.


Requirements

Command privilege level: 0

Allowed during upgrade: No

file delete

This command deletes one or more files.

Command Syntax

file delete {activelog|inactivelog|install} directory/filename [detail] [noconfirm]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

directory/filename

The path and filename of the files to delete. You can use the wildcard character (*) for "filename".

detail

(Optional) Shows a listing of deleted files with the date and time.

noconfirm

(Optional) Deletes files without asking you to confirm each deletion.

Usage Guidelines


Caution

You cannot recover a deleted file except possibly by using the Disaster Recovery System.


You get prompted for confirmation after entering the command. 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.log

file dump

This command dumps the contents of a file to the screen, a page at a time.

Command Syntax

file dump {activelog |inactivelog |install } directory/filename [detail] [hex] [recent] [regexpexpression]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log

directory/filename

The path and "filename" of the file to dump. You can use the wildcard character (*) for filename as long as it resolves to one file.

detail

(Optional) Displays listing with the date and time.

hex

(Optional) Displays output in hexadecimal.

recent

(Optional) Displays the most recently modified file in the directory.

regexp expression

(Optional) Displays only the lines in the file that match the regular expression

Requirements

Command privilege level: 1 for logs

Allowed during upgrade: Yes

Example

This command dumps contents of file _cdrIndex.idx:

file dump activelog cm/cdr/_cdrIndex.idx

file get

This command sends a log to another system using SFTP.

Command Syntax

file get {activelog |inactivelog |install|partBsalog|salog } directory/filename [reltime|abstime] [match][recurs]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

partBsalog

The partBsalog log directory.

salog

The salog log directory.

directory/filename

the path to the files to delete. You can use the wildcard character (*) for filename as long as it resolves to one file.

abstime

(Optional) The absolute time period, specified as hh:mm:MM/DD/YY hh:mm:MM/DD/YY.

reltime

(Optional) The relative time period, specified as months|weeks| days| hours| minutes value.

match

(Optional) Match a particular string in the filename, specified as string value.

recurs

(Optional) Get all files, including subdirectories.

Usage Guidelines

After the command identifies the specified files, you are 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 plat

This 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/2005

file list

This command lists the log files in an available log directory.

Command Syntax

file list {activelog|inactivelog|install|partBsalog|salog} directory/filename[page|detail|reverse] [date | size]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

partBsalog

The partBsalog log directory.

salog

The salog log directory.

directory

The path to the directory to list. You can use a wildcard character (*) for directory as long as it resolves to one directory.

page

(Optional) Shows the output one screen at a time.

detail

(Optional) Shows a detailed listing with date and time.

reverse

(Optional) Reverse the sort direction.

date

(Optional) Sorts by date.

size

(Optional) Sorts by file size.

Requirements

Command privilege level: 1 for logs

Allowed during upgrade: Yes

Examples

This example lists operating system log files with details:

file list activelog platform/log page detail

This example lists directories created for Emergency Responder logs:

file list activelog er/logs

This example lists Emergency Responder logs in a specified directory by size:

file list activelog er/logs size

file search

This command searches the content of a log and displays the matching lines a page at a time.

Command Syntax

file search{ activelog | inactivelog |install } directory/filename reg-exp [abstime hh:mm:ss mm/dd/yyyy hh:mm:ss mm/dd/yyyy] [ignorecase] [reltime {days | hours | minutes} timevalue]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

directory/filename

The path to the files to search. You can use the wildcard character (*) to represent all or part of the filename.

reg-exp

A regular expression.

abstime

(Optional) The files to search based on file creation time. Enter a start time and an end time.

days|hours|minutes

(Optional) The file age is in days, hours, or minutes.

ignorecase

(Optional) Ignores case when searching

reltime

(Optional) The files to search based on file creation time. Enter the age of files to search.

hh:mm:ss mm/dd/yyyy

(Optional) An absolute time, in the format hours:minutes:seconds month/day/year.

timevalue

(Optional) The age of files to search. The unit of this value is specified with the {days | hours | minutes} option.

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] ignorecase

file tail

This command prints the last few lines of a log file.

Command Syntax

file tail {activelog |inactivelog |install } directory/filename[detail] [hex] [lines]

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

directory/filename

The path to the file to tail. You can use the wildcard character (*) for filename as long as it resolves to one file.

detail

(Optional) Long listing with date and time

hex

(Optional) Hexadecimal listing

lines

(Optional) Number of lines to display

Requirements

Command privilege level: 1 for logs

Allowed during upgrade: Yes

Example

This example tails the operating system CLI log file:

file tail activelog platform/log/cli00001.log

file view

This command displays the contents of a file.

Command Syntax

file view {activelog|inactivelog|install|system-management-log}directory/filename

Syntax Description

Parameters

Description

activelog

A log on the active side.

inactivelog

A log on the inactive side.

install

An installation log.

system-management-log

The contents of the Integrated Management Logs (IML).

directory/filename

The path to the file to view. You can use the wildcard character (*) for filename as long as it resolves to one file.

Usage Guidelines


Caution

Do not use this command to view binary files because this can corrupt the terminal session.


Requirements

Command privilege level: 0

Allowed during upgrade: Yes

Examples

This example displays the install log:

file view install install.log

This example displays a particular CDR file:

file view activelog er/logs/CERAdmin01.log

Run and Set commands

run sql

This command allows you to run an SQL command.

Command Syntax

run sql sql_statement

Syntax Description

Parameters

Description

sql_statement

The SQL command to run.

Requirements

Command privilege level: 1

Allowed during upgrade: No

Examples

This example runs an SQL command:

run sql select * from cerserver

set account

This command sets up a new account on the operating system.

Command Syntax

set account name

Syntax Description

Parameters

Description

name

The username for the new account.

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 account enable

This command is used to enable the user account if the account is disabled due to the password inactivity feature.

Password inactivity period is the number of days of inactivity after a password has expired before the account is disabled.

After entering this command, the user account is enabled with current system settings.The system settings are Password min days, Password Max days, Password inactivity period.

Command Syntax

set account enable userid

Syntax Description

Parameters

Description

userid

The name of the user account.

Example

This example runs a set account enable command:

set account enable test
Enabling the account 'test' with current settings....
.....
Successfully enabled account 'test'

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show accountlocking

This command shows the current account locking settings.

Command Syntax

show accountlocking

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set accountlocking disable

This command disables accountlocking for the current administrator accounts.

Command Syntax

set accountlocking disable

Syntax Description

Parameters

Description

disable

Disable account locking.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set accountlocking enable

This command enables accountlocking for the current administrator accounts.

Command Syntax

set accountlocking enable

Syntax Description

Parameters

Description

enable

Enable account locking.

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

set accountlocking unlocktime

This command configures the unlock time for Emergency Responder OS administrator accounts in seconds.

Acceptable values should be equal to or greater than 300 seconds, but less than 3600 seconds (60 mins).

Command Syntax

set accountlocking unlocktime seconds

Syntax Description

Parameters

Description

seconds

The unlocktime in seconds.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set cert delete

This command deletes the certificate test.pem for the unit IPsec.

Command Syntax

set cert delete [unit] [name]

Syntax Description

Parameters

Description

unit

The name of the trust category.

name

The certificate file name.

Example

set cert
		  delete ipsec test.pem

Requirements

Command privilege level: 1

Allowed during upgrade: No

set cert import

This command imports the certificate for a specific unit | trust.

Command Syntax

set cert import [unit name]

Syntax Description

Parameters

Description

unit name

The name of the unit or trust.

Example

The following example runs a set cert import command:

set cert
		  import trust tomcat
		
Successfully regenerated certificate for tomcat.
Please restart services related to tomcat for the new certificate to become active.
		

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set cert regen

This command regenerates the certificate for the unit.

Command Syntax

set cert regen [name]

Parameter

Name is unit name

Syntax Description

Parameters

Description

Name

The name of the unit.

Example

This example runs a set cert regen command:

set cert regen tomcat
Successfully regenerated certificate for tomcat.
Please restart services related to tomcat for the new certificate to become active.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set cli pagination

For the current CLI session, this command turns automatic pagination on or off.

Command Syntax

set cli pagination {on | off}

Syntax Description

Parameters

Description

on

Turns pagination on.

off

Turns pagination off.

Requirements

Level privilege: 1

Command privilege: 1

Allowed during upgrade: No

Example

admin:set cli pagination off
Automatic pagination is turned off

set cli session timeout

This command sets the time, in minutes, after which an active CLI session times out and disconnects.

Command Syntax

set cli session timeoutminutes

Syntax Description

Parameters

Description

minutes

Specifies the time, in minutes, that can elapse before an active CLI session times out and disconnects:
  • Value range: 5-99999 minutes

  • Default value: 30 minutes

Useage Guidelines

Be aware that the new session timeout value becomes effective immediately for a new CLI session; however, active sessions retain their original timeout value. Also the show cli session timeout command reflects the new value, even if the current session does not use that value.


Note

This setting gets preserved through a software upgrade and does not get reset to the default value.


Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: No

set commandcount

This command changes the CLI command prompt so that it displays how many CLI commands have executed.

Command Syntax

set commandcount {enable | disable}

Syntax Description

Parameters

Description

enable

Turns on command count.

disable

Turns off command count.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set csr gen

It regenerates the certificate for the unit name.

Command Syntax

set csr gen name

Syntax Description

Parameters

Description

name

Specifies the unit on which the certificate is generated.

Example

set csr gen tomcat

Successfully regenerated certificate for tomcat.

Please restart services related to tomcat for the new certificate to become active.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set date

This command sets the date on the system.

Command Syntax

set date HH:mm:ss:MM/DD/YY

Syntax Description

Parameters

Description

HH:mm:ss

Represents the time format (24 hours format).

MM/DD/YY

Represents the date format.

This date format is also accepted: MM/DD/YYYY.

Requirements

Command privilege level: 1

Allowed during upgrade: No

Example

To set date and time to 2:10:33 p.m. February 13, 2008:

set date 14:10:33:02/13/08
		

set dscp

This command enables or disables DSCP marking on outgoing TCP or UDP packets. You can enable or disable DSCP on a single port tag, or on all port tags at once.

Command Syntax

set dscp {enable | disable} {all| port_tag}

Syntax Description

Parameters

Description

all

Disables all DSCP port tags.

port_tag

Represents a DSCP port tag, which is a string that is mapped to a TCP or UDP port to identify the application that uses the port. This value is for the portTag field displayed when you use the command show dscp defaults.

The set of port tags is predefined.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: No

set dscp defaults

This command sets the factory default DSCP settings for all of the port tags.

Command Syntax

set dscp defaults

Command Mode

Administrator (admin:)

Useage Guidelines

This command removes all non-default DSCP settings. The command show dscp defaults displays the factory default DSCP settings.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set dscp marking

This command sets DSCP markings on port tags by using well-known DSCP classes and numeric values.

Command Syntax

set dscp marking port_tag value

Syntax Description

Parameters

Description

port_tag

Represents a DSCP port tag, which is a string that is mapped to a TCP or UDP port to identify the application that uses the port. This value is for the portTag field displayed when you use the command show dscp defaults.

value

A DSCP value. You can enter the name of a well-known DSCP class or a numeric value in decimal or hexadecimal format. Precede hexadecimal values with 0x or 0X.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: No

Useage Guidelines

The valid class names as defined by DSCP are:
  • Class Selector: values CS0, CS1, CS2, CS3, CS5, CS6, CS7 The class selector (CS) values correspond to IP Precedence values and are fully compatible with IP Precedence.

  • Expedited Forwarding: value EF EF PHB is ideally suited for applications such as VoIP that require low bandwidth, guaranteed bandwidth, low delay, and low jitter.

  • Best Effort: value BE Also called default PHB, this value essentially specifies that a packet be marked with 0x00, which gets the traditional best-effort service from the network router.

  • Assured Forwarding: values AF11, AF12, AF13, AF21, AF22, AF23, AF41, AF42, AF43 There are four types of Assured Forwarding classes, each of which has three drop precedence values. These precedence values define the order in which a packet is dropped (if needed) due to network congestion. For example, packets in AF13 class are dropped before packets in the AF12 class.

set 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}

Syntax Description

Parameters

Description

policy-name

An IPSec policy.

association-name

An IPSec association.

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}

Syntax Description

Parameters

Description

enable

Turns on logging.

disable

Turns off logging.

Requirements

Command privilege level: 0

Allowed during upgrade: No

set network cluster publisher hostname

This command configures the cluster publisher hostname. Changing the hostname is possible only from the subscriber in a server group. This is supported when migrating from MCS to VMware platforms, but not in any other scenarios.

A temporary loss of network connectivity occurs while the network is being restarted with the new configuration.

Command Syntax

set network cluster publisher hostname name

Syntax Description

Parameters

Description

name

The hostname to be assigned.

set network cluster publisher ip

This command configures the cluster publisher IP address.

A temporary loss of network connectivity occurs while the network is being restarted with the new configuration.

Command Syntax

set network cluster publisher ip addr

Syntax Description

Parameters

Description

ip addr

Specifies the ip address of the network cluster.

set network dhcp

This command enables or disables DHCP for Ethernet interface 0. You cannot configure Ethernet interface 1.

Command Syntax

set network dhcp eth0{enable| disable}{node_ip| net_mask| gateway_ip}

Syntax Description

Parameters

Description

eth0

Specifies Ethernet interface 0.

enable

This enables DHCP.

disable

This disables DHCP.

node_ip

The new static IP address for the server.

net_mask

The subnet mask for the server.

gateway_ip

The IP address of the default gateway.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes the system to restart. We recommend that you restart all nodes whenever any IP address gets changed.


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

Syntax Description

Parameters

Description

ip-address

The IP address of the primary or secondary DNS server.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes a temporary loss of network connectivity. If you change the IP address of the DNS server, you must restart Cisco Tomcat. For more information, see utils service.


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]

Syntax Description

Parameters

Description

timeout

Sets the DNS request timeout.

seconds

The DNS timeout period, in seconds.

attempts

Sets the number of times to attempt a DNS request before quitting.

number

Specifies the number of attempts.

rotate

Causes the system to rotate among the configured DNS servers, distributing the load.

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

Syntax Description

Parameters

Description

domain-name

The system domain that you want to assign.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes a temporary loss of network connectivity.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set network failover

This command enables and disables network fault tolerance.

Command Syntax

failover {enable | disable}

Syntax Description

Parameters

Description

enable

Enables network fault tolerance.

disable

Disables network fault tolerance.

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

Syntax Description

Parameters

Description

ip-address

The IP address of the network gateway that you want to assign.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes the system to restart.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set network hostname

This command allows an administrator to set the network host name, change the IP address of the node, and restart the system.

Before attempting this command, the administrator should have a valid DRF backup.

Command Syntax

set network hostname hostname

Syntax Description

Parameters

Description

hostname

Represents the new network hostname of the system.

Note 

The host name must follow the rules for ARPANET host names. It must start with an alphabetic character, end with an alphanumeric character, and consist of alphanumeric characters and hyphens. The host name can have a maximum length of 63 characters.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: No

Useage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes the system to restart.


Example

admin:set network hostname
WARNING: Changing this setting will invalidate software license on this server. The license will have to be re-hosted.
Continue(y/n):
Continue (y/n)?y

ctrl-c: To quit the input.

*** W A R N I N G ***
Do not close this window without first canceling the command.

This command will automatically restart system services.
The command should not be issued during normal operating
hours.

=======================================================
Note: Please verify that the new hostname is a unique
name across the cluster and, if DNS services are
utilized, any DNS configuration is completed
before proceeding.
=======================================================

Security Warning : This operation will regenerate
all CUCM Certificates including any third party
signed Certificates that have been uploaded.

Enter the hostname:: app-lfwelty5
Would you like to change the network ip address at this time [yes]::


Warning: Do not close this window until command finishes.



ctrl-c: To quit the input.



*** W A R N I N G ***
=======================================================
Note: Please verify that the new ip address is unique
across the cluster.
=======================================================

Enter the ip address:: 106.1.34.154
Enter the ip subnet mask:: 255.0.0.0
Enter the ip address of the gateway:: 106.1.1.1
Hostname: app-lfwelty5
IP Address: 106.1.34.154
IP Subnet Mask: 255.0.0.0
Gateway: 106.1.1.1

Do you want to continue [yes/no]? yes
...

Note

The administrator can change both the hostname and IP address by responding yes. To change just the hostname, respond 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

Syntax Description

Parameters

Description

eth0

Specifies Ethernet interface 0.

ip-address

The IP address that you want assign.

ip-mask

The IP mask that you want to assign.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes the system to restart.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set network max_ip_contrack

This command sets the ip_conntrack_max value.

Command Syntax

set network max_ip_conntrack ip_conntrack_max

Syntax Description

Parameters

Description

ip_conntrack_max

Specifies the value for ip_conntrack_max.

set network mtu

This command sets the maximum MTU value.

Command Syntax

set network mtu mtu_max

Syntax Description

Parameters

Description

mtu_max

Specifies the maximum MTU value.

Note 

The system default MTU value equals 1500.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, the system temporarily loses network connectivity.


Requirements

Level privilege: 1

Command privilege: 1

Allowed during upgrade: No

Example

admin:set network mtu 576          ***   W A R N I N G   ***
This will cause the system to temporarily lose network connectivity

          Do you want to continue?

Enter "yes" to continue or any other key to abort

yes
executing...

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}}

Syntax Description

Parameters

Description

eth0

Specifies Ethernet interface 0.

auto

Specifies whether auto negotiation gets enabled or disabled.

speed

Specifies the speed of the Ethernet connection: 10 or 100 Mbps.

duplex

Specifies half-duplex or full-duplex.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, this command causes a temporary loss of network connections while the NIC gets reset.



Note

You can enable only one active NIC at a time.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set network ntp option

This command adds a noquery option to /etc/config file.

Command Syntax

set network ntp option noquery

set network pmtud

This command enables and disables path MTU discovery.

Command Syntax

set network pmtud{enable | disable}

Syntax Description

Parameters

Description

enable

Enables Path MTU Discovery.

disable

Disables Path MTU Discovery.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, the system temporarily loses network connectivity.


Requirements

Level privilege: 1

Command privilege: 1

Allowed during upgrade: No

Example

This example runs the set network pmtud command.

admin:set network pmtud enable          
***   W A R N I N G   ***
This will cause the system to temporarily lose network connectivity

          Do you want to continue?

Enter "yes" to continue or any other key to abort
yes
executing...
admin:

set network restore

This command configures the specified Ethernet port to use a specified static IP address.


Caution

Only use this command option if you cannot restore network connectivity using any other set network commands. This command deletes all previous network settings for the specified network interface, including network fault tolerance. After running this command, you must restore your previous network configuration manually.



Caution

The server temporarily loses network connectivity when you use this command.


Command Syntax

set network restore eth0 ip-address network-mask gateway

Syntax Description

Parameters

Description

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}

Syntax Description

Parameters

Description

eth0

Specifies Ethernet interface 0.

up

Sets the status of Ethernet interface 0 to up.

down

Sets the status of Ethernet interface 0 to down.

Usage Guidelines

The system asks whether you want to continue to execute this command.


Caution

If you continue, the system temporarily loses network connectivity.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set password

This command allows you to change the administrator password.

Command Syntax

set password {admin | security}

Syntax Description

Parameters

Description

admin

Administrator.

security

Security.

Usage Guidelines

The system prompts you for the old and new passwords.

The password must contain at least six characters, and the system checks it for strength.

Servers in a cluster use the security password to authenticate communication between servers. You must reset the cluster after you change the security password.

To change a password:

  1. Change the security password on the publisher server and then reboot the server.

  2. Change the security password on all the subscriber servers to the same password that you created on the publisher server and restart the subscriber server to propagate the password change.


Note

We recommend that you restart each server after the password is changed on that server.



Caution

Failure to reboot the servers causes system service problems and problems with the Emergency Responder Administration on the subscriber servers.


Requirements

Command privilege level: 1

Allowed during upgrade: No

set password age minimum

This command modifies the value of minimum password age for OS admin accounts in days.

Usage Guidelines

Acceptable values should be equal to or greater than 0 days but less or equal to 10 days.

Command Syntax

set password age minimum days

Syntax Description

Parameters

Description

days

The minimum password age in days.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password age maximum

This command modifies the value of maximum password age for Emergency Responder OS administration accounts in days.

Command Syntax

set password age maximum days

Usage Guidelines

Acceptable values should be equal to or greater than 10 days but less than 3650 days (10 years).

Syntax Description

Parameters

Description

days

The maximum password age in days.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set password complexity character disable

This command disables password complexity. Changes take effect only at the next password change.

When disabled, the password created or changed after executing the command is no longer strong. The password does not need uppercase, lowercase, digit and special characters.

Command Syntax

set password complexity character disable

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password complexity character enable

This command enables password complexity rules for the type of characters in a password.

When enabled, the passwords need to follow these guidelines:
  • It must have at least one lowercase character.
  • It must have at least one uppercase, one digit, and one special character.
  • All of the adjacent characters on the keyboard are not accepted.
  • Any of the previous ten passwords cannot be reused.
  • The admin user password can only be changed once in 24 hours.
  • A violation of any of the preceding rules results in a failure.

Command Syntax

set password complexity character enable

Requirements

Command privilege level: 1

Allowed during upgrade: No

set password complexity minimum-length

This command modifies the value of minimum password length for Unified CM OS accounts.

Command Syntax

set password complexity minimum-length length

Syntax Description

Parameters

Description

length

The minimum password length.

Useage Guidelines

Acceptable values should be equal to or greater than 6. Use this command only after enabling the character complexity of passwords.

Requirements

Command privilege level: 1

Allowed during upgrade: No

set password expiry maximum-age

This command enables or disables the password expiry maximum age settings for Cisco Unified Operating System Administrator accounts.

Command Syntax

set password expiry maximum-age {enable| disable}

Syntax Description

Parameters

Description

enable

Turns on password expiry maximum age settings for Cisco Unified Operating System administrator accounts. The set password expiry enable command sets the value of maximum password age to 3650 days (10 yrs) for Cisco Unified Operating System Administrator accounts.

disable

Turns off password expiry maximum age settings for Cisco Unified Operating System administrator accounts. The set password expiry disable command results in Cisco Unified Operating System Administrator accounts never expiring.

set password expiry minimum-age enable

This command enables minimum password expiry for OS accounts.

Usage Guidelines

This command sets the value of minimum password age to 1 day (24 hrs) for OS administration accounts.

Command Syntax

set password expiry minimum-age enable.

set password expiry minimum-age disable

This command is used to disable minimum password aging for OS accounts.

This means passwords for OS admin accounts can be changed at any interval.

Command Syntax

set password expiry minimum-age disable

set password expiry user maximum-age disable

This command disables password expiry for a particular OS account.

Command Syntax

set password expiry user maximum-age disable userid

Syntax Description

Parameters

Description

userid

The name of account for which to disable maximum password age settings.

set password expiry user maximum-age enable

This command enables maximum password expiry for a particular OS account.

Command Syntax

set password expiry user maximum-age enable userid

Syntax Description

Parameters

Description

userid

The name of account for which to enable maximum password age settings.

set password expiry user minimum-age disable

This command disables minimum password age settings for a particular OS account.

Command Syntax

set password expiry user minimum-age disable userid

Syntax Description

Parameters

Description

userid

The account for which to disable minimum password age settings.

set password expiry minimum-age enable

This command enables minimum password age for a particular OS account.

Command Syntax

set password expiry user minimum-age enable userid

Syntax Description

Parameters

Description

userid

The account for which to enable minimum password age settings.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password history

This command sets the number of passwords to maintain in history.

Command Syntax

set password history number

Syntax Description

Parameters

Description

number

The number of passwords to maintain in history.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password inactivity disable

This command disables the password inactivity for the OS accounts.

Command Syntax

set password inactivity disable

set password inactivity enable

Command Syntax

This command enables the password inactivity for the OS accounts with the default value set as 10 days.

set password inactivity enable

set password inactivity period

This command sets the password inactivity for the OS accounts with the configured value.

Command Syntax

set password inactivity period days

Syntax Description

Parameters

Description

days

The number of days for which to set inactivity. Acceptable values are 1 to 99 days.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set password user admin

This commands sets a new administration password.

Command Syntax

set password user admin

Example

This example runs the set password user admin command:

set password user admin
Please enter the old password :********
Please enter the new password:********
re-enter new password to confirm:********
		
		

Requirements

Command privilege level: 1

Allowed during upgrade: No

set password user security

This command sets a new platform security password.

Command Syntax

set password user security

Example

This example runs the set password user security command:

set password user security
Please enter the password:********
re-enter the password to confirm: ********
		
		
		

Requirements

Command privilege level: 1

Allowed during upgrade: No

set session maxlimit

This command sets the upper limit for concurrent sessions.

Command Syntax

set session maxlimit [value]

Syntax Description

Parameters

Description

maxlimit

This command sets the upper limit for concurrent sessions. Acceptable values are 1 - 100.

If no upper limit is entered, the default value of 10 is assigned to sshd_config param.

[value]

Acceptable values are 1 - 100.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

set smtp

This command sets the SMTP server hostname.

Command Syntax

set smtp hostname

Syntax Description

Parameters

Description

hostname

The SMTP server name.

Requirements

Command privilege level: 0

Allowed during upgrade: No

set timezone

This command changes the system time zone.

Command Syntax

set timezone timezone

Usage Guidelines

Enter enough characters to uniquely identify the new time zone. Be aware that the time zone name is case-sensitive.


Note

You must restart the system after you change the time zone.


Syntax Description

Parameters

Description

timezone

The new timezone.

Requirements

Command privilege level: 0

Allowed during upgrade: No

Example

This example sets the time zone to Pacific time:

set timezone Pac

set tls min-version

This command sets the minimum version of Transport Layer Security (TLS) protocol.


Note

  • The system automatically restarts after you set the minimum TLS version.

  • You need to configure the minimum TLS version for each node.


Command Syntax

set tls min-version tls minVersion

Syntax Description

Parameters

Description

tls minVersion

Type any one of the following options to set the minimum TLS version.

  • 1.0

  • 1.1

  • 1.2

Command Modes

Administrator (admin:)

Usage Guidelines

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

Applies to: Cisco Emergency Responder

Example

admin: set tls min-version 1.1 

This command results in setting the minimum TLS version to 1.1 to all secured interfaces. If you have custom applications that make secure connection to the system, then make sure the applications support the TLS version that you have selected to configure. See Cisco Unified Reporting Administration Guide to make sure the endpoints in your deployment support this feature.


Warning

This will set the minimum TLS to 1.1 and the server will reboot.


Do you want to continue (Yes or No)? Yes

The minimum TLS version is set to 1.1 successfully.

The system restarts in few minutes.

set tls resumption-timeout

This command sets the number of seconds after which the TLS resumption will not work and the sessions will be invalid.

Command Syntax

set tls resumption-timeout set tls resumption-timeout

Syntax Description

Parameters

Description

seconds

Enter a value up to 3600 seconds to configure. After the configured value, the TLS sessions are invalid.

Command Modes

Administrator (admin:)

Usage Guidelines

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

Applies to: Cisco Emergency Responder

set tls trace

From the release 12.0 onwards, you can enable or disable the TLS tracing for services. Currently, Tomcat is the only supported device. You can use the CLI commands to view the reasons of connection failure of TLS connections to Cisco Emergency Responder.

set tls trace disable

This CLI command disables the TLS tracing for a service.


Note

After you disable the TLS trace for a service, the service automatically gets restarted. During the restart process, any functionality related to the service will be not reachable.


Command Syntax

set tls trace disable service

Syntax Description

Parameters

Description

service

Specifies the service that you use to disable TLS tracing.

Command Modes

Administrator (admin:)

Usage Guidelines

Requirements

Command privilege level: 1

Allowed during upgrade: No

Example
admin:set tls trace disable tomcat 

Warning

This disables the tls trace for Tomcat service and the Tomcat service is automatically restarted.


You must restart the Cisco Tomcat service for the changes to take effect. This will disconnect the active web sessions and all applications on this node will be unavailable until the service restarts. The service restart takes several minutes to complete.

Continue (Y/N)? Y

Successfully disabled tls trace for tomcat.

The Tomcat service will restart.

set tls trace enable

This CLI command enables the TLS tracing for a service.


Note

After you enable the TLS trace for a service, the service automatically gets restarted. During the restart process, any functionality related to the service will be not reachable.


Command Syntax

set tls trace enable service

Syntax Description

Parameters

Description

service

Specifies the service that you use to enable TLS tracing.

Command Modes

Administrator (admin:)

Usage Guidelines

Requirements

Command privilege level: 1

Allowed during upgrade: No

Example
admin:set tls trace enable tomcat 

Warning

This enables the tls trace for Tomcat service and the Tomcat service is automatically restarted.


You must restart the Cisco Tomcat service for the changes to take effect. This will disconnect the active web sessions and all applications on this node will be unavailable until the service restarts. The service restart takes several minutes to complete.

Continue (Y/N)? Y

Successfully enabled tls trace for tomcat.

The Tomcat service will restart.

set trace

This command sets trace activity for the specified task.

Command Syntax

set trace{enable Error| enable Special| enable State_Transition| enable Significant| enable Entry_exit| enable Arbitrary| enable Detailed| disable} tname

Syntax Description

Parameters

Description

tname

The task for which you want to enable or disable traces.

enable Error

Sets task trace settings to the error level.

enable Special

Sets task trace settings to the special level.

enable State_Transition

Sets task trace settings to the state transition level.

enable Significant

Sets task trace settings to the significant level.

enable Entry_exit

Sets task trace settings to the entry_exit level.

enable Arbitrary

Sets task trace settings to the arbitrary level.

enable Detailed

Sets task trace settings to the detailed level.

disable

Disables the task trace settings.

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] [alternate-host-name]

Usage Guidelines

When you set an alternate-host-name parameter with the set web-security command, self-signed certificates for Tomcat contains the Subject Alternate Name extension with the alternate host name specified. CSR for Emergency Responder contains Subject Alternate Name Extension with the alternate host name included in the CSR.

Syntax Description

Parameters

Description

orgunit

The organizational unit.

orgname

The organizational name.

locality

The organization location.

state

The organization state.

country represents

The organization country.

alternate-host-name

(Optional) Specifies an alternate name for the host when you generate a web-server (Tomcat) certificate.

Requirements

Command privilege level: 0

Allowed during upgrade: No

set webapp session timeout

This command sets a timeout period for the web application session of Cisco Emergency Responder and logs off the user on expiry.

For the new webapp session timeout setting to become effective, you must restart the Cisco Tomcat service. Until you restart the Cisco Tomcat service, the show webapp session timeout command reflects the new values, but system continues to use and reflect the old values. This command prompts you to restart the service.


Caution

Restarting the Cisco Tomcat service ends all active sessions and can affect system performance. Cisco recommends that you only execute this command during off-peak traffic hours.



Note

This setting gets preserved through a software upgrade and does not get reset to the default value.


Command Syntax

set webapp session timeout minutes

Syntax Description

Parameters

Description

minutes

Specifies the time, in minutes, that can elapse before a web application times out and logs off the user.
  • Default value: 30 minutes

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: No

set workingdir

This command sets the working directory for active, inactive, and installation logs.

Command Syntax

set workingdir {activelog| inactivelog| install} directory

Syntax Description

Parameters

Description

activelog

Sets the working directory for active logs.

inactivelog

Sets the working directory for inactive logs.

install

Sets the working directory for installation logs.

directory

The current working directory.

Requirements

Command privilege level: 0 for logs

Allowed during upgrade: Yes

Show Commands

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

Table 1. Available Commands

Command

Result

show cert list {own | trust}

This command displays certificate trust lists.

show cert own filename

This command displays certificate contents.

show cert trust filename

This command displays certificate contents.

Syntax Description

Parameters

Description

filename

The name of the certificate file.

own

Specifies owned certificates.

trust

Specifies trusted certificates.

list

Specifies a certificate trust list.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

Example

This command displays own certificate trust lists:

show cert list own

show cli pagination

This command displays the status of the automatic CLI pagination.

Command Syntax

show cli pagination

Requirements

Level privilege: 0

Command privilege: 0

Allowed during upgrade: Yes

Example

The following example runs the show cli pagination command:

admin: show cli paginationAutomatic Pagination: Off.

show cli session timeout

This command displays the CLI session timeout value, which is the amount of time, in minutes, that can elapse before a CLI session times out and disconnects.

Command Syntax

show cli session timeout

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show csr list

This command displays the selected CSR file.

Command Syntax

show csr list type

Example

This example runs a show csr list command:

show csr list own
		
tomcat/tomcat.csr
		
Vipr-QuetzalCoatl/Vipr-QuetzalCoatl.csr
		

show ctl

This command displays the contents of the Certificate Trust List (CTL) file on the server, and it notifies you if the CTL is not valid.

Command Syntax

show ctl

show date

This command shows the system date.

Command Syntax

show date

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show diskusage

This command displays information about disk usage on the server.

Command Syntax

show diskusage activelog {activelog| common| inactivelog| install| tmp} filename filename {directory | sort}

Syntax Description

Parameters

Description

activelog

Displays disk usage information about the activelog directory.

common

Displays disk usage information about the common directory.

inactivelog

Displays disk usage information about the inactivelog directory.

install

Displays disk usage information about the install directory.

tmp

Displays disk usage information about the tmp directory.

filename filename

(Optional)Saves the output to a file specified by a filename. These files are stored in the platform/cli directory. To view saved files, use the file view activelog command.

directory

(Optional)Displays only the directory sizes.

sort

(Optional)Sorts the output based on file size. File sizes are displayed in 1024-byte blocks.

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show dscp all

This command displays the current DSCP traffic markings on all the ports. It displays the DSCP markings in decimal and hexidecimal. If the value corresponds to a class then it displays the correct class. If the value does not correspond to a class, then it displays N/A.

Command Syntax

show dscp all

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: No

show dscp defaults

This command displays the default factory DSCP settings. These values take effect if the set dscp defaults command is executed.

Command Syntax

show dscp defaults

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: No

show dscp marking

This command displays the current DSCP traffic markings for a particular DSCP value.

Command Syntax

show dscp marking value

Syntax Description

Parameters

Description

value

DSCP value. You can enter the name of a well-known DSCP class, or a numeric value in decimal or hexadecimal format. Precede hexadecimal values with 0x or 0X.

Useage Guidelines

The valid class names as defined by DSCP are:
  • Class Selector: values CSO, CS1, CS2, CS3, CS5, CS6 CS7 The class selector (CS) values correspond to IP Precedence values and are fully compatible with IP Precedence.

  • Expedited Forwarding: value EF EF PHB is ideally suited for applications such as VoIP that require low bandwidth, guaranteed bandwidth, low delay, and low jitter.

  • Best Effort: value BE Also called default PHB, this value essentially specifies that a packet be marked with 0x00, which gets the traditional best-effort service from the network router.

  • Assured Forwarding: values AF11, AF12, AF13, AF21, AF22, AF23, AF41, AF42, AF43 There are four types of Assured Forwarding classes, each of which has three drop precedence values. These precedence values define the order in which a packet is dropped (if needed) due to network congestion. For example, packets in AF13 class are dropped before packets in the AF12 class.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show dscp status

This command displays the current DSCP traffic markings.

Command Syntax

show dscp status {enabled|disabled}

Syntax Description

Parameters

Description

enabled

Filters the output to show only DSCP traffic markings that are enabled. If you do not specify a status, this filter is the default option.

disabled

Filters the output to show only DSCP traffic markings that are disabled.

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: No

show environment

This command displays information about the server hardware.

Command Syntax

show environment {fans |power-supply |temperatures}

Syntax Description

Parameters

Description

fans

Displays information gathered by fan probes.

power-supply

Displays information gathered by power supply probes.

temperatures

Displays information gathered by temperature probes.

show hardware

This command displays the following information about the platform hardware.

Command Syntax

show hardware

Usage Guidelines

This command displays the following information about the platform hardware:

  • Platform

  • Serial number

  • BIOS build level

  • BIOS manufacturer

  • Active processors

  • RAID controller status

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show ipsec

This command displays information about IPsec policies and associations.

Command Syntax

Table 2. Available Commands

Command

Result

show ipsec information policy_group| policy_name

This command displays detailed information about the specified ipsec policy.

show ipsec policy_group

This command displays all the ipsec policy group on the node.

show ipsec policy_namepolicy_group

This command displays the list of ipsec policy names that exist in the specified policy group.

show ipsec status

Syntax Description

Parameters

Description

information

Displays the association details and status for the policy.

status

Displays the status of all IPsec tunnels that are defined in the system.

policy_group

The name of a specific IPsec policy.

Requirements

Command privilege level: 1

Allowed during upgrade: yes

Example

This example displays IPsec policies:

show ipsec policy

show license all

This command displays the details about smart licensing status, entitlements in use, product information, and smart agent version.

show license all

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license status

This command displays the overall smart licensing status along with the failure reasons, if any.

show license status

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license summary

This command displays the overall smart licensing status and license usage.

show license summary

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license tech support

This command displays all information that aids in debugging smart agent.

show license tech support

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license trace

This command dumps the content of smart agent-related logs to the console.

show license trace

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license udi

This command displays the product information or all members in the Unique Device Identifier (UDI) structure that are not NULL.

show license UDI

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show license usage

This command displays the details of entitlements or licenses that are in use.

show license usage

Command Modes

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show logins

This command displays recent logins to the server.

Command Syntax

show logins number

Syntax Description

Parameters

Description

number

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}

Syntax Description

Parameters

Description

ALL

Displays information about all installed memory modules.

module_number

Specifies the memory module to display.

count

(Optional)Displays the number of memory modules on the system.

module

(Optional)Displays detailed information about each memory module.

size

(Optional)Displays the total amount of memory.

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

Table 3. Available Commands

Command

Result

show networkall [detail]

This command shows network information for listening and non-listening sockets.

show networketh0 [detail]

This command shows network information for ethernet 0.

show networkfailover [detail] [page]

This command shows Network Fault Tolerance information.

show networkroute [detail]

This command shows network routing information.

show network status [detail] [listen] [process] [all] [nodns] [search stext]

This command shows active internet connections.

show network ip_conntrack

This command shows ip_conntrack usage information.

show network max_ip_conntrack

This command shows max_ip_conntrack information.

show network dhcp eth0 status

This command shows DHCP status information.

show network cluster

This command lists nodes in the network cluster.

show network ipprefs{all |enabled| public

This command shows the list of ports that have been requested to be opened or translated in the firewall.

show network ntp

show network failover[detail][page]

This command shows Network Fault Tolerance information.

show network ipv6{route| settngs}

This command shows IPv6 network routes and network settings.

Syntax Description

Parameters

Description

eth0

Specifies Ethernet 0.

failover

Specifies Network Fault Tolerance information.

route

Specifies network routing information.

status

Specifies active Internet connections.

ip_conntrack

Specifies ip_conntrack usage information.

max_ip_conntrack

Specifies max_ip_conntrack information.

dhcp eth0 status

Displays DHCP status information.

all

Specifies all basic network information.

options

(Optional)Displays additional information.

detail

(Optional)Displays more detailed additional information.

page

(Optional)Displays information one page at a time.

listen

(Optional)Displays only listening sockets.

process

(Optional)Displays the process ID and name of the program to which each socket belongs.

all

(Optional)Displays both listening and nonlistening sockets.

nodns

(Optional)Displays numerical addresses without any DNS information.

search stext

(Optional)Searches for the stext in the output.

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 status

show network cluster

This command lists nodes in the network cluster.

Command Syntax

show network cluster

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show network ipprefs

This command displays the list of ports that have been requested to be opened or translated in the firewall.

Command Syntax

ipprefs {all| enabled| public}

Syntax Description

Parameters

Description

all

Displays all incoming ports that may be used on the product.

enabled

Displays all incoming ports that are currently opened.

public

Displays all incoming ports that are currently opened for any remote client.

Requirements

Level privilege: 0

Command privilege: 0

Allowed during upgrade: Yes

Example

The following example shows show the network ipprefs command:

admin:show network ipprefs public 
Application IPProtocol PortValue  Type       XlatedPort Status   Description  
----------- ---------- ---------- ---------- ---------- -------- ------------ 
sshd         tcp       22         public     -          enabled  sftp and ssh access 
tomcat       tcp       8443       translated 443        enabled  secure web access 
tomcat       tcp       8080       translated 80         enabled  web access   
clm          udp       8500       public     -          enabled  cluster manager 
clm          tcp       8500       public     -          enabled  cluster manager 
ntpd         udp       123        public     -          enabled  network time sync 
snmpdm       udp       161        public     -          enabled  SNMP         
ccm          tcp       2000       public     -          enabled  SCCP-SIG     
ctftp        udp       6969       translated 69         enabled  TFTP access to CUCM TFTP Server 
ctftp        tcp       6970       public     -          enabled  HTTP access to CUCM TFTP Server
admin:

set network ntp option

This command adds a noquery option to /etc/config file.

Command Syntax

set network ntp option noquery

show open

This command displays open files and ports on the system.

Syntax Description

Table 4. Available Commands

Command

Result

show open files [all] [process processID] [regexp reg_exp]

This command shows open files on the system.

show open ports [all] [regexp reg_exp]

This command shows all open ports on the system.

Syntax Description

Parameters

Description

files

displays open files on the system.

ports

displays open ports on the system.

all

(Optional)Displays all open files or ports.

process

(Optional)Displays open files that belong to the specified process.

processID

(Optional)Specifies a process.

regexp

(Optional)Displays open files or ports that match the specified regular expression.

reg_exp

(Optional)A regular expression.

show packages

This command displays the name and version for installed packages.

Command Syntax

show packages{active| inactive} name [page]

Syntax Description

Parameters

Description

active

Specifies active packages.

inactive

Specifies inactive packages.

name

The package name. To display all active or inactive packages, use the wildcard character (*).

page

(Optional)Displays the output one page at a time.

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show password expiry maximum-age

This command displays the configured password expiration parameters.

Command Syntax

show password expiry maximum-age

show password expiry minimum-age

This command displays the configured password expiration parameters.

Command Syntax

show password expiry minimum-age

show password expiry user maximum-age

This command displays the configured password expiration parameters for a particular OS user.

Command Syntax

show password expiry user maximum-age userid

show password expiry user minimum-age

This command displays the configured password expiration parameters for a particular OS user.

Command Syntax

show password expiry user minimum-age userid

show password history

This command displays the number of passwords that are maintained in the history for OS admin accounts.

Command Syntax

show password history

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show password inactivity

This command displays the status of the password inactivity for OS accounts.

Password inactivity is the number of days of inactivity after a password has expired before the account is disabled.

Command Syntax

show password inactivity

Example

show password inactivity
Password Inactivity: Enabled and is currently set to 10
		  days
		
		

Requirements

Command privilege level: 0

Allowed during upgrade: Yes

show process

This command displays information about processes running on the system.

Syntax

Command

Result

show processlist [file filename] [detail]

This command displays a list of all the processes and critical information about each process and visually indicates the child-parent relationships between the processes.

show processload [cont] [clear] [noidle] [num number] [thread] [cpu | memory| time] [page]

This command displays the current load on the system.

show process name process [file filename]

This command displays the details of processes that share the same name and indicates their parent-child relationship.

show process open-fd process-id [, process-id2]

This command lists the open file descriptors for a comma-separated list of process IDs.

show process search regexp [file filename]

This command searches for the pattern that the regular expression regexp specifies in the output of the operating system-specific process listing.

show process using-most cpu [number] [file filename]

This command displays a list of the most CPU-intensive processes.

show process using-most memory [number] [file filename]

This command displays a list of the most memory-intensive processes.

show process pid pid[file filename]

This command displays a list of PIDs.

show process user username [file filename]

This command retrieves details of processes that share the user name and displays parent-child relationship.

show process using most

This command lists the most intensive processes.

Syntax Description

Parameters

Description

list

displays a list of all the processes and critical information about each process, and visually indicates the child-parent relationships between the processes.

load

displays the current load on the system.

name

displays the details of processes that share the same name and indicates their parent-child relationship.

open-fd

lists the open file descriptors for a comma-separated list of process IDs.

search

searches for the pattern specified by the regular expression regexp in the output of the operating system-specific process listing.

using-most cpu

displays a list of the most CPU-intensive processes.

using-most memory

displays a list of the most memory-intensive processes.

filefilename

(Optional)Outputs the results to the file specified by the filename.

detail

(Optional)Displays the detailed output.

cont

(Optional)Repeats the command continuously.

clear

(Optional)Clears the screen before displaying output.

noidle

(Optional)Ignores the idle/zombie processes.

num number

(Optional)Displays the number of processes specified by number. The default number of processes is 10. Set number to all to display all processes.

thread

(Optional)Displays threads.

[cpu | memory | time]

(Optional)Sorts output by CPU usage, memory usage, or time usage. The default is to sort by CPU usage.

page

(Optional)Displays the output in pages.

process

(Optional)Specifies the name of a process.

process-id

(Optional)Specifies the process ID number of a process.

regexp

(Optional)A regular expression.

number

(Optional)The number of processes to display. The default is 5.

pid

Specifies the process ID number of a process.

username

Specifies the username.

show session maxlimit

This command shows the upper limit for concurrent SSH sessions.

Command Syntax

show session maxlimit

Command Mode

Administrator (admin:)

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show 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 I/O statistics.

Command Syntax

show stats io [kilo] [detail] [page] [file filename]

Syntax Description

Parameters

Description

kilo

Displays statistics in kilobytes.

detail

Displays detailed statistics on every available device on the system and overrides the kilo option.

page

Displays one page at a time.

file filename

Outputs the information to a file.

Useage Guidelines

The file option saves the information to
platform/cli/filename.txt.
The filename cannot contain the "." character.

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:

  • Host name

  • Date

  • Time zone

  • Locale

  • Product version

  • Platform version

  • CPU usage

  • Memory and disk usage

Requirements

Command privilege level: 0

show tech all

This command displays the combined output of all show tech commands.

Command Syntax

show tech all [page] [file filename]

Syntax Description

Parameters

Description

page

Displays one page at a time.

filefilename

Outputs the information to a file.

Useage 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 database

This command creates a CSV file of the entire database.

Command Syntax

show tech database {dump| sessions}

Syntax Description

Parameters

Description

dump

Creates a CSV file of the entire database.

sessions

Redirects the session and SQL information of the present session IDs to a file.

Requirements

Command privilege level: 1

Allowed during upgrade: Yes

show tech database dump

This command creates a CSV file of the entire database.

Command Syntax

show tech database dump

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 network

This command displays network aspects of the server.

Command Syntax

Command

Result

show tech network

show tech network [page] [file filename]

This command displays network tech information for a page.

show tech network all [page] [search text] [file filename]

This command displays all network tech information.

show tech network hosts [page] [search text] [file filename]

This command displays information about hosts configuration.

show tech network interfaces [page] [search text] [file filename]

This command displays information about the network interfaces.

show tech network resolv [page] [search text] [file filename]

This command displays information about hostname resolution.

show tech network routes [page] [search text] [file filename]

This command displays information about network routes.

show tech network sockets {numeric}

This command displays the list of open sockets.

Syntax Description

Parameters

Description

all

displays all network technical information.

hosts

displays information about hosts configuration.

interfaces

displays information about the network interfaces.

resolv

displays information about hostname resolution.

routes

displays information about network routes.

sockets

displays the list of open sockets.

page

(Optional)Displays one page at a time.

search text

(Optional)Searches the output for the string specified by text. The search is not case sensitive.

file filename

(Optional)Outputs the information to a file.

numeric

(Optional)Displays the numerical addresses of the ports instead of determining symbolic hosts. It is equivalent to running the Linux netstat [-n] shell command.

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 prefs

This command displays all preferences files for Emergency Responder and its database.

Usage Guidelines

This information is written to a file, which can be viewed subsequently using the file view CLI.

Command Syntax

show tech prefs

show tech runtime

This command displays server runtime.

Command Syntax

show tech runtime {all | cpu| disk| env| memory} [page] [file filename]

Syntax Description

Parameters

Description

all

Displays all runtime information.

cpu

Displays CPU usage information at the time the command is run.

disk

Displays system disk usage information.

env

Displays environment variables.

memory

Displays memory usage information.

page

Displays one page at a time.

file filename

Outputs the information to a file.

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 systables

This command displays the name of all tables in the sysmaster database.

Command Syntax

show tech systables

Requirements

Command privilege level: 1