Благодарим вас за обратную связь.

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

Эта статья разделена на три основных раздела:

• Ресурсы — содержит список инструментов, материалов для чтения, журналов и контактов, которые могут вам понадобиться.
• Процессы — описывает некоторые действия, которые можно предпринять при устранении проблем, возникших у клиента.
• Конкретные проблемы — классифицирует и перечисляет известные проблемы, способы их выявления и возможные способы их решения.

Полезные лог-файлы

Список для чтения

• Webex для портала знаний партнеров Cisco BroadWorks
• Руководство по настройке платформы XSP (R23)
• Руководство по управлению программным обеспечением BroadWorks (R23)
• Руководство по настройке управления устройствами Cisco BroadWorks (R23)
• Руководство по администрированию интерфейса командной строки Broadworks Xsp
• Описание функции долгоживущих токенов аутентификации, версия 23.0
• Руководство по интеграции аутентификации SAML, R23
• Руководство по вариантам поддержки SSL Cisco BroadWorks
• Описание функции поддержки Cisco CI
• Сервер push-уведомлений (описание функции)
• Поддержка push-уведомлений для звонков Описание функции Релиз 22.0
• Метод процедуры перехода Connect (Android) на Firebase
• Хранилище токенов устройств Cisco BroadWorks для push-уведомлений Описание функции, версия 22.0
• Планировщик емкости системы Cisco BroadWorks (электронная таблица)
• Руководство по определению размеров платформы Cisco BroadWorks
• Руководство по проектированию систем Cisco Broadworks
• Документ о требованиях к поддержке аутентификации CI, версия 1.0 MR-7136

Известные проблемы и ограничения

В статье «Известные проблемы и ограничения» содержится актуальная информация об известных проблемах, выявленных в решении Webex для BroadWorks.

Разъем, удобный для обслуживания

Служба Webex Serviceability ускоряет диагностику проблем в инфраструктуре сотрудниками технической поддержки Cisco. Он автоматизирует задачи по поиску, извлечению и хранению диагностических журналов и информации в случае SR. Служба также запускает анализ диагностических сигнатур, чтобы TAC могла более эффективно выявлять и устранять проблемы с вашим локальным оборудованием.

Подробнее о развертывании соединителя Serviceability Connector см. в руководстве по развертыванию Serviceability Connector Cisco Webex.

Обострение проблемы

Выполнив некоторые рекомендации по устранению неполадок, вы должны иметь четкое представление о том, в чем причина проблемы.

Процедура

1. Соберите как можно больше информации из систем, связанных с проблемой.
2. Обратитесь в соответствующую команду Cisco, чтобы открыть дело.

Какую информацию о клиентах собирать

Если вы считаете, что вам нужно открыть дело или обострить проблему, соберите следующую информацию при устранении неполадок вместе с пользователем:

• Идентификатор пользователя: адрес электронной почты CI или UUID пользователя (это идентификатор Webex, но если вы также получили идентификатор BroadWorks пользователя, включите его в описание дела).
• Идентификатор организации.
• Приблизительный период времени, в течение которого возникла проблема.
• Клиентская платформа и версия.
• Отправляйте или собирайте журналы клиента.
• Запишите идентификатор отслеживания, если он указан на клиенте.

Проверьте сведения о пользователе в справочной службе

Администраторы-партнеры, обладающие привилегиями роли администратора службы поддержки (базовая или расширенная), могут использовать эту процедуру для проверки сведений о пользователе в режиме «Служба поддержки».

Процедура

1. Войдите в службу поддержки.
2. Найдите пользователя, а затем нажмите на него. Откроется экран сводной информации о пользователе.
3. Нажмите на имя пользователя, чтобы увидеть подробную конфигурацию пользователя. Полезная информация в этом представлении включает UUID пользователя, кластер общей идентификации (CI), кластер приложений Webex, поведение при звонках, GUID учетной записи BroadWorks
4. Нажмите «Копировать», если вам нужно использовать эту информацию в другом инструменте, или прикрепите ее к кейсу Cisco.

Просмотр организации клиентов в справочной службе

Администраторы-партнеры, обладающие привилегиями роли администратора службы поддержки (базовая или расширенная), могут использовать эту процедуру для просмотра сведений об организации клиентов в режиме просмотра службы поддержки.

Процедура

1. Войдите в службу поддержки.
2. Найдите название организации-клиента, а затем нажмите на него.
3. Прокрутите страницу вниз, пока не появится окно «Просмотр клиентского портала», а затем нажмите « Просмотреть имя клиента», чтобы увидеть список пользователей и конфигурацию, доступный только для чтения .

Получайте журналы пользователей из Partner Hub

При устранении неполадок, связанных с настольными и мобильными клиентами, важно, чтобы партнеры (и TAC) могли просматривать журналы клиентов.

Процедура

1. Попросите пользователя отправить журналы. Справку см. в разделе: Приложение Webex | Сообщить о проблеме.
2. Попросите пользователя экспортировать среду вызовов и отправить вам файл ced.dat .
3. Получите журналы клиентов в Центре партнеров или в справочной службе.

   Опция «Центр партнеров»:

   1. Войдите в Partner Hub и найдите организацию клиентов пользователя.
   2. Выберите Устранение неполадок.
   3. Выберите «Журналы».
   4. Найдите пользователя (по электронной почте).
   5. Просмотрите и загрузите журналы клиента в виде zip-файла.

   Опция службы поддержки:

   1. Войдите в службу поддержки.
   2. Найдите организацию.
   3. Выберите организацию (откроется экран сводки).
   4. Прокрутите вниз и нажмите Показать клиента.
   5. Выберите Устранение неполадок.
   6. Выберите «Журналы».
   7. Найдите пользователя (по электронной почте).
   8. Просмотрите и загрузите журналы клиента в виде zip-файла.

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

Процедура

1. Поделитесь этой ссылкой с пользователем: https://help.webex.com/njpf8r5
2. Попросите пользователя отправить вам номер версии.

Чек клиента на услугу «Звонок»

Процедура

1. Войдите в клиент Webex.
2. Убедитесь, что значок «Параметры вызова» (телефон с шестеренкой над ним) присутствует на боковой панели. Если значок отсутствует, возможно, пользователь еще не подключен к службе звонков в Control Hub.
3. Откройте меню «Настройки/Настройки» и перейдите в раздел «Телефонные услуги». Вы должны увидеть статус Сеанс SSO, в который вы вошли. (Если отображается другая телефонная служба, напримерWebex Calling, означает, что пользователь не использует Webex для Cisco BroadWorks.)

   Эта проверка означает следующее:

   • Клиент успешно обработал необходимые микросервисы Webex.
   • Пользователь успешно прошел аутентификацию.
   • Ваша система BroadWorks выдает клиенту долгоживущий веб-токен JSON.
   • Клиент получил профиль своего устройства и зарегистрировался в BroadWorks.

Получайте журналы клиентов или отзывы

• См. раздел Ресурсы, чтобы найти журналы конкретных клиентов в настольных клиентах Webex или попросить пользователей отправить журналы. Справку см. в разделе: Приложение Webex | Сообщить о проблеме.
• Попросите пользователей мобильных клиентов отправить журналы, а затем вы сможете получить их через Центр партнеров или службу поддержки.
  Отправлять журналы можно в автоматическом режиме. Однако если пользователь отправляет отзыв, он передается команде разработчиков Webex App. Обязательно запишите номер отзыва пользователя, если хотите связаться с Cisco. Например:

  

Получите данные о среде вызовов

Журналы клиентов Webex сильно отредактированы, чтобы удалить личную информацию. Данные среды вызова следует экспортировать из клиента в тот же сеанс, когда вы заметили проблему.

Процедура

1. На клиенте выберите «Справка» > « Проверка работоспособности».
2. Выберите «Сбросить базу данных». Это вызовет полный сброс клиента и загрузку экрана входа в приложение Webex.

Убедитесь, что Webex следует зарегистрироваться в BroadWorks

Приложение Webex проверяет следующую информацию, чтобы определить, следует ли регистрироваться в BroadWorks:

• Право пользователя на использование Broadworks-connector.
• Поведение при звонках как для организации, так и для пользователя.

Проверьте поведение пользователя при звонках и права подключения

1. Войдите в службу поддержки, используя учетные данные администратора партнера.
2. Найдите пользователя.
3. Нажмите на пользователя и проверьте запись «Поведение при звонках». Это должно быть «Звонки в Webex».

   

4. Нажмите на имя пользователя, чтобы открыть экран «Сведения о пользователе».
5. Прокрутите вниз, чтобы найти раздел «Права», и убедитесь, что Broadworks-connector включен

   

   Если пользователь Webex для Cisco BroadWorks намеревается использовать Webex для Cisco BroadWorks, он не должен иметь права по стандарту bc-sp-standard. Это право на «Webex Calling(Broadcloud)», то есть звонки в приложении Webex через облачную службу вызовов, управляемую Cisco.

Проверьте поведение организации при звонках

1. Войдите в службу поддержки, используя учетные данные администратора партнера.
2. Найдите организацию.
3. Нажмите на организацию и проверьте запись «Поведение при звонках». Это должно быть «Звонки в Webex».

Проанализируйте PSlog на предмет проблем с подготовкой пользователей

Используйте PSlog сервера приложений, чтобы увидеть запрос HTTP POST на мост подготовки и ответ Webex. В правильном рабочем случае ответ — 200 «ОК», и через несколько минут вы увидите, что пользователь и новая организация клиентов, если это первый пользователь, были созданы в Webex. В этом можно убедиться, выполнив поиск в службе поддержки по адресу электронной почты, указанному в POST.

Прежде чем начать

Соберите журнал PSlog с сервера приложений во время попытки сквозного выделения ресурсов с помощью тестового пользователя.

Процедура

1. Сначала проверьте код ответа HTTP:
   • Все значения, отличные от 200 OK, являются ошибкой при инициализации пользователя.
   • 200 OK все равно может указывать на сбой, если что-то в профиле подписчика не работает в службах Webex, расположенных выше моста подготовки.
   • В ответе 400 может содержаться узел сообщения. Мост инициализации не смог обработать что-то в профиле подписчика. Возможно, что-то не так со сведениями о подписчике или несовместимо с настройками в шаблоне.
   • 401 означает, что учетные данные для обеспечения, введенные в AS, не совпадают с учетными данными, введенными в шаблоне в Partner Hub.
   • 403 может означать, что на сервере приложений что-то неправильно сконфигурировано. Проверьте цель запроса. Это должен быть не IP-адрес, а URL-адрес моста инициализации, указанный в шаблоне в Partner Hub.
   • 409 указывает на конфликт между предоставленным профилем подписчика и существующими данными Webex. Возможно, уже существует пользователь с таким адресом электронной почты. Проверьте сообщение в ответе.
2. Вы также можете проверить исходный HTTP-запрос POST на наличие подозрительных значений, которые могут привести к сбою инициализации. POST содержит XML-структуру профиля подписчика. Здесь можно проверить следующие полезные узлы:
   • bwuserid: используйте его, чтобы найти профиль подписчика, если вам нужно отредактировать его в BroadWorks.
   • группа: если шаблон находится в «режиме поставщика услуг», он вводится в нижнем регистре и становится названием организации клиентов, которую вы видите в Partner Hub.
   • ServiceProvider: если шаблон находится в «Корпоративном режиме», он вводится в нижнем регистре и становится названием организации клиентов, которую вы видите в Partner Hub.
   • Основной номер телефона: должен существовать. Без него инициализация не удаётся.
   • электронная почта: становится идентификатором пользователя в Webex. Должен быть действительным и уникальным для Webex, иначе инициализация завершится неудачно.

     Не обращайте внимания на строфу об услугах: она создана AS и принята, но не используется Webex.

Анализируйте журналы XSP для устранения неполадок при входе подписчиков

В этом потоке описывается режим аутентификации BroadWorks. Режим аутентификации можно посмотреть в шаблоне BroadWorks в Центре партнеров. См. раздел Настройка шаблонов клиентов на сайте https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

На следующей лестничной диаграмме показано взаимодействие между пользователем, клиентом, сервисами Webex и системой BroadWorks, когда пользователь выполняет аутентификацию BroadWorks в приложении Webex. Кроме того, соединение между Webex и XSP защищено протоколом MTLS.

В следующем обсуждении объясняется, на что следует обратить внимание при изучении журналов на предмет успешного входа в систему.

Пользователь взаимодействует с клиентом, клиент взаимодействует с сервисами Webex:

• Пользователь предоставляет свой адрес электронной почты приложению Webex (1 на диаграмме).
• CI знает, как перенаправить пользователя на ввод пароля BroadWorks (через UAP) (2 на диаграмме).
• Прокси-сервер IDP отправляет запрос на получение профиля в интерфейс Xsi на XSP.

В журнале доступа tomcat:

• Найдите запрос GET для профиля подписчика: от Webex до интерфейса Xsi-Actions (диаграмма 2.1). В нем указан идентификатор пользователя Webex. Например:

  ПОЛУЧИТЕ /com.broadsoft.xsi-actions/v2.0/user/ webexuserid@example.com /профиль

В журнале действий XSI:

• Найдите GET-запрос профиля от Webex (диаграмма 2.1). В нем указан идентификатор пользователя Webex. Например:

  GET /com.broadsoft.xsi-actions/v2.0/user/ webexuserid@example.com /profile В заголовки входят авторизация: базовая версия и пользовательский агент: BroadworkSteamsclient

• Затем XSP выполняет базовую аутентификацию OCI-P против BroadWorks (AuthenticationVerifyRequest и AuthenticationVerifyResponse, как и любое другое приложение, выполняющее базовую аутентификацию с помощью Xsi), а также UserGetRequest и ServiceProviderGetRequest для сбора информации о подписчиках.
• Ответ Xsi на Webex содержит блок профиля XML, содержащий идентификатор пользователя (BroadWorks) и другие сведения (2,2 на диаграмме).

Взаимодействие клиента и сервисов Webex:

• Прокси-сервер IDP сопоставляет профиль пользователя, полученный от BroadWorks, и передает клиенту утверждение SAML (диаграмма 2.3).
• Клиент обменивает утверждение SAML на токен CI (3 на диаграмме).
• Клиент проверяет, имеет ли зарегистрированный пользователь права на подключение к сети Broadworks-connector (4 на диаграмме). Права пользователей можно проверить в справочной службе.
• Клиент использует токен CI для запроса веб-токена JSON (JWT) у прокси-сервера IDP (диаграмма 5).
• Прокси-сервер IDP проверяет токен CI в CI.
• Прокси-сервер IDP запрашивает JWT у службы аутентификации.

В журнале службы аутентификации:

• Найдите запрос токена от Webex (на диаграмме 5.2), например: GET /AuthService/token с заголовком http_bw_userid и другие.
• XSP выполняет запрос OCI-P UserGetLoginInfoRequest, чтобы убедиться, что предоставленный идентификатор пользователя соответствует пользователю BroadWorks (на диаграмме 5.3). Благодаря соединению MTLS компания AuthService установила доверительные отношения с Webex, поэтому может выдать ошибку LLT.
• Найдите ответ (диаграмма 5,4) от LonglivedTokenManager: токен сгенерирован, тема: bwksUserId@example.com, эмитент: BroadWorks... и StatusCode=200, который можно связать с исходным запросом с помощью заголовка trackingid: CLIENT...

В журнале действий XSI:

• Клиент может представить долгоживущий токен в интерфейсе Xsi-Actions, чтобы получить профиль своего устройства (на диаграмме 6). Например: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserID %40example.com/profile/device С авторизацией заголовков: токен владельца и пользовательский агент: WebExTeams (вариант/версия)
• Интерфейс Xsi-Actions отправляет токен в службу аутентификации (настроенную для работы в интерфейсе обратной связи) Например: 127.0.0. 1:80 POST http://127.0.0.1:80/authService/token, который можно соотнести с заголовком trackingid: CLIENT... в GET и заголовком X-BROADSOFT-CORRELATION-ID: CLIENT... в POST.

В журнале службы аутентификации:

• Получение POST от Xsi (обратная связь)

• Код состояния = 200 назад в Xsi

• И ответ на проверку токена, содержащий JSON-блок «token» в теле.

• Коррелируется с использованием идентификатора отслеживания: CLIENT...

В журнале действий XSI:

• Получив 200 одобрений от службы аутентификации, которая проверила токен клиента, приложение Xsi-Actions теперь отправляет запрос OCI-P для запроса UserPrimary и запроса SCADeviceGetListRequest
• Получает основной пользователь OCI-P и ответ SCADeviceGetList, содержащий XML-структуру таблицы Access DeviceTable.
• Ответ OCI-P закодирован как ответ Xsi клиенту, включая XML-структуру AccessDevices, содержащую типы устройств. Например: Business Communicator — компьютер и URL-адреса, по которым клиент может получить файлы конфигурации устройства.

Клиент продолжает работать в обычном режиме:

• Выбирает запись об устройстве и взаимодействует с DMS для получения профиля устройства (6 на диаграмме).
• Регистрируется в BroadWorks через SBC, полученный в конфигурации из DMS (7 на диаграмме).

Проблемы в Центре партнеров

1. Администратор не может видеть организации клиентов

Являясь администратором партнерской организации в Webex, вы должны иметь роль полного администратора. Эта роль используется для управления партнерской организацией, включая предоставление административных привилегий вам и другим пользователям. Чтобы управлять организациями клиентов, вам необходимо предоставить себе (или другим людям) роль полного администратора продаж или роль администратора продаж. Подробнее см. в разделе Назначение ролей учетных записей организации в Control Hub.

Проблемы с подготовкой пользователей

1. Интегрированные ошибки IM&P для конкретных предприятий/клиентов

Если несколько предприятий используют разные облачные сервисы для совместной работы, например UC-One SaaS и Webex для Cisco BroadWorks, возможно, вы решили модифицировать адаптер выделения ресурсов для каждого предприятия.

Чтобы проверить, что настроено для Integrated IM&P (по умолчанию для предприятий, если не существует более конкретных настроек), запустите AS_CLI/interface/Messaging> get. Чтобы узнать параметры выделения ресурсов для конкретного предприятия, откройте предприятие и перейдите в раздел Службы > Интегрированный обмен мгновенными сообщениями и сообщениями.

Убедитесь, что интегрированная конфигурация IM&P для этого предприятия точно соответствует конфигурации, указанной в шаблоне клиента в Partner Hub. Следующие настройки должны совпадать, иначе выделение ресурсов не будет выполнено для всех пользователей предприятия:

2. Встроенные ошибки IM&P для определенных пользователей

Это применимо, если вы используете сквозное выделение ресурсов и предполагаете, что выделение ресурсов работает для некоторых или большинства пользователей (поэтому вы можете исключить проблемы с конфигурацией). Если вы видите встроенные ошибки IM&P в BroadWorks, например «[Ошибка 18215] Ошибка инициализации на сервере обмена сообщениями» и «[Ошибка 18211] Ошибка связи с сервером обмена сообщениями», вам следует изучить следующие возможные причины:

• Возможно, адрес электронной почты пользователя уже существует CI. Найдите пользователя в справочной службе, чтобы проверить, есть ли уже его адрес электронной почты. Это не обязательно окончательный вариант, поскольку пользователь может существовать в организации, чьи данные вам запрещено просматривать в службе поддержки.
• Пользователь самостоятельно зарегистрировался в Webex, прежде чем ему был назначен интегрированный сервис IM&P. В этом случае один из вариантов — попросить пользователя удалить свои бесплатные учетные записи, чтобы стать частью создаваемой вами организации клиентов. Инструкции можно найти на сайте https://help.webex.com/5m4i4y
• Профиль пользователя не привязан к основному телефонному номеру (все подписчики Webex для Cisco BroadWorks должны иметь основной DID). См. раздел, посвященный анализу PSlog от AS.

3. Сбои при инициализации пользователей в ответ на использование Provisioning Bridge

Если пользователи не появляются в Control Hub, через несколько минут после назначения Integrated IM&P ознакомьтесь с кодами ответов, предоставленными службой Provisioning Bridge. Запустите PSlog, чтобы посмотреть коды ответа HTTP.

200 OK

Ответ 200 OK не означает, что пользователь успешно подготовлен. Это означает, что служба подготовки получила запрос и успешно отправила соответствующий запрос на создание пользователя вышестоящим службам. Транзакция выделения ресурсов спроектирована в асинхронном режиме. Служба отвечает 200 «ОК», так как процесс создания пользователя может занять несколько минут, а по соображениям производительности мы не хотим получать несколько запросов на создание одного и того же пользователя. Однако если пользователь в итоге не появится в организации клиентов после ответа 200 «ОК», это может означать, что в сервисах Webex, предшествующих службе подготовки, не удалось создать пользователя. Необходимо обострить сбой при инициализации, на который был получен ответ 200 «ОК».

400 Неверный запрос

Проверьте HTTP-ответ, в котором должна содержаться более подробная информация о потенциальных проблемах, которые могут вызвать этот ответ со стороны службы подготовки. Несколько примеров узла:

• «Невозможно доверять электронной почте BroadWorks устаревшему API инициализации». Адрес электронной почты, связанный с неудачным запросом пользователя на предоставление ресурсов, недействителен или введен с ошибкой, но в шаблоне вы указали, что этим адресам электронной почты можно доверять. Проверьте профили пользователей в BroadWorks, в частности идентификатор электронной почты.
• Организация клиентов не найдена в базе данных, а также флаг создания новой организации не включен». Этот неудачный запрос на предоставление ресурсов должен создать новую организацию клиентов в Webex, но ваш шаблон настроен таким образом, чтобы не создавать новые организации клиентов. Если вы хотите разрешить новым организациям использовать домены электронной почты, не соответствующие существующим клиентам в Webex, можно перенастроить шаблон в Partner Hub и повторно протестировать запрос на выделение ресурсов. Однако если вы не ожидаете создания новой организации для этого пользователя, возможно, в адресе электронной почты введена ошибка (в частности, доменная часть). Проверьте идентификатор электронной почты пользователя в BroadWorks.

403 Запрещено

Запрос на выделение ресурсов не может быть выполнен до тех пор, пока вы не исправите конфигурацию. В этом случае вам необходимо изучить запрос и ответить на него. Например, если вы видите IP-адрес в качестве целевого адреса запроса на выделение ресурсов, а не URL-адрес, соответствующий вашей организации (см. разделы по настройке брандмауэра в руководстве по решению), это может означать, что на вашем сервере приложений отсутствует необходимый патч (ap373197).

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

409 Конфлик

Запрос на подготовку не может быть выполнен, поскольку в Webex уже есть пользователь, адрес электронной почты которого совпадает с указанным в запросе адресом электронной почты.

4. Пользователь уже в CI

Извлеките адрес электронной почты подписчика из запроса HTTP POST и найдите его в службе поддержки. Вы можете не увидеть пользователя, если вам не разрешено, но вы также можете увидеть, что пользователь состоит в «бесплатной» организации, например «Потребитель». Вы можете попросить этого пользователя удалить бесплатную учетную запись или указать другой адрес электронной почты. См. https://help.webex.com/ndta402.

Проблемы при входе пользователя

1. Портал активации пользователей не загружается

Обычный процесс входа в Webex для Cisco BroadWorks включает портал активации пользователей, на котором пользователи вводят свои пароли. Иногда этот портал не загружается после того, как пользователь ввел свой адрес электронной почты на экране входа в приложение Webex. Эта проблема может быть вызвана на стороне клиента или службы. На стороне клиента это обычно вызвано тем, что собственный браузер клиента каким-то образом несовместим со службой.

2. Сбой при едином входе

• В BroadWorks убедитесь, что пользователю назначены типы устройств для приложения Webex (см. раздел «Профили устройств» в разделе «Подготовка среды» руководства по решению).
• Убедитесь, что пользователь использует правильный пароль. Если шаблон, который вы использовали для предоставления организации клиентов пользователя (в Partner Hub), настроен для аутентификации BroadWorks, пользователю следует ввести свой пароль BroadWorks «Web Access». Пользователю также может потребоваться ввести свой идентификатор пользователя BroadWorks, если его адрес электронной почты не настроен в качестве альтернативного идентификатора пользователя. Убедитесь, что пользователь правильно ввел символы верхнего и нижнего регистров.

Проблемы с настройкой и регистрацией вызовов

После того как пользователь был подготовлен к работе в Webex и успешно вошел в приложение Webex, приложение зарегистрируется в BroadWorks. Ниже приведена ожидаемая последовательность регистрации и полученные в результате признаки успешной регистрации (на примере приложения Webex):

1. Ожидаемая последовательность регистрации

1. Клиент вызывает XSI, чтобы получить токен управления устройством и URL-адрес DMS.
2. Клиент запрашивает профиль своего устройства в DMS, представив токен на этапе 1.
3. Клиент считывает профиль устройства и получает учетные данные, адреса и порты SIP.
4. Клиент отправляет SIP REGISTER в SBC, используя информацию из шага 3.
5. SBC отправляет SIP REGISTER в AS (SBC может выполнить поиск в NS, чтобы найти AS, если SBC еще не знает пользователя SIP).

2. Ожидаемые признаки успешной регистрации клиентов

В интерфейсе Webex появляется значок Опции вызова.

На вкладке Телефонные сервисы приложения Webex (например, Настройки > Телефонные службы в Windows, Настройки > Телефонные службы на Mac) сообщение «Сеанс SSO: вы вошли в систему» означает, что приложение успешно зарегистрировано (в данном случае в BroadWorks).

3. У клиента нет значка «Звонок»

В большинстве случаев это означает, что у пользователя нет подходящих лицензий/прав.

Регистрация не удалась. Существует несколько причин, по которым клиент Webex App не может зарегистрироваться в BroadWorks:

4. Несколько сервисов вызовов тестируются на одних и тех же клиентах

Эта известная проблема может быть вызвана тем, что клиент переключается между разными бэкендами обработки вызовов. Скорее всего, это произойдет во время пробных версий различных служб вызова, предлагаемых через (одни и те же) клиенты Webex App. Для устранения этой проблемы можно сбросить базу данных клиентов (ссылку).

5. Неправильная настройка службы аутентификации

Проверьте XSP (ы), на которых размещен сервис аутентификации, с руководством по решению (см. раздел Настройка сервисов на вашем Webex для Cisco BroadWorks XSP). В частности:

• Ключи RSA (созданные на одном XSP) копируются на все XSP
• URL-адрес службы аутентификации был предоставлен веб-контейнеру на всех XSP и правильно введен в кластер в Partner Hub
• Внешняя аутентификация с помощью сертификатов настроена:

  xsp_cli/Система/Коммуникационная утилита /Настройки по умолчанию /Внешняя аутентификация/Аутентификация сертификатов > Получить

  allowUserApp = false

  allowClientApp = true

• При использовании MTLS необходимо загрузить сертификат клиента Webex в XSP (сертификат можно получить в Центре партнеров на странице настроек BroadWorks).

6. Неправильная конфигурация тегов BroadWorks

Убедитесь, что вы настроили необходимые теги BroadWorks для приложения Webex. Сведения о тегах конфигурации см. в руководстве по настройке Webex для Cisco BroadWorks. Убедитесь в отсутствии конфликтов или неправильных значений. В частности, тег %SBC_ADDRESS_WXT% должен служить сигналом доступа к регистратору SIP для клиентов Webex App.

7. Клиент для настольных ПК отключает телефонные услуги после успешного подключения SSO

Эта проблема может быть вызвана тем, что один и тот же пользователь входит в несколько клиентов на платформе одного и того же типа. Например, если пользователь успешно вошел в приложение Webex в Windows, а затем вошел в приложение Webex на другом компьютере под управлением Windows, сеанс единого входа будет только на одном из компьютеров. Это сделано намеренно. Если вам абсолютно необходимо обойти эту проблему, можно настроить BroadWorks на несколько экземпляров одного и того же типа устройств, но они должны иметь уникальные SIP-адреса. Эта конфигурация выходит за рамки Webex для Cisco BroadWorks.

8. Настольное устройство не предназначено для пользователя

Эта подпись отображается в журнале клиента:

[0x70000476b000] Broadworks ConfigDownloader.cp:106 <Error>

OnAccess Devicelist выполнен успешно: BWC:SCF: ConfigDownload — профиль устройства «Business Communicator — PC» не найден.

9. Входящие мобильные звонки звонят один раз или на них невозможно ответить

Входящие вызовы на Webex Mobile звонят только один раз, иначе пользователь не сможет ответить на входящий вызов. Другие конечные точки того же пользователя могут продолжать звонить.

Как идентифицировать себя?

В журналах мобильного клиента Webex найдите код ошибки XSI 101002 в потоке push-вызовов. Например:

Код ответа: 400

<callID>Ошибка HandlePushCallInfo: BWC: внутренний: Push-вызов: статус xsi для идентификатора вызова: код ошибки xsi: 101002

ClosePushCallWithReason:BWC:Internal: попробуйте закрыть push-вызов, указав id <callID>=, причину = callAbandoned

Причина. Код ошибки 101002 может указывать на то, что в ответе LocateUser возвращен неправильный сервер приложений (AS). Это может произойти, когда пользователь перешел на дополнительную AS.

Рекомендуемые проверки:

В ADP или XSP, где развернут Push, запустите LocateUser для соответствующего пользователя:

<FQDN or IP address of NS Server>закрутите файл http: //:80/servlet/locateUser? URL-адрес = и совместимый с возвратом <BW userID @domain > xsp=true&callprequest=true'

Пример: загон 'http://1.1.1.1:80/servlet/LocateUser? URL-адрес = 9721112222@gmail.com и возвращайте совместимый код xsp=true и callprequest=true'

Решение: если LocateUser возвращает пользователю дополнительную AS, запустите сценарий MigrateUserToDefaultNode.pl на основном сервере NS, чтобы перенести пользователей обратно на основной сервер приложений кластера.

Войдите на сервер NS через SSH, перейдите в каталог /usr/local/broadworks/bw_base/bin и запустите: migrateUserToDefaultNode.pl <hostingNE>

Пример: перенесите пользователя на defaultNode.pl bwas1

Чтобы получить значение HostingNE, выполните команду: ns_cli/system/device/HostingNE> get

Сначала скрипт проверяет, сможет ли он найти NE хостинга, указанный вами в качестве аргумента. Убедившись, что NE хостинга действителен, он обновляет DN, расширение и URL-адрес узла по умолчанию для этого хост-сервера.

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

Сценарий нельзя запустить только для одного пользователя. Он переносит всех пользователей, перечисленных в выходных данных LocateUser. Если вы не можете запустить сценарий, удалите и перестройте затронутого пользователя в BroadWorks, чтобы перестроить пользователя в нужную AS.

Любое сообщение SIP с пользовательского устройства на дополнительную ОС может привести к миграции пользователя. Обычно пользователи возвращаются к основной AS через установленный по умолчанию 15-минутный интервал, если входящие запросы продолжают поступать во вторичную AS. Например, если SBC не может подключиться к AS1 и рекурсирует во вторичную AS, затронутые пользователи могут перейти на вторичную AS. В зависимости от развертывания одна магистральная группа или пользователь могут остаться привязанными к дополнительной AS, если SBC по-прежнему будет сталкиваться с проблемами при подключении к основной AS.

Дополнительные сведения см. в следующих документах:

• Разделы 3.4.5 Возможность отката пользователей сервера приложений и 5.4.5 Автоматический откат в руководстве по резервированию Cisco BroadWorks

• Описание функций улучшений ASR в Cisco BroadWorks

9. Телефонные услуги отключены

Если телефонные службы отображаются как отключенные после входа пользователя в приложение Webex или телефонные службы отключаются во время использования клиента, проверьте тип клиента и процесс регистрации.

Для клиентов Windows и Mac приложение Webex регистрируется в SIP и сохраняет активную регистрацию SIP во время входа пользователя в систему.

Проверьте следующее:

1. Убедитесь, что файл config-wxt.xml успешно загружен.

В журналах клиента найдите ConfigDownload.

Успешная загрузка показывает следующее:

ConfigDownload — успешно завершено

Если в журналах обнаружена следующая ошибка, проверьте журналы AuthService на наличие ошибок, связанных с токенами:

ConfigDownload — ошибка с кодом ошибки: 1511

2. Убедитесь, что профиль устройства Webex найден.

В журналах клиента убедитесь, что устройство доступа найдено и значение used_value равно 1. Если значение used_value равно 0, проверьте, включена или выключена основная линия, и проверьте значение тега. Дополнительные сведения см. в разделе 6.1.44 Основной профиль руководства по настройке Webex для BroadWorks.

Примеры записей в журнале:

Примеры записей в журнале: ----Sep----:BWC:SCF: ConfigDownload — найдено устройство доступа

:BWC:SCF: загрузка конфигурации — устройство доступа найдено ----сентября ----:BWC:SCF: Загрузка конфигурации — устройство доступа: тип устройства = бизнес-коммуникатор — ПК, уровень устройства = группа, разрешенное прекращение = 1, isDeviceOwner [has_value: 0, used_value: 1], hasownerDevice: 1, тип конечной точки: внешний вид общего вызова

:BWC:SCF: загрузка конфигурации — устройство доступа: тип устройства = бизнес-коммуникатор — ПК, уровень устройства = группа, разрешенное прекращение = 1, владелец устройства [has_value: 0, used_value: 1], устройство владельца: 1, тип конечной точки: внешний вид общего вызова ----сентябрь ----:BWC:SCF: загрузка конфигурации — устройство доступа: тип устройства = подключение — мобильное устройство, устройство elevel=group, allowertermination=1, isDeviceOwner [has_value: 0, used_value: 1], hasownerDevice: 1, тип конечной точки: внешний вид общего вызова

:BWC:SCF: загрузка конфигурации — устройство доступа: тип устройства = подключение — мобильное устройство, уровень устройства = группа, разрешенное прекращение = 1, владелец устройства [has_value: 0, used_value: 1], устройство владельца: 1, тип конечной точки: планшет, уровень устройства — планшет, уровень устройства — планшет, уровень устройства =группа, allowTermination=1, isDeviceOwner [has_value: 0, used_value: 1], hasownerDevice: 1, тип конечной точки: внешний вид общего вызова

3. При определении адреса прокси-сервера SIP проверьте наличие сбоев DNS.

Дополнительные сведения об обнаружении прокси-серверов SIP см. в разделе 6.1.6 Динамическое обнаружение прокси-серверов SIP руководства по настройке Webex для BroadWorks.

Успешное обнаружение прокси-серверов показывает следующее:

Обнаружение прокси-сервера завершено, получены <number>результаты

4. Проверьте, не произошла ли ошибка при регистрации SIP.

Если в журналах указано значение mRegistration: TCPTimeout или причина: SIP; cause=200; text="last=TCP-timeout», клиент Webex не может установить низкоуровневое TCP-соединение с SBC. При возникновении этой ошибки регистрация SIP не завершается. Проверьте, заблокирован ли протокол TCP в сети пользователя или SBC отклоняет TCP-соединение.

Если запрос SIP REGISTER отклонен или не получил ответа, найдите в журналах сообщение REGISTER sip и убедитесь, что возвращено сообщение SIP/2.0 200 OK. Если запрос не получен, проверьте, блокирует ли сеть пользователя протокол SIP или SBC отклоняет запрос.

В BroadWorks Admin перейдите в раздел Пользователь > Утилиты > Регистрации и убедитесь, что для клиента Webex имеется действительная регистрация SIP.

Для мобильных клиентов Android и iOS приложение Webex не регистрируется в SIP до тех пор, пока не поступит или не поступит звонок. По завершении вызова регистрация удаляется. Мобильные клиенты регистрируются для получения push-уведомлений.

Для мобильных клиентов проверьте следующее:

1. Убедитесь, что файл config-wxt.xml успешно загружен и профиль устройства найден, как описано для клиентов Windows и Mac.

2. Убедитесь, что push-регистрация прошла успешно.

В журналах Webex найдите состояние push-регистрации:

Состояние регистрации onPush изменено: :Состояние push-регистрации изменено, состояние = не зарегистрировано

Состояние регистрации OnPush изменено: :Состояние push-регистрации изменено, государство = зарегистрировано

В BroadWorks Admin перейдите в раздел Пользователь > Утилиты > Регистрация push-уведомлений и убедитесь в наличии действительной push-регистрации для клиента Webex.

Проблемы с настройками вызовов и веб-просмотром

1. Кнопка/ссылка «Самообслуживание» не отображаются в приложении Webex

Другой симптом этой проблемы заключается в том, что кнопка/ссылка отображается, но при нажатии на нее открывается внешний браузер.

• Убедитесь, что необходимый шаблон конфигурации клиента развернут и теги CSW правильно установлены. (См. раздел Webview «Настройки вызовов» в руководстве по решению Webex для Cisco BroadWorks).
• Убедитесь, что приложение Webex зарегистрировано для звонков в BroadWorks.
• Убедитесь, что приложение Webex является последней версией, поддерживающей CSWV.

2. Пустая страница или ошибка после нажатия кнопки/ссылки Self Care

Как правило, такое поведение в приложении Webex указывает на проблему с настройкой или развертыванием приложения CSWV в BroadWorks XSP. Соберите сведения для дальнейшего расследования, включая журналы CSWV, журналы доступа, репозиторий config-wxt.xml и файл шаблона, а затем возбудите дело.

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

Ошибки регистрации пользователей могут возникнуть в результате ошибок, допущенных при регистрации доменов. Прежде чем претендовать на какие-либо домены, убедитесь, что вы понимаете следующее:

• Поставщики услуг не должны претендовать на домены организаций-клиентов, которыми они управляют. Они должны претендовать только на домены тех пользователей, которые входят во внутреннюю организацию поставщика услуг. Использование домена пользователей в отдельной организации (даже в той организации, которой управляет поставщик услуг) может привести к ошибкам при регистрации пользователей в организации-заказчике, поскольку запросы на аутентификацию пользователей направляются поставщику услуг, а не организации-заказчику.
• Если две организации-заказчики (компания A и компания B) используют один и тот же домен, а компания A претендует на этот домен, регистрация пользователей компании B может не состояться из-за того, что запросы на аутентификацию пользователей направляются через организацию, на которую заявлен домен (компания A).

  Если вы ошибочно указали какие-либо домены и хотите удалить претензию, обратитесь к статье Webex «Управление доменами».

Коды ошибок конечного пользователя

В следующей таблице приведены коды ошибок конечных пользователей, которые можно увидеть на портале активации клиентских пользователей.

Коды ошибок при синхронизации каталогов

Следующие коды ошибок относятся к синхронизации каталогов.