Начальная проверка нормальной работы сервера Cisco Unified Communications Manager
Я занимаюсь поиском и устранением неисправностей на серверах IP телефонии компании Cisco уже несколько лет в роли TAC инженера. В статье ниже приведен небольшой перечень команд для серверов на базе Cisco Voice Operation System (VOS). Эти команды позволяют выявить большую часть проблем связанных с платформой. К каждой из команд приведено краткое описание. Жирным шрифтом выделены особо важные элементы вывода
- show status
Это первая команда с которой начинается анализ проблемы. Она отображает имя сервера, его версию, количество часов с последней перезагрузки. Так как Cisco VOS сервера построены на базе Linux Red Hat (RH) полезно знать версию RH, которая в данном случае 6.0. Загрузка процессора выше 60-70%, IOWAIT выше 1-2%, использование любой из партиций более чем на 95% указывают на возможные проблемы с данным сервером.
Host Name : ucm11-1
Date : Mon Feb 13, 2017 22:24:14
Time Zone : Central European Time (Europe/Warsaw)
Product Ver : 11.0.1.20000-2
Unified OS Version : 6.0.0.0-2
Uptime:
22:24:19 up 20 days, 10:34, 1 user, load average: 0.27, 0.16, 0.13
CPU Idle: 94.94% System: 02.78% User: 02.28%
IOWAIT: 00.00% IRQ: 00.00% Soft: 00.00%
Memory Total: 8062356K
Total Free Used
Disk/active 20173692K 7107128K 12860280K (65%)
Disk/inactive 20173692K 7443172K 12524236K (63%)
Disk/logging 70515112K 21109572K 45816884K (69%)
- show tech network hosts
Для того чтобы получить список серверов в кластере в удобном формате я пользуюсь этой командой. Главная цель это понять размер системы: 1 сервер говорит об отсутствии отказоустойчивости, а 8 о том что система обслуживает большое количество пользователей и любые изменения должны быть тщательно обдуманы и согласованы с заказчиком. Также вывод этой команды должен быть одинаков для всех серверов в кластере. Иначе возможны проблемы с репликацией базы данных (БД).
admin:show tech network hosts
#This file was generated by the /etc/hosts cluster manager.
#It is automatically updated as nodes are added, changed, removed from the cluster.
10.48.47.136 ucm11-2.allevich.local ucm11-2
10.48.47.143 ucm11-1.allevich.local ucm11-1
- utils ntp status
Синхронизация c NTP сервером является обязательной для всех устройств в сети. Так как при поиске неисправностей (особенно в сложных сценариях) временные метки помогают при диагностике. Репликация Informix БД не будет стабильно работать при отсутствии синхронизации с NTP. Также я использую эти команду чтобы отобразить дату и время для понимания когда были выполнены команды в сохраненном текстовом файле.
admin:utils ntp status
ntpd (pid 8524) is running…
remote refid st t when poll reach delay offset jitter
*172.18.108.15 .GPS. 1 u 583 1024 377 106.518 0.283 1.045
synchronised to NTP server (172.18.108.15) at stratum 2
time correct to within 131 ms
polling server every 1024 s
Current time in UTC is : Mon Feb 13 21:24:23 UTC 2017
Current time in Europe/Warsaw is : Mon Feb 13 22:24:23 CET 2017
- utils service list
Эта команда необходима для проверки состояния всех сервисов запущенных на данном сервере в кластере. Также это самый простой способ определить Publisher сервер в кластере – первый установленный сервер будет иметь директиву «primary node=true».
admin:utils service list
Requesting service status, please wait…
System SSH [STARTED]
Cluster Manager [STARTED]
Name Service Cache [STARTED]
Entropy Monitoring Daemon [STARTED]
Cisco SCSI Watchdog [STARTED]
Service Manager [STARTED]
HTTPS Configuration Download [STARTED]
Service Manager is running
Getting list of all services
A Cisco DB[STARTED]
A Cisco DB Replicator[STARTED]
Cisco AMC Service[STARTED]
Cisco AXL Web Service[STARTED]
Cisco Audit Event Service[STARTED]
Cisco Bulk Provisioning Service[STARTED]
Cisco CAR DB[STARTED]
Cisco CAR Scheduler[STARTED]
Cisco CAR Web Service[STARTED]
Cisco CDP Agent[STARTED]
Cisco CDR Agent[STARTED]
Cisco CDR Repository Manager[STARTED]
Cisco CTL Provider[STARTED]
Cisco CallManager Admin[STARTED]
Cisco CallManager SNMP Service[STARTED]
Cisco CallManager Serviceability[STARTED]
Cisco CallManager Serviceability RTMT[STARTED]
Cisco Certificate Authority Proxy Function[STARTED]
Cisco Certificate Change Notification[STARTED]
Cisco Certificate Expiry Monitor[STARTED]
Cisco Change Credential Application[STARTED]
Cisco DHCP Monitor Service[STARTED]
Cisco DRF Local[STARTED]
Cisco DRF Master[STARTED]
Cisco Database Layer Monitor[STARTED]
Cisco ELM Client Service[STARTED]
Cisco Extended Functions[STARTED]
Cisco Extension Mobility[STARTED]
Cisco Extension Mobility Application[STARTED]
Cisco IP Manager Assistant[STARTED]
Cisco IP Voice Media Streaming App[STARTED]
Cisco Intercluster Lookup Service[STARTED]
Cisco License Manager[STARTED]
Cisco Log Partition Monitoring Tool[STARTED]
Cisco Prime LM Admin[STARTED]
Cisco Prime LM DB[STARTED]
Cisco Prime LM Server[STARTED]
Cisco RIS Data Collector[STARTED]
Cisco RTMT Reporter Servlet[STARTED]
Cisco SOAP – CDRonDemand Service[STARTED]
Cisco SOAP – CallRecord Service[STARTED]
Cisco Serviceability Reporter[STARTED]
Cisco Syslog Agent[STARTED]
Cisco TAPS Service[STARTED]
Cisco Tomcat Stats Servlet[STARTED]
Cisco Trace Collection Service[STARTED]
Cisco Trace Collection Servlet[STARTED]
Cisco Trust Verification Service[STARTED]
Cisco UXL Web Service[STARTED]
Cisco Unified Mobile Voice Access Service[STARTED]
Cisco User Data Services[STARTED]
Cisco WebDialer Web Service[STARTED]
Host Resources Agent[STARTED]
Platform Administrative Web Service[STARTED]
SNMP Master Agent[STARTED]
SOAP – Diagnostic Portal Database Service[STARTED]
SOAP -Log Collection APIs[STARTED]
SOAP -Performance Monitoring APIs[STARTED]
SOAP -Real-Time Service APIs[STARTED]
System Application Agent[STARTED]
Cisco Dialed Number Analyzer[STOPPED] Service Not Activated
Cisco Dialed Number Analyzer Server[STOPPED] Service Not Activated
Cisco Directory Number Alias Lookup[STOPPED] Service Not Activated
Cisco Directory Number Alias Sync[STOPPED] Service Not Activated
Cisco Location Bandwidth Manager[STOPPED] Service Not Activated
Cisco Prime LM Resource API[STOPPED] Service Not Activated
Cisco Prime LM Resource Legacy API[STOPPED] Service Not Activated
Self Provisioning IVR[STOPPED] Service Not Activated
Primary Node =true
- utils dbreplication runtimestate
Причиной большого количества проблем, особенно трудно воспроизводимых и без какой-либо закономерности, является не правильная работа репликации Informix базы данных. Для того чтобы убедится что с репликацией все в порядке следует обращать внимание на поля выделенные шрифтом – все таблицы должны быть синхронизированы, базовые проверки системы пройдены успешно (статус “Y”), статус каждой ноды должен быть равен двум. Полезной информацией для меня является задержка в миллисекундах между нодами в кластере. Для серверов находящихся в разных дата центрах удаленных друг от друга задержка обычно будет выше 10 мс.
admin:utils dbreplication runtimestate
Server Time: Mon Feb 13 22:24:51 CET 2017
Cluster Replication State: BROADCAST SYNC ended at: 2016-02-25-08-48
Sync Result: SYNC COMPLETED on 692 tables out of 692
Sync Status: All Tables are in sync
Use CLI to see detail: ‘file view activelog cm/trace/dbl/20160225_084649_dbl_repl_output_Broadcast.log’
DB Version: ccm11_0_1_20000_2
Repltimeout set to: 420s
PROCESS option set to: 1
Cluster Detailed View from ucm11-1 (2 Servers):
PING DB/RPC/ REPL. Replication REPLICATION SETUP
SERVER-NAME IP ADDRESS (msec) DbMon? QUEUE Group ID (RTMT) & Details
ucm11-2 10.48.47.136 2.860 Y/Y/Y 0 (g_3) (2) Setup Completed
ucm11-1 10.48.47.143 0.038 Y/Y/Y 0 (g_2) (2) Setup Completed
- run sql SELECT count(*) from enduser
При анализе любой промлемы инженеру Cisco TAC важно знать количество пользователей созданных на данной системе. Это позволяет сделать выводы о ее размере и нужно для предварительной оценки business impact (важности данного сервиса для бизнеса).
admin:run sql SELECT count(*) from enduser
В случае работы с другими серверами на основе VOS зачастую данные о пользователях хранятся в отдельном экземляре Informix БД.
Ниже приведены команды для других серверов (CUIC, Unity Connection).
run sql SELECT count(*) from cuic_data:cuicuser
run cuc dbquery unitydirdb SELECT count(*) FROM tbl_user
- utils core active list
Частью изначальной диагностики является проверка дампов памяти по процессам. Ниже приведен пример дампа Call Manager процесса. Анализом дампов памяти процессов занимаются инженеры Cisco TAC, так для этого необходимы знания программной архитектуры продукта.
admin:utils core active list
Size Date Core File Name
233860 KB 2017-02-02 09:28:40 core.20919.6.ccm.1486023981
- file dump install system-history.log
Данная команда является незаменимой при анализе любой проблемы. Она отображает время и событие произошеднее на данной ноде: перезагрузки, установки компонентов (COP files, locales), успешно и не успешно выполненные бэкапы.
file dump install system-history.log
Product Name – Cisco Unified Communications Manager
Product Version – 11.0.1.20000-2
Kernel Image – 2.6.32-504.12.2.el6.x86_64
05/18/2015 17:49:21 | root: Install 11.0.0.99833-4 Start
05/18/2015 23:28:40 | root: Boot 11.0.0.99833-4 Start
05/19/2015 09:55:13 | root: Install 11.0.0.99833-4 Success
05/19/2015 09:55:17 | root: Boot 11.0.0.99833-4 Start
06/17/2015 17:51:57 | root: Shutdown 11.0.0.99833-4 Start
06/18/2015 12:37:00 | root: Boot 11.0.0.99833-4 Start
08/16/2015 08:18:19 | root: Boot 11.0.0.99833-4 Start
09/09/2015 08:47:37 | root: Boot 11.0.0.99833-4 Start
12/02/2015 16:18:19 | root: Cisco Option Install cm-locale-de_DE-11.0.1.1000-1.cop Start
12/02/2015 16:20:34 | root: Cisco Option Install cm-locale-de_DE-11.0.1.1000-1.cop Success
12/02/2015 16:22:58 | root: Restart 11.0.0.99833-4 Start
12/02/2015 16:23:32 | root: Boot 11.0.0.99833-4 Start
12/02/2015 16:31:51 | root: Restart 11.0.0.99833-4 Start
12/02/2015 16:32:15 | root: Boot 11.0.0.99833-4 Start
12/08/2015 17:33:35 | root: Shutdown 11.0.0.99833-4 Start
12/08/2015 22:47:20 | root: Boot 11.0.0.99833-4 Start
12/28/2015 21:59:19 | root: Upgrade 11.0.1.20000-2 Start
12/28/2015 22:57:54 | root: Upgrade 11.0.1.20000-2 Success
12/28/2015 22:58:22 | root: Switch Version 11.0.0.99833-4 to 11.0.1.20000-2 Start
12/28/2015 23:01:06 | root: Switch Version 11.0.0.99833-4 to 11.0.1.20000-2 Success
12/28/2015 23:01:06 | root: Product Version 11.0.1.20000-2
12/28/2015 23:01:06 | root: Kernel Image 2.6.32-504.12.2.el6.x86_64
12/28/2015 23:01:09 | root: Restart 11.0.1.20000-2 Start
12/28/2015 23:01:10 | root: Restart 11.0.0.99833-4 Start
12/28/2015 23:03:12 | root: Boot 11.0.1.20000-2 Start
01/31/2016 12:54:02 | root: Cisco Option Install dp-ffr.3-1-30.GB.k3.cop Start
01/31/2016 12:55:11 | root: Cisco Option Install dp-ffr.3-1-30.GB.k3.cop Success
02/07/2016 11:09:46 | root: Cisco Option Install cm-locale-ru_RU-11.0.1.1000-1.cop Start
02/07/2016 11:11:41 | root: Cisco Option Install cm-locale-ru_RU-11.0.1.1000-1.cop Success
02/07/2016 11:37:46 | root: Restart 11.0.1.20000-2 Start
02/07/2016 11:38:19 | root: Boot 11.0.1.20000-2 Start
03/30/2016 12:39:11 | root: Restart 11.0.1.20000-2 Start
03/30/2016 12:39:38 | root: Boot 11.0.1.20000-2 Start
04/16/2016 13:21:04 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
04/16/2016 13:23:37 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
04/28/2016 13:59:03 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
04/28/2016 14:03:06 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
05/03/2016 11:03:46 | root: Shutdown 11.0.1.20000-2 Start
05/03/2016 11:08:43 | root: Boot 11.0.1.20000-2 Start
05/14/2016 20:10:29 | root: Restart 11.0.1.20000-2 Start
05/14/2016 20:10:57 | root: Boot 11.0.1.20000-2 Start
01/17/2017 12:44:09 | root: Restart 11.0.1.20000-2 Start
01/17/2017 12:44:59 | root: Boot 11.0.1.20000-2 Start
01/22/2017 01:00:05 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
01/22/2017 01:07:36 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
01/24/2017 11:49:36 | root: Restart 11.0.1.20000-2 Start
01/24/2017 11:50:14 | root: Boot 11.0.1.20000-2 Start
01/29/2017 01:00:11 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
01/29/2017 01:21:57 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
02/05/2017 01:00:05 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
02/05/2017 01:10:58 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
02/12/2017 01:00:05 | root: DRS Backup UCMVersion:11.0.1.20000-2 Start
02/12/2017 01:12:51 | root: DRS Backup UCMVersion:11.0.1.20000-2 Success
Если данные полученные с помощью этих команд не указывают на первопричину проблемы – они значительно улучшают представление инженера о текущем состоянии системы, ее версии, адресах, сервисах.
P.S. Я исключил из данного списка команду приведенную ниже, из-за длительного ожидания ее вывода. Из опыта зачастую у заказчиков не правильно настроены reverse записи DNS сервера и в таком случае эта команда будет выполнятся на 300 секунд дольше.
utils diagnose test
Спасибо большое за статью! Воспользовался, вроде бы всё хорошо работает)
Подписаться Отслеживать новости Категории Контакты- Отслеживать новости
Отдельные лица, публикующие информацию на этом сайте, включая модераторов, работают на компанию Cisco Systems. Тем не менее, изложенные здесь мнения и комментарии – это частная точка зрения отдельных авторов, а не компании Cisco. Содержание сайта публикуется только в информационных целях и целях обмена информацией и ни в коем случае не отражает ни позицию компании Cisco, ни позицию любой другой стороны. Данный сайт является открытым и доступным широкой общественности, поэтому на нем не должна публиковаться конфиденциальная информация. Размещая здесь свои публикации, вы тем самым признаете, что несете единоличную ответственность за всю опубликованную вами информацию, ссылки и любые другие данные, загруженные на этот сайт, и освобождаете компанию Cisco от любой ответственности, связанной с вашим пользованием данным сайтом. Вы также предоставляете компании Cisco глобальные, бессрочные, безотзывные и не требующие выплат роялти или уже полностью оплаченные, передаваемые (включая права на сублицензию) права на использование авторских и моральных прав и придание гласности в отношении любой публикуемой вами информации. Комментарии проходят через модераторов и появляются сразу после одобрения ими.