Useful CLI commands for Cisco CUCM .

I don’t work on the command line of CUCM often, if ever – you may add, but when the need arises here is the short list of commands to keep. A little reminder – the latest (starting version 5 and on) of Cisco CUCM software is Linux (namely Red Hat) based,  which of course includes the terminal access – be it a physical via console or a network one over ssh .
You create a username/password for the terminal during the CUCM  installation.
As Cisco do not want us to mess with the underlying OS, our interaction is limited to a very restricted kind of shell . So you don’t have access to the Linux commands, but you do have a predefined set of CUCM commands of which I present most useful ones here.
I run the examples below on a MCS hardware server so your output may vary.

 

– Changing password for yourself/another user . Know that it is here, but do not play with it risking to lock yourself out of the server.

admin:set password { age* | complexity* | expiry* | inactivity* | user* }

–  Get the disk usage

show diskusage activelog

– Show the status of the fans (irrelevant for VMware based install)

admin:show environment fans
(RPMS)     Lower                     Critical

ID     Current   Threshold Status

Fan Sensor 1 7800     4200      OK
Fan Sensor 2 7950     4200      OK
Fan Sensor 3 7800     4200      OK
Fan Sensor 4 7350     4200      OK
Fan Sensor 5 7200     4200      OK

– Show the server temperature (irrelevant for VMware based install)

show environment temperatures

(Celcius)    Non-Critical   Critical   Threshold    Threshold

     ID       Current  Lower   Upper   Lower   Upper  Location Temperature Sensor
1             
24          53          54           55        62   1

– Show the server hardware (irrelevant for VMware based install)

show hardware

HW Platform    : 7825I4
Processors     : 1
Type           : Intel(R) Core(TM)2 Duo CPU E8400  @ 3.00GHz
CPU Speed      : 3000
Memory         : 2048 MBytes

show logins
administ pts/0     192.168.7.1   Wed Aug 12 09:56   still logged in

– Show physical memory (irrelevant for VMware based install)

show memory modules

Bank  Locator   Size  Active Status
DIMM 1  DIMM 1  1024 MB TRUE OK
DIMM 3  DIMM 3  1024 MB TRUE OK

– Show interface status (more useful for hardware based servers than VMware ones)

show network eth0

Ethernet 0
DHCP      : disabled        Status : up
IP Address   : 192.168.10.1     IP Mask : 255.255.255.000
Link Detected: yes             Mode    : Auto enabled, Full, 100 Mbits/s
Duplicate IP : no
DNS   Not configured.
Gateway   : 192.168.10.254 on Ethernet 0

– Show number of open connections . If there is some network connectivity issue this number will be unusually low as each IP Phone/voice gateway is counted as a connection.
show network ip_conntrack

972

– Show open and accessible over the network ports

show network ipprefs public

Application  IPProtocol   PortValue Type      XlatedPort   Status    Description

———— ———— ———— ———— ———— ———— ————

sshd      tcp       22        public    –         enabled   sftp and ssh access
clm       udp       8500      public    –         enabled   cluster manager
clm       tcp       8500      public    –         enabled   cluster manager
tomcat    tcp       8443      translated   443       enabled   secure web access
tomcat    tcp       8080      translated   80        enabled   web access
ntpd      udp       123       public    –         enabled   network time sync
taps      tcp       9050      public    –         enabled   Cisco TAPS service
soapmonitor  tcp       5007      public    –         enabled   soapmonitor port
dhcpd     udp       67        public    –         enabled   DHCP server port
ccm       tcp       8002      public    –         enabled   CCM SDL Link
ccm       tcp       1720      public    –         enabled   H225 SIGNAL
ccm       tcp       2000      public    –         enabled   SCCP-SIG
ccm       tcp       2001      public    –         enabled   TITAN CONVERT
ccm       tcp       2002      public    –         enabled   VEGA CONVERT
ccm       udp       2427      public    –         enabled   MGCP
ccm       tcp       2428      public    –         enabled   MGCPBH
ccm       tcp       5060      public    –         enabled   SIP Listener Port for TCP
ccm       udp       5060      public    –         enabled   SIP Listener Port for UDP
ALL       tcp       32768:61000  public    –         enabled   generic ephemeral tcp ports
ALL       udp       32768:61000  public    –         enabled   generic ephemeral udp ports
CTIManager   tcp       2748      public    –         enabled   CTIManager QBE TCP
CTIManager   tcp       8003      public    –         enabled   CTI SDL Link
acserver tcp       1101      public    –         enabled   Attendent Console RMI callback
acserver tcp       1102      public    –         enabled   Attendent Console RMI server
acserver tcp       1103:1129 public    –         enabled   Attendent Console RMI traffic
acserver udp       3224      public    –         enabled   Attendent Console Line/Device state
acserver udp       3223      public    –         enabled   Attendent Console Call Control
ctftp     udp       69        public    –         enabled   TFTP access to CUCM TFTP Server
ctftp     tcp       6970      public    –         enabled   HTTP access to CUCM TFTP Server
ipvms     udp       24576:32767  public    –         enabled   IP Voice Media Streaming Driver RTP
ma        tcp       2912      public    –         enabled   IP Manager Assistant
snmpdm    udp       161       public    –         enabled   SNMP

 

Also:

show open ports
 show open ports all
 show open ports regexp

 

– Show list of running processes (Linux style)

show process list

PID ARGS
 PID COMMAND

1 init [3]
2 [migration/0]

 

– General status info, the first command I run to see unusual CPU/IO load , uptime

 show status

Host Name : CUCM
Date      : Wed Aug 12, 2015 10:21:18
Time Zone : Israel Standard Time (Asia/Jerusalem)
Locale    : en_US.UTF-8
Product Ver  : 7.1.5.33900-10
Platform Ver : 2.0.0.1-1
License MAC  : XXXXXXXX
Uptime:
10:21:19 up 139 days, 15:14,  1 user,  load average: 0.30, 0.55, 0.72

CPU Idle:   89.60%  System:   05.45% User:   04.46%
 IOWAIT:   00.50% IRQ:   00.00% Soft:   00.00%   Intr/sec: 1221.00

 

– Show routing table

show tech network routes

——————– show platform network ——————–

Routes:

192.168.10.0/24 dev eth0  proto kernel  scope link  src 192.168.10.1
169.254.0.0/16 dev eth0  scope link
default via 192.168.10.254 dev eth0

 

– Show the firewall status. Being a Red Hat server CUCM includes iptables to work with firewall which is on by default

  utils firewall ipv4 debug
  utils firewall ipv4 disable
  utils firewall ipv4 enable
  utils firewall ipv4 list      –  List all the rules
  utils firewall ipv4 status – see whether the firewall on or off

 

– Show I/O stats

 utils iostat

Executing command… Please be patient
Linux 2.6.9-78.ELsmp (CUCM) 08/13/2015
Time: 10:49:38 AM

avg-cpu:  %user   %nice %sys %iowait   %idle

13.32           0.02     3.02   12.08   71.56

 

– Working with ARP table

  utils network arp delete – delete some ARP entry
  utils network arp list    – list the ARP table
  utils network arp set

 

utils network arp list

Address               HWtype  HWaddress        Flags Mask         Iface
192.168.10.198         ether   E0:5F:B9:XX:XX:XX   C                  eth0
192.168.10.254         ether   44:D3:CA:XX:XX:XX   C                  eth0

 

– The best friend in need – ping, to debug reachability/packet loss/latency issues.

utils network ping ?
Syntax:
ping dest [count VALUE] [size VALUE]
dest mandatory   dotted IP or host name
count   optional count value (default is 4)
size optional size of ping packet in bytes (default is 56)

 

admin:utils network ping 8.8.8.8 count 10 size 1300

PING 8.8.8.8 (8.8.8.8) 1300(1328) bytes of data.
1308 bytes from 8.8.8.8: icmp_seq=0 ttl=50 time=58.2 ms
1308 bytes from 8.8.8.8: icmp_seq=1 ttl=50 time=57.8 ms

 

– Close friend of ping – traceroute

admin:utils network traceroute 8.8.8.8

1  192.168.10.254 (192.168.10.254)  0.336 ms  0.296 ms  0.331 ms

< cut for clarity> …

 

– And the best for the ending – restarting specific service or the whole CUCM. Usually
when things go rough and it is not possible to access GUI – be it weird CPU overload or web service stuck, I do restart to the whole CUCM with

utils system {restart | shutdown | switch-version}

Again, more relevant for hardware based MCS – in VMware you can just reboot the virtual machine hosting CUCM.

– Stop/start specific service, but be aware the services list is limited to:

admin:utils service stop

Invalid service name for start/stop, valid names are:
  System SSH
  Cluster Manager
  Service Manager
  A Cisco DB
  Cisco Tomcat
  Cisco Database Layer Monitor
  Cisco CallManager Serviceability

 

utils service
utils service auto-restart
  utils service list
  utils service restart
  utils service start
  utils service stop