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

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

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

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

Полезные файлы журналов

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

• Портал знаний для партнеров 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
• Миграция подключения (Android) на метод процедуры Firebase
• Описание хранилища токенов устройства Cisco BroadWorks для функции push-уведомлений, выпуск 22.0
• Планировщик производительности системы Cisco BroadWorks (электронная таблица)
• Руководство по измерению платформы Cisco BroadWorks
• Руководство по проектированию системы Cisco Broadworks
• Документ с требованиями к поддержке аутентификации CI версии 1.0 MR-7136

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

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

Соединитель Serviceability

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

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

Эскалация проблемы

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

Процедура

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

Информация о клиенте для сбора

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

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

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

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

Процедура

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

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

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

Процедура

1. Войдите в службу технической поддержки.
2. Найдите и щелкните название организации клиента.
3. Прокрутите страницу вниз, пока не увидите Customer Portal View и щелкните View CustomerName для просмотра информации о клиентской организации с правом только на чтение, включая пользователей и конфигурацию.

Извлечение журналов пользователя из Partner Hub

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

Процедура

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

   Вариант работы через Partner Hub:

   1. Войдите в Partner Hub и найдите клиентскую организацию пользователя.
   2. Выбрать Troubleshooting.
   3. Выбрать Logs.
   4. Выполните поиск пользователя (по электронной почте).
   5. Просмотрите и скачайте журналы клиента в архиве ZIP.

   Вариант работы через службу технической поддержки:

   1. Зайдите в службу технической поддержки.
   2. Найдите организацию.
   3. Выберите организацию (откроется экран сводки).
   4. Прокрутите страницу вниз, чтобы щелкнуть View customer.
   5. Выбрать Troubleshooting.
   6. Выбрать Logs.
   7. Выполните поиск пользователя (по электронной почте).
   8. Просмотрите и скачайте журналы клиента в архиве ZIP.

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

Процедура

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

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

Процедура

1. Войдите в клиент Webex.
2. Проверьте, присутствует ли на боковой панели пиктограмма параметров вызова (телефонная трубка с шестеренкой над ней). Если пиктограмма не присутствует, возможно, у пользователя еще не включена служба вызовов в Control Hub.
3. Откройте Settings/Preferences и перейдите в меню Phone Services . Должно отображаться состояние SSO Session You're signed in. (Если отображается другая телефонная связь, например Webex Calling, пользователь не использует Webex для Cisco BroadWorks.)

   Эта проверка означает, что:

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

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

• См. раздел «Ресурсы», чтобы найти определенные журналы клиентов в клиентах Webex для настольных компьютеров, либо попросите пользователей отправить журналы. Подробная информация в статье ниже. Приложение Webex | Сообщить о проблеме.
• Попросите пользователей мобильных клиентов отправить журналы, чтобы получить их через Partner Hub или службу технической поддержки.
  Отправка журналов происходит в фоном режиме. Однако, если пользователь отправляет обратную связь, она поступает в команду разработчиков приложения Webex. Не забудьте записать номер отзыва пользователя, если вы хотите получить ответ от Cisco. Например:

  

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

Журналы клиентов Webex тщательно редактируются для удаления персональных данных. Вы должны экспортировать данные среды вызовов от клиента в том же сеансе, в котором вы выявили проблему.

Процедура

1. В клиенте щелкните Help > Health Checker.
2. Выбрать Reset Database. Будет выполнен полный сброс клиента и загружен экран входа в приложение Webex.

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

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

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

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

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

   

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

   

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

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

1. Войдите в службу технической поддержки с помощью учетных данных администратора партнера.
2. Найдите организацию.
3. Щелкните организацию и проверьте Calling Behavior записи. Должно быть указано «Вызов через Webex».

Анализ PSLog для проблем с обеспечением пользователей

Используйте PSLog сервера приложений, чтобы увидеть POST-запрос HTTP на мост обеспечения и ответ от Webex. В правильном рабочем случае ответ: 200 ОК и через несколько минут вы сможете увидеть, как пользователь (а также новую клиентскую организацию, если он является первым пользователем) был создан в Webex. Это можно проверить путем поиска в службе технической поддержки адреса электронной почты, который указа в POST-запросе.

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

Получите PSLog от сервера приложений во время попытки непрерывного обеспечения тестового пользователя.

Процедура

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

     Игнорирование services stanza: она создается AS и принимается, но не используется Webex.

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

В этом потоке описывается режим аутентификации BroadWorks. Режим аутентификации можно увидеть в шаблоне BroadWorks в Partner Hub. См. раздел Настройка шаблонов клиентов в 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 Proxy передает запрос на получения профиля в интерфейс Xsi в XSP.

В tomcat access_log:

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

  GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

В XsiActionsLog:

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

  GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile Заголовки включают authorization: Basic и user-agent: broadworksTeamsClient

• Затем XSP осуществляет аутентификацию OCI-P Basic по BroadWorks (AuthenticationVerifyRequest и AuthenticationVerifyResponse, как и любое другое приложение, которое осуществляет базовую аутентификацию посредством Xsi), а также UserGetRequest и ServiceProviderGetRequest для сбора информации о подписчике.
• Ответ Xsi на Webex содержит блок XML Profile , содержащий (BroadWorks) userId и другие сведения (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 на схеме). Служба AuthService устанавливает доверительную связь с Webex на основе соединения mTLS, поэтому она может выдать LLT.
• Найдите ответ (5.4 на схеме) от LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … и StatusCode=200 , что можно связать с исходным запросом с помощью trackingid: CLIENT… заголовка.

В XsiActionsLog:

• Клиент может представить долгосрочный токен в интерфейсе Xsi-Actions для получения профиля устройства (6 на схеме). Например: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device С помощью заголовков authorization: Bearer token и user-agent: WebexTeams (variant/version)
• Интерфейс Xsi-Actions POST устанавливает токен для authservice (настроен в интерфейсе петли). Например: 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 (циклическое)

• О StatusCode=200 отправляется Xsi

• И ответ проверки токена, имеющий "token" Блок JSON в теле.

• Корреляция с использованием trackingid: CLIENT…

В XsiActionsLog:

• Получив 200 OK от службы authservice, которая проверяет маркер клиента, приложение Xsi-Actions теперь отправляет запрос OCI-P для UserPrimaryAndSCADeviceGetListRequest
• Получает ответ OCI-P UserPrimaryAndSCADeviceGetListResponse , содержащий accessDeviceTable XML-структуру.
• Ответ OCI-P закодирован в качестве ответа Xsi клиенту, включая структуру XML AccessDevices , которая содержит типы устройств deviceTypes. Например: Business Communicator – PC и URL-адреса, по которым клиент может получить файлы конфигурации устройства.

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

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

Проблемы с Partner Hub

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

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

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

1. Ошибки интегрированных служб обмена мгновенными сообщениями и состоянием доступности для определенных предприятий/клиентов

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

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

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

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

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

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

3. Ошибки обеспечения пользователя в ответ от моста обеспечения

Если пользователи не отображаются в Control Hub, в течение нескольких минут после назначения интегрированных служб обмена мгновенными сообщениями и состоянием доступности просмотрите коды ответов службы моста обеспечения. Запустите PSLog, чтобы посмотреть коды ответов HTTP.

200 ОК

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

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

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

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

403 Запрещено

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

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

409 Конфликт

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

4. Пользователь уже присутствует в CI

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

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

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

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

2. Сбой системы единого входа

• В BroadWorks проверьте, назначены ли пользователю типы устройств для приложения Webex (см. раздел Профили устройств в разделе Подготовка среды руководства по решению).
• Убедитесь, что пользователь использует правильный пароль. Если шаблон, который вы использовали для подготовки клиентской организации пользователя (в Partner Hub), настроен для аутентификации BroadWorks, пользователь должен ввести свой пароль "Веб-доступ" BroadWorks. Пользователю также может потребоваться ввести свой идентификатор пользователя 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 (например, Settings > Phone Services в Windows, Preferences > Phone Services на Mac) сообщение "Сеанс SSO: Вы выполнили регистрацию» означает, что приложение успешно зарегистрировано (в данном случае на BroadWorks).

3. В клиенте отсутствует пиктограмма вызовов

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

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

4. Тестирование нескольких служб вызовов с одинаковыми клиентами

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

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

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

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

  XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

  allowUserApp = false

  allowClientApp = true

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

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

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

7. Настольный клиент отключает телефонную связь после успешного соединения SSO

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

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

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

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

9. Входящие мобильные вызовы поступают один раз или не могут быть приняты

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

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

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

Код ответа: 400

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

closePushCallWithReason:BWC:INTERNAL: Попробуйте закрыть push-вызов с идентификатором = <callID>, причина = CallAbandoned

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

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

На сервере ADP или XSP, где развернут push, запустите LocateUser для затронутого пользователя.

curl 'http://<FQDN or IP address of NS Server>:80/servlet/LocateUser?url=<BW userID@domain>&returnCompatibleXSP=true&callPRequest=true'

Пример. curl 'http://1.1.1.1:80/servlet/LocateUser?url=9721112222@gmail.com&returnCompatibleXSP=true&callPRequest=true'

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

Войдите на сервер NS с помощью SSH, перейдите к /usr/local/broadworks/bw_base/bin и выполните следующие действия:migrateUserToDefaultNode.pl <hostingNE>

Пример. migrateUserToDefaultNode.pl bwas1

Чтобы получить hostingNE значение, выполните: NS_CLI/System/Device/HostingNE> get

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

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

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

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

Дополнительную информацию см. в перечисленных ниже документах.

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

• Описание функции усовершенствований ASR Cisco BroadWorks

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

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

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

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

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

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

Проблемы с заявкой на домен

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

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

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

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

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

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

К синхронизации каталогов применяются перечисленные ниже коды ошибок.