Голосовая связь и система унифицированных коммуникаций : Cisco Unified Communications Manager (CallManager)

Поиск и устранение проблем с запуском подсистемы JTAPI

5 апреля 2016 - Машинный перевод
Другие версии: PDF-версия:pdf | Отзыв


Содержание


Введение

Java Telephony API (JTAPI) подсистема является очень важным компонентом Cisco Customer Response Application (CRA) платформа. JTAPI является компонентом, который связывается с Сisco CallManager и ответственен за управление вызовами телефонии. На платформе CRA содержатся приложения телефонии, например Cisco AutoAttendant, Cisco IP ICD и Cisco IP-IVR. Этот документ не является определенным ни для одного из этих приложений; подсистема JTAPI - базовый компоненты, используемый всеми приложениями.

Прежде чем вы запустите процесс устранения проблем, гарантируете, что версии программного обеспечения, которые вы используете, совместимы. Обратитесь к примечаниям Релиза Cisco CallManager для версии Сisco CallManager, который вы используете для подтверждения совместимости.

Введите http://servername/appadmin, где servername является названием сервера, на котором CRA установлен для входа в систему к Странице AppAdmin для проверки версии CRA. Текущая версия указана в правом нижнем углу главного меню.

Предварительные условия

Требования

В данном документе предполагается, что попытка настройки сервера CRA была выполнена ранее. Новая установка CRA без любых сведений о конфигурации имеет все подсистемы в состоянии OUT_OF_SERVICE. Этот документ не предназначен для описания установки или конфигурации компонентов платформы CRA.

Используемые компоненты

Сведения, содержащиеся в этом документе, касаются следующих версий программного обеспечения:

  • Cisco CallManager версии 3.1(3a)spC

  • Версия 2.2 (3a) Customer Response Application

Сведения, представленные в этом документе, были получены от устройств, работающих в специальной лабораторной среде. Все устройства, описанные в этом документе, были запущены с чистой (стандартной) конфигурацией. В рабочей сети необходимо изучить потенциальное воздействие всех команд до их использования.

Условные обозначения

Дополнительные сведения об условных обозначениях см. в документе Условные обозначения технических терминов Cisco.

Терминология

Эти термины использованы всюду по этому документу:

  • Пользователь JTAPI — пользователь, который определен в разделе конфигурации JTAPI Страницы AppAdmin

  • Пользователь RM — пользователь, который определен в разделе конфигурации Менеджера ресурсов Страницы AppAdmin

  • Порт CTI — устройство, которое создано на Сisco CallManager. Порт CTI используется платформой CRA для организации очереди приглашений воспроизведения и вызовов. Один порт CTI используется для каждого абонента, который связан с сервером CRA.

  • Точка маршрута CTI — устройство, которое создано на Сisco CallManager. Одна точка маршрута CTI создана для каждого приложения телефонии, которое используется сервером CRA.

  • Пользователь Сisco CallManager — пользователь, который был создан на Сisco CallManager.

  • Страница AppAdmin — веб-страница, которая используется для настройки сервера CRA: http://servername/appadmin.

  • Сервер CRA — сервер, который размещает приложение CRA. CRA также известен как Приложения, eServices, Модуль рабочего процесса.

Начало работы

Для устренения этой проблемы необходимо сначала разрешить некоторые трассировки на сервере CRA.

Включение отслеживания

Выполните эти шаги, чтобы позволить отследить:

  1. От Страницы AppAdmin выберите Engine> Trace Configuration.

  2. Установите флажки SS_TEL в колонках Debugging (Отладка) и Alarm (Сигнал тревоги).

  3. Выберите Update.

    Для просмотра файлов трассировки выберите ссылку Файлов трассировки на левой части страницы, затем выберите соответствующий файл трассировки.

Подсистема JTAPI OUT_OF_SERVICE

При устренении этой проблемы необходимо сначала найти исключение в файле трассировки. Существует несколько других ключевых слов, которые можно использовать для обнаружения исключения в файле трассировки. Поиск этих ключевых слов. Перечислены самые общие причины сбоев.

Как найти исключение в файле трассировки

Выполните эти шаги для обнаружения исключения в файле трассировки:

  1. На основной странице Engine следует остановить и снова запустить механизм Application Engine.

  2. Открыть последний трассировочный файл.

  3. Поиск этих ключевых слов в файле трассировки:

MIVR-SS-TEL-4-ModuleRunTimeFailure или MIVR-GENERIC-4-EXCEPTION

Ищите строку "MIVR-SS_TEL-1-ModuleRunTimeFailure" в файле отслеживания. В конце линии задана причина исключения. Это наиболее распространенные причины.

Неспособный создать поставщика - плохой вход в систему или пароль

Причина

Указано неверное имя пользователя или пароль для конфигурации JTAPI.

Разрешение

Проверьте правильность имени пользователя и пароля. Попытайтесь войти в страницу CCMuser (http://servername/ccmuser) на Сisco CallManager, чтобы гарантировать, что Сisco CallManager в состоянии подтвердить подлинность правильно.

Полный текст сообщения об ошибках

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI
Subsystem,Failure Cause=7,Failure
Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- bad login or password.
%MIVR-SS_TEL-7-
EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- bad login or password.

Неспособный создать поставщика - Соединение отказалось

Причина

Подключению JTAPI к Сisco CallManager отказывает Сisco CallManager.

Разрешение

  • Удостоверьтесь, что можно успешно войти к CCMUser на Сisco CallManager с названием пользователя JTAPI и паролем.

  • Проверьте, что сервис Диспетчера CTI выполняется в Центре управления Сisco CallManager.

Полный текст сообщения об ошибках

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl: Unable
to create provider -- Connection refused
%MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- Connection refused

Неспособный создать поставщика - входят =

Причина

Ничто не настроено на странице конфигурации JTAPI.

Разрешение

Настройте поставщика JTAPI на странице конфигурации JTAPI сервера CRA.

Полный текст сообщения об ошибках

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- login=
%MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- login=

или

MIVR-GENERIC-4-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl: 
Unable to create provider-- login=_1: login=_1

Неспособный создать поставщика - имя хоста

Причина

Ядро CRA не в состоянии решить имя хоста Сisco CallManager.

Разрешение

Проверьте, что Разрешение DNS работает правильно от ядра CRA. Попытайтесь использовать IP-адрес вместо имени DNS.

Полный текст сообщения об ошибках

%M%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- dgrant-mcs7835.cisco.com
%MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- dgrant-mcs7835.cisco.com

Неспособный создать поставщика - Операция испытала таймаут

Причина

Ядро CRA не имеет возможности подключения с помощью IP-адреса с Сisco CallManager.

Разрешение

Проверьте IP-адрес, настроенный для поставщика JTAPI на сервере CRA. Проверьте конфигурацию шлюза по умолчанию на сервере CRA и Сisco CallManager. Удостоверьтесь, что нет никаких IP проблем маршрутизации. Пропингуйте Сisco CallManager от сервера CRA для тестирования подключения.

Полный текст сообщения об ошибках

101: Mar 24 11:37:42.153 PST
%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- Operation timed out
102: Mar 24 11:37:42.168 PST %MIVR-SS_TEL-7-EXCEPTION:
com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- Operation timed out

Неспособный создать поставщика - пустой указатель

Причина

Когда клиент JTAPI не использует правильную версию, нет никакого IP-адреса поставщика услуг JTAPI или имени хоста, настроенного, или.

Разрешение

Убедитесь, что имя или IP-адрес хоста настроены в конфигурации JTAPI. Если версия JTAPI является неправильной, загрузите клиента JTAPI от страницы Cisco CallManager Plugins и установите ее на сервере CRA.

Полный текст сообщения об ошибках

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
Exception=com.cisco.jtapi.PlatformExceptionImpl:
Unable to create provider -- null

MIVR-SS_TEL-1-ModuleRunTimeFailure

Ищите строку "MIVR-SS_TEL-1-ModuleRunTimeFailure" в файле отслеживания. Когда Подсистема JTAPI неспособна инициализировать любые порты, это исключение обычно происходит.

Причина

Сервер CRA может связаться с Сisco CallManager, но неспособен инициализировать любые порты CTI или точки маршрута CTI через JTAPI. Ошибка возникает в случае, когда порты CTI и точки маршрута CTI не привязаны к пользователю JTAPI.

Разрешение

Проверьте пользователя JTAPI на Сisco CallManager и проверьте, что порты CTI и точки маршрута CTI, которые настроены на сервере CRA, привязаны к пользователю.

Полный текст сообщения об ошибках

255: Mar 23 10:05:35.271 PST %MIVR-SS_TEL-1-ModuleRunTimeFailure:
Real-time failure in JTAPI subsystem: Module=JTAPI Subsystem,
Failure Cause=7,Failure Module=JTAPI_SS,Exception=null

MIVR-SS_TEL-7-UNK

Причина

Это сообщение об ошибках указывает на отказавшую установку кодека.

Разрешение

  1. Проверьте реестр в HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems,Inc.\CRS\Properties\application.MIVR.properties.com.cisco.dialog.codec = G711ULAW64K, G711ALAW64K

  2. Если это не там, то добавьте кодек G711 как в предыдущем примере.

  3. Перезапустите сервис Node Manager CRS от Пуска> Программы> Средства администрирования.

Примечание: Если Подсистема JTAPI не поступает в эксплуатацию после того, как эти шаги выполнены, CRS должен быть деинсталлирован и повторно установлен.

Полный текст сообщения об ошибках

JTAPI-JTAPI-7-UNK:[XXX_1393]CiscoRegistrationExceptionImpl
caught: At least one media capability must be specified

Подсистема JTAPI в режиме PARTIAL_SERVICE

При устренении этой проблемы необходимо сначала найти исключение в файле трассировки. Существует несколько других ключевых слов, которые можно использовать для обнаружения исключения в файле трассировки. Поиск этих ключевых слов. Перечислены самые общие причины сбоев.

Поиск ключевых слов

Выполните эти шаги для поиска ключевых слов:

  1. На основной странице Engine следует остановить и снова запустить механизм Application Engine.

  2. Открыть последний трассировочный файл.

  3. Ищите ключевые слова, перечисленные в файле трассировки:

MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT

Причина

Подсистема JTAPI неспособна инициализировать один или несколько портов CTI или точки маршрута.

Разрешение

Сообщение об ошибках в следе говорит вам, какой порт CTI или точка маршрута были неспособны инициализироваться. Проверьте, что это устройство существует в Конфигурации Cisco CallManager и также привязано к пользователю JTAPI на Сisco CallManager.

Полный текст сообщения об ошибках

1683: Mar 24 11:27:51.716 PST
%MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT:
Unable to register CTI Port: CTI Port=4503,
Exception=com.cisco.jtapi.InvalidArgumentExceptionImpl:
Address 4503 is not in provider's domain.
1684: Mar 24 11:27:51.716 PST %MIVR-SS_TEL-7-EXCEPTION:
com.cisco.jtapi.InvalidArgumentExceptionImpl:
Address 4503 is not in provider's domain.

MIVR-SS_TEL-2-SS_PARTIAL_SERVICE

Причина

Когда существует проблема с портами CTI, эта проблема может произойти.

Разрешение

Не привяжите и повторно привяжите все устройства от пользователя JTAPI. Затем перезапустите Модуль CRS и Cisco CallManager server.

Полный текст сообщения об ошибках

%MIVR-SS_TEL-2-SS_PARTIAL_SERVICE:JTAPI subsystem in partial service: 
Failure reason=A number of route points are OOS - TR[num=8490], TR[num=8550],TR[num=8566]

Связанные обсуждения сообщества поддержки Cisco

В рамках сообщества поддержки Cisco можно задавать и отвечать на вопросы, обмениваться рекомендациями и совместно работать со своими коллегами.


Дополнительные сведения