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

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

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

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

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

Список литературы

• 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 BroadWorksSystem Capacity Planner (электронная таблица)
• Руководство по определению параметров платформы Cisco BroadWorks
• Руководство по системной инженерии Cisco Broadworks
• Требования к поддержке аутентификации CI. Версия документа 1.0 MR-7136

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

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

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

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

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

Обсуждение проблемы на более высоком уровне

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

Процедура

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

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

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

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

Проверьте данные пользователя в службе поддержки.

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

Процедура.

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

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

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

Процедура.

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

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

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

Процедура.

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

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

   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 | Сообщить о проблеме.
• Попросите пользователей мобильных приложений присылать журналы событий, после чего вы сможете получить к ним доступ через Partner Hub или Help Desk.
  Отправка журналов происходит в фоном режиме. Однако, если пользователь отправляет обратную связь, она поступает в команду разработчиков приложения Webex. Не забудьте записать номер отзыва пользователя, если вы хотите получить ответ от Cisco. Например:

  

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

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

Процедура.

1. На клиентской стороне нажмите Справка > Проверка состояния здоровья.
2. Выберите Сброс базы данных. Это приводит к полной перезагрузке клиента и загрузке экрана входа в приложение 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. Щелкните по организации и отметьте пункт «Поведение при звонках » . Должно быть указано «Вызов через Webex».

Проанализируйте PSLog на предмет проблем с предоставлением прав доступа пользователям.

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

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

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

Процедура.

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

     Не обращайте внимания на строфу services : создается 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.

В коте 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 Web Token (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 в службу аутентификации (настроенную на интерфейсе обратной связи). Например: 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 (циклическое)

• A StatusCode=200 обратно к Xsi

• А также ответ на проверку токена, содержащий блок JSON "token" в теле ответа.

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

В XsiActionsLog:

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

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

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

Проблемы с партнерским центром

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

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

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

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

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

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

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

2. Интегрированная ИМ & Ошибки P для конкретных пользователей

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

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

3. Сбои при предоставлении доступа пользователям в ответ на запрос от моста предоставления доступа.

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

200 (OK)

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

400 (Неудачный запрос)

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

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

403 (Доступ запрещен)

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

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

409 (Конфликт)

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

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

Получите электронную почту подписчика из POST-запроса HTTP и найдите его через службу технической поддержки. Вы можете не увидеть пользователя если у вас нет прав, но также вы можете проверить присутствие пользователя в «свободной» организации, например «Consumer» (Потребитель). Вы можете попросить этого пользователя удалить его бесплатную учетную запись, либо для его обеспечения можно использовать другой адрес электронной почты. См. 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-регистр в AS (SBC может выполнить поиск в NS для определения AS, если SBC еще не знает SIP-пользователя).

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

В интерфейсе Webex появится пиктограмма «Параметры вызова».

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

3. У клиента отсутствует значок вызова.

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

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

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

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

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 App.

7. Клиентское приложение на компьютере отключает телефонные услуги после успешного подключения через единый вход (SSO).

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

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

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

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

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

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

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

Как это определить?

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

Код ответа: 400

handlePushCallInfoFailure:BWC:INTERNAL: Нажми кнопку вызова: Статус xsi для callID: <callID> Код ошибки XSI: 101002

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

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

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

На сервере ADP или XSP, где развернут Push, выполните команду LocateUser для затронутого пользователя:

curl 'http://:80/servlet/LocateUser?url=&returnCompatibleXSP=true&callPRequest=true'

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

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

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

Пример: migrateUserToDefaultNode.pl bwas1

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

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

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

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

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

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

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

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

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

1. Самостоятельное лечение button/link не отображается в приложении Webex

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

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

2. Пустая страница или ошибка после нажатия кнопки «Самопомощь». button/link

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

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

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

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

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

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

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

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

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