在此文章中
dropdown icon
疑難排解資源
    有用的記錄檔
    閱讀清單
    已知問題和限制
    可服務性連接器
dropdown icon
故障排除流程
    升級問題
    收集哪些客戶信息
    查看服務台中的使用者詳細資料
    在服務台中檢視客戶組織
    從合作夥伴中心擷取使用者記錄檔
    如何找到用戶端版本
    客戶檢查來電服務
    取得用戶端記錄或意見反饋
    取得通話環境資料
    驗證 Webex 應該註冊至廣播公司
    分析 PSLog 以查找使用者佈建問題
    分析 XSP 記錄以疑難排解訂戶登入
dropdown icon
特定問題疑難排解
    合作夥伴中心問題
    使用者佈建問題
    使用者登入問題
    呼叫組態和註冊問題
    通話設定網頁檢視問題
    網域索償問題
    一般使用者錯誤代碼
    目錄同步的錯誤代碼
變更歷史記錄
適用於思科廣域工廠的 Webex 疑難排解指南
list-menu在此文章中
list-menu意見回饋?

使用記錄分析、支援工作流程、疑難排解指南和錯誤代碼參考來診斷和解決 Webex 適用於 Cisco BroadWorks 客戶的問題。

本文適用於支援自己和客戶的服務供應商組織的技術支援團隊。 他們應該熟悉一般故障排除、讀取記錄檔以及處理訂戶案例。

本文分為三個主要部分:

  • 資源-提供您可能需要的工具、閱讀材料、記錄檔和聯絡人清單。
  • 程序-描述您在解決客戶問題時可以採取的一些動作。
  • 特定問題-分類並列出已知發生的問題,以及如何發現問題,以及如何可能解決問題。

疑難排解資源

有用的記錄檔

日誌名稱

來源

對故障排除有用

日誌記錄

應用程式伺服器

流程佈建

貓訪問日誌

XSP

Webex 應用程式登入

XSIA 動作日誌

XSP

Webex 應用程式登入與 Webex IDP Proxy 互動,用戶端互動,用於設備設定檔查詢

驗證服務日誌

XSP

Webex 應用程序登錄(令牌驗證和發行)

XSLOG

應用程式伺服器

推送通知的移動訂閱

通話訊號

Webex 應用程式啟動記錄

視窗: \ 用戶\ {用戶名}\ 應用程序數據\ 本機\ CiscoSpark\ current_log.txt

Mac:/用戶/{用戶名} /圖書館/記錄/SparkMac 桌面/當前 _ 日誌

行動裝置:使用傳送記錄

啟動 (順序) 使用者的權利檢查

BWC 程式庫初始化,用於連線至廣播公司

獲取用戶個人資料和 JWT 令牌獲取日誌

布羅德維克斯通話

Webex 應用程式記錄

用戶端

視窗: \ 用戶\ {用戶名}\ 應用程序數據\ 本機\ CiscoSpark\ current_log.txt

Mac:/用戶/{用戶名} /圖書館/記錄/SparkMac 桌面/當前 _ 日誌

行動裝置:使用傳送記錄

所有用於註冊和通話的 SIP 流量

保持到 BWKS 後端的流量活動

需要信號(保持/恢復,轉移等)的中通話功能 。

媒體 (Webex 媒體引擎) 記錄

用戶端

視窗:\ 用戶\ {用戶名}\ 應用程序數據\ 本機\ CiscoSpark\ 媒體\ *.log

Mac:/用戶/{用戶名} /圖書館/記錄/SparkMac 桌面/媒體/

行動裝置:使用傳送記錄

所有媒體記錄

協商通話的編解碼器

中通話功能

閱讀清單

已知問題和限制

「已知問題和限制」 文章包含有關我們在 Webex for BroadWorks 解決方案中識別的已知問題的最新資訊。

可服務性連接器

Webex 可服務性服務可提高思科技協助人員診斷基礎架構問題的速度。 它可將搜尋、擷取和儲存診斷記錄和資訊的工作自動化到 SR 案例中。 該服務還會針對診斷簽章觸發分析,以便 TAC 能更有效地識別和解決內部部署設備的問題。

如需如何部署「可維修性連接器」的詳細資訊,請參閱可維修連接器的部署指南Cisco Webex。

故障排除流程

升級問題

遵循一些疑難排解指南之後,您應該對問題根源在哪裡有合理的想法。

程序

  1. 從與問題相關的系統收集盡可能多的信息。
  2. 請聯絡 Cisco 的適當團隊以開啟案件。

收集哪些客戶信息

如果您認為需要開啟案例或提升問題,請在與使用者進行疑難排解時收集下列 資訊:

  • 使用者識別碼:CI 電子郵件地址或使用者 UUID (這是 Webex 識別碼,但如果您也取得使用者的 BroadWorks 識別碼,請將其包含在案例詳細資訊中)。
  • 組織識別碼。
  • 遇到問題的大致時間範圍。
  • 用戶端平台和版本。
  • 從用戶端傳送或收集記錄。
  • 如果顯示在用戶端上,則記錄追蹤 ID。

查看服務台中的使用者詳細資料

具有「服務台管理員」(基本或進階) 角色權限的合作夥伴管理員 可使用此程序使用「幫助台」檢視檢視使用者詳細資訊。

程序

  1. 登入服務台。
  2. 搜尋使用者,然後按一下該使用者。 這會開啟使用者摘要畫面。
  3. 按一下使用者名稱以查看詳細的使用者組態。 此檢視中的有用資訊包括使用者的 UUID、通用身分識別 (CI) 叢集、Webex 應用程式叢集、呼叫行為、BroadWorks 帳戶 GUID
  4. 如果您需要在其他工具中使用此資訊, 或將其附加至 Cisco 案例,請按一下「複製」。

在服務台中檢視客戶組織

具有「服務台管理員」(基本或進階) 角色權限的合作夥伴管理員可 以使用此程序在「服務台」檢視中檢視中的客戶組織詳細資訊。

程序

  1. 登入服務台。
  2. 搜尋並按一下客戶組織名稱。
  3. 向下捲動,直到您看到「客戶入口網站檢視」, 然後按一下「檢視客戶名稱」以查看客戶組織的唯讀檢視, 包括使用者和組態。

從合作夥伴中心擷取使用者記錄檔

在疑難排解桌面和行動用戶端問題時,合作夥伴(和 TAC)能夠檢視用戶端記錄是很重要的。

程序

  1. 要求使用者傳送記錄檔。 如需協助,請參閱:Webex 應用程式 | 報告問題。
  2. 要求用戶導出呼叫環境並向您發送 ced.dat 文件。
  3. 從合作夥伴中心或服務台取得用戶端記錄。

    合作夥伴中心選項:

    1. 登入合作夥伴中心,找到使用者的客戶組織。
    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。)

    此驗證表示:

    • 用戶端已成功經過所需的 Webex 微服務。
    • 已成功驗證使用者。
    • 您的 Broadworks 系統會為客戶端發行一個長壽命的 JSON 網絡令牌。
    • 用戶端已擷取其裝置設定檔,且已註冊 BroadWorks。

取得用戶端記錄或意見反饋

  • 請參閱「資源」段落,以尋找 Webex 桌面用戶端上的特定用戶端記錄,或要求 使用者傳送記錄檔。 如需協助,請參閱:Webex 應用程式 | 報告問題。
  • 要求行動用戶端的使用者傳送記錄,然後您可以通過合作夥伴中心或服務台獲取記錄。

    傳送記錄檔是靜音的。 但是,如果使用者傳送回饋,則會傳送給 Webex 應用程式開發團隊。 如果您想跟進 Cisco,請務必記錄使用者的反饋編號。 例如:

    case number for submitted support case

取得通話環境資料

Webex 用戶端記錄被大量編輯以刪除個人身份信息。 您應 該在發現問題的同一階段作業中從用戶端匯出呼叫 環境資料。

程序

  1. 在用戶端上按一下說明 > 健康檢 查器。
  2. 選取「重設資料庫」。 這會觸發用戶端的完全重設並載入 Webex 應用程式登入畫面。

驗證 Webex 應該註冊至廣播公司

Webex 應用程式會檢查下列資訊,以判斷是否要註冊 BroadWorks:

  • 使用者擁有寬廣域連接器的權利。
  • 組織和使用者的呼叫行為。

檢查使用者的呼叫行為和連接器權利

  1. 使用合作夥伴管理員認證登入服務台。
  2. 搜尋使用者。
  3. 按一下使用者並檢查「呼叫行為」項目。 它應該是「在 Webex 中呼叫」。

    check a user's calling behavior

  4. 按一下使用者名稱以開啟「使用者詳細資訊」畫面。
  5. 向下捲動以找到權限區段,並確認包含廣域網連接器

    User details screen - broadworks connector enabled

    如果想為思科廣播工廠使用 Webex,則適用於思科廣播工廠的 Webex 使用者不應具有 bc-sp 標準權利。 這是「Webex Calling(Broadcloud)」的權利,即 Webex 應用程式透過 Cisco 管理的雲端呼叫服務進行呼叫。

檢查組織的呼叫行為

  1. 使用合作夥伴管理員認證登入服務台。
  2. 搜尋組織。
  3. 按一下組織並檢查「呼叫行為」 項目。 它應該是「在 Webex 中呼叫」。

分析 PSLog 以查找使用者佈建問題

使用應用程式伺服器的 PSLog 查看對佈建橋接的 HTTP POST 要求,以 及來自 Webex 的回應。 在正確的工作情況下,回應為 200 OK,幾分鐘後 ,您可以看到使用者-如果是第一個用戶,則是新的客戶組織- 已在 Webex 中建立。 您可以透過搜尋服務台尋找 POST 中 看到的電子郵件地址來驗證這一點。

在開始之前

在與測試使用者進行流程佈建嘗試期間,從應用程式伺服器收集 PSLog 。

程序

  1. 首先,檢查 HTTP 響應代碼:
    • 除了 200 OK 以外的任何內容都是使用者佈建失敗。
    • 如果有關訂戶設定檔在佈建橋接上游的 Webex 服務中不起作用,則 200 OK 仍可能表示失敗。
    • 400 在回應中可能包含一個消息節點。 佈建橋接無法處理訂閱者設定檔中的某些內容。 訂閱者詳細資料可能出現問題,或者與範本中的設定不相容。
    • 401 表示在 AS 上輸入的佈建憑證不符合在合作夥伴中心中的範本上輸入的證明資料。
    • 403 可能表示應用程式伺服器上設定錯誤。 檢查請求的目標。它不應該是 IP 位址,它應該是您可以在 Partner Hub 中的範本上看到的佈建橋接 URL。
    • 409 表示提供的訂閱者設定檔和現有 We bex 資料之間存在衝突。 可能有現有使用者擁有該電子郵件地址。 檢查回應中的訊息。
  2. 您也可以檢查原始 HTTP POST 是否有可能導致 佈建失敗的任何可疑值。 POST 包含訂閱者設定檔 XML 結構。 在這裡,可以檢查的有用節點是:
    • bwuserid:如果您需要在 BroadWorks 中 編輯訂閱者個人資料,請使用此選項來查找訂閱者個人資料。
    • 群組:如果範本處於「服務提供者模式」,則會以小寫字母,並變成您在「合作夥伴中心」中看到的客戶組織名稱。
    • 服務提供者:如果範本處於「企業模式」,則會以小寫字母, 並變成您在「合作夥伴中心」中看到的客戶組織名稱。
    • 主要電話號碼:必須存在。 在沒有它的情況下,佈建將失敗。
    • 電子郵件:成為 Webex 中的使用者 ID。 Webex 必須有效且唯一,否則佈建將失敗。

      忽略服務字節:它 是由 AS 創建的,並且接受但不被 Webex 使用。

分析 XSP 記錄以疑難排解訂戶登入

此流程說明廣域工程驗證模式。 您可以在合作夥伴中心的 BroadWorks 範本上查看驗證模式。 請參閱 https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726 中的設定您的客戶範本。

下列階梯圖顯示使用者在 Webex 應用程式中執行 BroadWorks 驗證時,使用者、用戶端、Webex 服務和 BroadWorks 系統之間的互動。 此外,Webex 與 XSP 之間的連線也是由 MTLS 保護。

下面的討論說明您在調查成功登入記錄時可 以看到什麼。Analyze XSP logs to troubleshoot subscriber log in -flow

使用者與用戶端互動,用戶端與 Webex 服務互動:

  • 使用者將其電子郵件地址提供給 Webex 應用程式(圖中 1)。
  • CI 知道該用戶重定向以輸入他們的 BroadWorks 密碼(通過 UAP)( 圖中 2)。
  • IDP 代理將取得設定檔請求提交至 XSP 上的 Xsi 介面。

在貓的訪問日誌中:

  • 尋找訂戶設定檔的 GET 請求,從 Webex 到 Xsi-Actions 介面(圖中的 2.1)。 它具有 Webex 使用者 ID。 例如:

    獲取 /com.布羅德軟 t.xsi-動作 /v2.0/使用者/電子郵件/個人資料 webexuserid@example.com

在 XSIA 動作日誌中:

  • 查找來自 Webex 的設定檔 GET 請求(圖中的 2.1)。 它具有 Webex 使用者 ID。 例如:

    取得 /com.broadsoft.xsi-actions/v2.0/使用者/webexuserid@example.com/個人資料標題包括授權:基本和用戶代理:廣域工作團隊客戶

  • 然後 XSP 對 Broadworks 進行 OCI-P 基本身份驗證(驗證 VerifyRequest 和驗證 VerifyResponse ,就像任何其他通過 Xsi 執行基本身份驗證的應用程序一樣)以及使用者 GetRequest 和服務提 供者 GetRequest 來收集訂戶信息。
  • 對 Webex 的 Xsi 回應包含一個 XML 設定檔區塊,其中包含 (BroadWorks) 使用者 ID 和其他詳細資訊 (在圖表中的 2.2)。

用戶端和 Webex 服務互動:

  • IDP 代理會匹配來自 BroadWorks 收到的使用者設定檔,並將 SAML 宣告發送給 用戶端(圖中的 2.3)。
  • 客戶端將 SAML 聲明交換為 CI 令牌(圖中 3)。
  • 用戶端會檢查登入的使用者是否具有廣域網路連接器權限 (圖中 4)。 您可以在服務台中檢查使用者權限。
  • 客戶端使用 CI 令牌從 IDP 代理( 圖中 5)請求 JSON Web 令牌(JWT)。
  • IDP 代理在 CI 驗證 CI 中的 CI 令牌。
  • IDP 代理從身份驗證服務要求 JWT。

在驗證服務記錄檔中:

  • 查找來自 Webex 的令牌請求(圖中的 5.2),例如:具有 http _bw_userid 標頭等的 GET /AuthService/令牌。
  • XSP 會執行 OCI-P 使用者 GetLoginInForequest,以驗證提供的使用者識別碼是否對應於 BroadWorks 使用 者 (圖表中的 5.3)。 AuthService 透過 MTL 連線建立 Webex 的信任,因此可以發行 LLT。
  • 從 LongLive Token Manager 查找回應(圖中的 5.4)- 生成的代幣,主旨:bwksUserId@example.com,發行人:BroadWorks... 和 狀態代碼 = 200,您可以使用跟踪 ID:CLIENT... 標頭與原始請求關聯。

在 XSIA 動作日誌中:

  • 客戶端能夠在 Xsi-Actions 界面上呈現長壽命令牌以獲取其設備配置文件(圖中 6)。 例如:GET /com.broadsoft.xsi-actions/v2.0/用戶/bwksuSerid %40example.com/個人資料/設備具有標題授權:持有令牌和用戶代理:WebExTeams(變體/版本)
  • Xsi-Actions 介面將令牌發送到驗證服務(設定為在循環介面上),例如:127.0.0. 1:80 POST http://127.0.0.1:80/authService/token 您可以與 GET 中的追蹤 ID:CLIENT... 標頭和 POST 中的 X-BROADSOFT-相關 ID:客戶端... 標題進行關聯。

在驗證服務記錄檔中:

  • 從 Xsi 收到郵政信息(循環回)

  • 狀態代碼 = 200 返回 Xsi

  • 還有一個令牌驗證響應,主體中有一個「令牌」JSON 塊。

  • 使用跟踪 ID 進行關聯:客戶端...

在 XSIA 動作日誌中:

  • 從驗證服務接到 200 個確定後, Xsi-Actions 應用程序現在會發送 OCI-P 要求給用戶主要和 SCADEdiceGetListRequest
  • 接收 OCI-P 使用者主要和包含存取裝置表 XML 結構的 SCADEVICE 列表回應。
  • OCI-P 回應被編碼為對用戶端的 Xsi 響應,包括具有設備類型的存取設備 XML 結構。 例如:商務通訊器 — PC 和用戶端可以擷取裝置組態檔的網址。

用戶端如常繼續:

  • 選擇設備項目並與 DMS 互動以獲取設備配置文件(圖中 6)。
  • 通過從 DMS 配置中檢索的 SBC 註冊到 BroadWorks(圖中的 7 個)。

特定問題疑難排解

合作夥伴中心問題

1.管理員看不到客戶組織

作為 Webex 中合作夥伴組織的管理員,您應具有完整管理員角色。 該角色可用於管理您的合作夥伴組織,包括指定管理權限給自己和其他人。 若要管理客戶組織,您需要授與自己(或其他人)銷售完整管理員角色或銷售管理員角色。 如需詳細資訊,請參閱在 Control Hub 中指派組織帳戶角色。

使用者佈建問題

1.針對特定企業/客戶的整合 IM&P 錯誤

如果您的企業組合使用不同雲端協作服務,例如 UC-One SaaS 和適用於 Cisco BroadWorks 的 Webex,您可能已選擇針對每個企業修改佈建介面卡。

若要檢查整合式 IM&P 設定的內容 (預設為企業,除非存在更具體的設定除外), 請執行 as _CLI/ 介面/訊息 > get。 如需 特定企業的佈建參數,請開啟企業並移至 服務 > 整合式 IM&P。

檢查該企業的整合 IM&P 組態是否完全符合「合作夥伴中心」 中「客戶範本」中顯示的設定。 下列設定必須相符,否則企業中所有使用者的 佈建失敗:

廣域工企業整合式 IM&P 設定 合作夥伴中心客戶範本設定
訊息伺服器 URL 正在設定 URL
訊息伺服器使用者名佈建帳戶名稱
訊息伺服器密碼佈建帳戶密碼,確認密碼

二.針對特定使用者的整合 IM&P 錯誤

如果您正在使用流量佈建,並假設佈建適用於某些/大多數使用者(因此您可以排除組態問題),這一點適用。 如果您在 BroadWorks 中看到整合式 IM&P 錯誤,例如「[錯誤 18215] 通訊伺服器佈建錯誤」和「[錯誤 18211] 與訊息伺服器的通訊錯誤」,您應該調查下列潛在原因:

  • 使用者的電子郵件地址可能已存在 CI。 在服務台中搜尋使用者,以檢查他們的電子郵件地址是否已存在。 這並不一定是確定的,因為使用者可能存在於您不允許在服務台中查看其資料的組織中。
  • 使用者在被指派整合式 IM&P 服務之前,獨立註冊 Webex。 在這種情況下,其中一個選項是讓使用者刪除他們的免費帳戶,以便他們可以成為您佈建的客戶組織的一部分。 說明請參閱 https://help.webex.com/5m4i4y
  • 使用者沒有指定給其設定檔的主要電話號碼 (所有適用於 Cisco BroadWorks 的 Webex 訂戶都必須具有主要 DID)。 請參閱有關從 AS 分析 PSLog 的主題。

三.佈建橋接回應時使用者佈建失敗

如果使用者未出現在 Control Hub 中,請在指派整合式 IM&P 後幾分鐘內查看來自佈建橋接服務的回應代碼。 執行 PSLog 以查看 HTTP 響應代碼。

200 OK

200 OK 回應並不意味著使用者已成功佈建。這表示佈建服務收到請求,並成功將對應的使用者建立請求提交至上游服務。 根據設計,佈建交易是非同步的。 該服務回應 200 OK,因為使用者建立過程可能需要數分鐘,而出於性能原因,我們不希望接收多個要求來建立相同使用者。 但是,如果使用者在 200 OK 回應之後最終未出現在「客戶組織」中,則可能表示在佈建服務的 Webex 服務上游中建立使用者失敗。 您需要升級具有 200 OK 回應的佈建失敗。

400 個錯誤要求

檢查 HTTP 回應,該回應該有關可能導致佈建服務此回應的潛 在問題的更多詳細信息。 節點的一些示例:

  • 「無法信任使用舊版佈建 API 的 BroadWorks 電子郵件。」與失敗的使用者佈建請求相關 聯的電子郵件地址無效,或輸入錯誤,但 您已在範本中確定電子郵件地址可以受信任。 檢查 BroadWorks 中 的用戶個人資料,特別是電子郵件 ID。
  • 在資料庫中找不到客戶組織,也沒有啟用新的組織建立旗標。」 此失敗的佈建請求應該是在 Webex 中建立新的客戶組織,但 您的範本已設定為防止建立新的客戶組織。 如果 您想允許新組織,對於不符合 Webex 中現有 客戶的電子郵件網域,則可以在合作夥伴中心中重新設定範本,然後重新測試佈建請求。 但是,如果您不希望為此使用者建立新組織 ,則可能電子郵件地址輸入錯誤 (特別是網域部分)。 在 Broad works 中檢查用戶的電子郵件 ID。

403 禁止

在您修正組態之前,佈建請求才能成功。 在這種情況下,您需要調查請求和回應。 例如,如果您看到一個 IP 位址作為佈建要求的目標,而不是組織的適當佈建橋接 URL (請參閱解決方案指南中的防火牆組態主題),則可能表示您的應用程式伺服器缺少必要的修補程式 (ap373197)。

檢查是否已套用所有必要的修補程式至應用程式伺服器,並且您已 完成相關組態,以便成功透過程佈建。

409 衝突

佈建請求無法繼續,因為 Webex 中有一個與請求中的電子郵件地址 相符的現有使用者。

4.使用者已使用 CI

從 HTTP POST 請求中取出訂戶電子郵件,並在服務台中搜索它。 如果 您不被允許,您可能無法看到用戶,但您也可能會看到該用戶在 「免費」組織中,例如 「消費者」。 您可以要求此用戶刪除他們的免費帳戶,也 可以使用其他電子郵件地址來佈建它們。 請參閱 https://help.webex.com/ndta402。

使用者登入問題

1.使用者啟動入口網站未載入

適用於 Cisco BroadWorks 的一般 Webex 登入流程包括使用者啟用入口網站,使用者可在其中輸入密碼。 有時,使用者在 Webex 應用程式登入畫面中提供電子郵件地址後,此入口網站不會載入。 此問題可能是在客戶端或服務端引起的。 在客戶端,這通常是由於用戶端的原生瀏覽器在某種方式與服務不兼容所造成的。

二.單次登入失敗

  • 在 BroadWorks 中,檢查是否已為使用者指派 Webex 應用程式的裝置類型 (請參閱解決方案指南中的「準備環境」區段中的裝置設定檔一節)。
  • 檢查使用者是否使用正確的密碼。 如果您用來 佈建使用者的客戶組織 (在合作夥伴中心中心) 的範本設定為 BroadWorks 驗證,則使用者應輸入其 BroadWorks「Web 存取」密碼。 如果 使用者的電子郵件地址未 設定為替代使用者 ID,則使用者也可能需要輸入其 BroadWorks 使用者 ID。 確定使用者已正確輸入大寫和 小寫字元。

呼叫組態和註冊問題

在 Webex 中佈建使用者並成功登入 Webex 應用程式之後,該應用程式會註冊至 BroadWorks。 以下是預期的註冊順序以及註冊健康的所產生的跡象(從 Webex 應用程式所見):

1.預期的註冊順序

  1. 用戶端呼叫 XSI 以取得裝置管理權杖以及 DMS 的 URL 網址。
  2. 用戶端會向 DMS 請求其裝置設定檔,請求方式為出示步驟 1 的權杖。
  3. 用戶端讀取裝置設定檔,並擷取 SIP 認證、位址和連接埠。
  4. 用戶端使用步驟 3 的資訊將 SIP REGISTER 傳送至 SBC。
  5. SBC 會將 SIP 登錄器傳送到 AS (如果 SBC 尚未知道 SIP 使用者,SBC 可能會在 NS 中執行查詢以尋找 AS。)

二.客戶註冊成功的預期跡象

呼叫選項圖示會出現在 Webex 介面中。

在 Webex 應用程式電話服務標籤 (例如:Windows 上的設定 > 電話服務、偏好設定 > Mac 上的電話服務) 中,「SSO 工作階段:您已登入」訊息表示應用程式已成功註冊 (在這種情況下是 BroadWorks)。

三.用戶端沒有通話圖示

大多數情況下,這意味著用戶沒有正確的許可證/權利。

用戶端顯示電話服務標籤,但沒有 SSO 會話

Webex client shows phone services tab but no SSO session

這是註冊失敗。 Webex 應用程式用戶端無法在 BroadWorks 註冊的原因有多種原因:

4.多個通話服務與相同的用戶端進行測試

此已知問題可能是由於用戶端在不同的呼叫後端之間進行變更所造成的。 在試用(相同)Webex App 用戶端提供的不同呼叫服務時,最可能發生這種情況。 您可以重設用戶端資料庫 (連結) 來解決此問題。

5.驗證服務的設定錯誤

根據「解決方案指南」檢查託管驗證服務的 XSP (請參閱針對思科 Broadworks XSP 的 Webex 上設定服務)。 具體:

  • RSA 金鑰 (您在一個 XSP 上產生的) 會複製到所有 XSP
  • 驗證服務 URL 已提供給所有 XSP 上的 Web 容器,並在合作夥伴中心的叢集中正確輸入
  • 已設定憑證的外部驗證:

    XSP_CLI/ 系統/通信實用程序/默認設置/外部身份驗證/證書驗證 > GET

    allowUserApp = false

    allowClientApp = true

  • 使用 MTLS 時,您必須將 Webex 用戶端憑證上傳到 XSP (您可以從「Broadworks 設定」頁面上的合作夥伴中心取得憑證)。

六.布羅德維克斯標籤的設定錯誤

檢查您是否已為 Webex 應用程式設定所需的 BroadWorks 標籤。 如需有關組態標籤的資訊,請參閱《思科廣域網路設定指南》。 確保沒有衝突或值不正確。 具體而言,%SBC_ADDRESS_WXT% 標籤應該是對於 Webex 應用程式用戶端的 SIP 註冊商的 SBC。

七.成功 SSO 連線後,桌面用戶端中斷電話服務

此問題可能是因為相同的使用者在相同平台類型上登入多個用戶端所造成。 例如,如果使用者在 Windows 上成功登入 Webex 應用程式,然後在其他 Windows 電腦上登入 Webex 應用程式,則其中一部電腦上只會有作用中的 SSO 工作階段。 這是依設計而定。 如果您絕對需要解決此問題,您可以將 BroadWorks 設定為具有相同裝置類型的多個執行個體,但它們必須具有唯一的 SIP 位址。 此組態不在適用於思科廣播工程的 Webex 範圍內。

八.未為使用者佈建桌上型裝置

這個簽名可以在用戶端記錄中看到:

[0x70000476b000] 廣域工作配置下載器 .cpp: 106 <Error>

onAccessDeviceList 成功:bwc: scf: 配置下載-找不到設備配置文件「商業通信器-PC」。

九.輸入流動電話響一次或無法接聽

對 Webex 行動裝置的輸入通話只會撥打一次,否則使用者無法接聽輸入通話。 同一使用者的其他端點可能會繼續響鈴。

如何識別?

在 Webex 行動用戶端記錄檔中,在推送呼叫流程中尋找 XSI 錯誤代碼 101002。 例如:

回應代碼:400

<callID>手機呼叫資訊失敗:BWC: 內部:推送呼叫:CALL 的 xsi 狀態:xsi 錯誤代碼:101002

<callID>關閉 PushCallWithReason: BWC: 內部:嘗試使用 id = 關閉推送呼叫,原因 = 呼叫被放棄

原因:錯誤代碼 101002 可以指出在 Loc ateUser 回應中傳回錯誤的應用程式伺服器 (AS)。 當使用者移轉至次要 AS 時,可能會發生這種情況。

建議檢查:

從部署 Push 的 ADP 或 XSP,針對受影響的使用者執行 LocateUser:

<FQDN or IP address of NS Server>捲曲「HTTP://: 80/Servlet/ 位置用戶?<BW userID @domain >URL = & 返回相容 XSP = 真實 & 呼叫查詢 = 真實 '

範例:捲曲 'http://1.1.1.1:80/servlet/LocateUser?網址 = 9721112222@gmail.com & 返回相容 XSP = 真實 & 呼叫查詢 = 真實 '

解決方法:如果 LocateUser 傳回使用者的次要 AS,請在主要 NS 伺服器上執行 MigrateUserToDefaultNode.pl 指令碼,將使用者遷移回叢集的主要應用程式伺服器。

通過 SSH 登錄 NS 服務器,轉到 /usr/本地/廣域/bw_base/bin 目錄,然後運行:移轉用戶到默認 node.pl <hostingNE>

範例:將用戶移轉到默認 node.pl bwas1

要獲取主機 NE 值,請運行:NS_CLI/系統 /設備/主機NE> 獲取

指令碼首先檢查是否可以找到您提供作為引數的主機 NE。 確認主機 NE 是否有效後,它會將 DN、擴充功能和 URL 更新為該主機 NE 的預設節點。

在可能的情況下在低流量期間執行指令碼。 但是,通常可以在需要為受影響用戶恢復服務時隨時運行腳本。

指令碼不能僅針對單一使用者執行。 它會移轉位置使用者輸出中列出的所有使用者。 如果您無法執行指令碼,請在 BroadWorks 中刪除並重建受影響的使用者,以便使用者在正確的 AS 上重建。

從使用者裝置到次要 AS 的任何 SIP 訊息都可以導致使用者移轉。 除非傳入的請求繼續到達次要 AS,否則使用者通常會在預設 15 分鐘間隔後回到主要 AS。 例如,如果 SBC 無法連線到 AS1 並遞歸到次要 AS,則受影響的使用者可能會切換到次要 AS。 視部署而定,如果 SBC 繼續存取主要 AS 時,單一主幹群組或使用者可以保持固定至次要 AS。

如須詳細資訊,請參閱以下文件:

九.電話服務中斷

如果使用者登入 Webex App 後,電話服務顯示為已中斷連線,或使用者使用用戶端時電話服務中斷連線,請檢查用戶端類型和註冊流程。

對於 Windows 和 Mac 用戶端,Webex 應用程式會註冊 SIP 並在使用者登入時保留作用中的 SIP 註冊。

檢查以下內容:

1. 確認 config-wxt.xml 已成功下載。

在用戶端記錄檔中,搜尋設定下載。

成功下載顯示:

設定下載-成功完成

如果記錄檔顯示下列錯誤,請檢查 AuthService 記錄檔是否有與令牌相關的錯誤:

配置下載-失敗,錯誤代碼:1511

2. 確認已找到 Webex 裝置設定檔。

在用戶端記錄中,確認已找到存取裝置,且使用值為 1。 如果使用值為 0,請檢查主要行是否已啟用還是停用,並驗證標籤值。 如需詳細資訊,請參閱《廣域工程版 Webex 組態指南》中的 6.1.44 節主要設定檔。

範例記錄項目:

: BWC: SCF:配置下載-找到訪問設備

: BWC: SCF: 配置下載-訪問設備:設備類型 = 商業通信器-PC, 設備 Level = 群組, 允許終止 = 1, 是設備所有者 [具有 _ 值:0,使用值:1],具有擁有者設備:1,端點類型:共用呼叫外觀

: BWC: SCF: 配置下載-訪問設備:設備類型 = 連接-移動,設備級別 = 群組,允許終止 = 1,是設備所有者 [具有 _ 值:0,使用值:1],具有擁有者設備:1,端點類型:共用呼叫外觀

: BWC: SCF: 配置下載-訪問設備:設備類型 = 連接-平板電腦,設備級別 = 群組,允許終止 = 1,是設備所有者 [具有 _ 值:0,使用值:1],具有擁有者設備:1,端點類型:共用呼叫外觀

3. 在解析 SIP 代理位址時,檢查 DNS 失敗。

如需有關 SIP 代理探索的詳細資訊,請參閱《廣域工廠 Webex 組態指南》中的 6.1.6 動態 SIP 代理伺服器探索節。

成功的代理發現顯示:

代理發現完成,獲得<number>結果

4. 檢查 SIP 註冊是否失敗。

如果記錄檔顯示 M註冊:TCP 逾時或原因:SIP; cause=200; text="last = TCP 逾時」,則 Webex 用戶端無法建立與 SBC 的低層 TCP 連線。 發生此錯誤時,SIP 註冊無法完成。 檢查使用者網路上是否封鎖 TCP,或 SBC 是否拒絕 TCP 連線。

如果 SIP REGISTER 請求被拒絕或沒有收到回應,請在記錄中搜尋 REGISTER sip,並確認是否傳回 SIP/2.0 200 確定。 如果未傳回,請檢查使用者的網路是否封鎖 SIP,或 SBC 是否拒絕請求。

在 BroadWorks 管理員中,移至使用者 > 公用程式 > 註冊,並確認 Webex 用戶端是否存在有效的 SIP 註冊。

對於 Android 和 iOS 行動用戶端,在撥打或接收通話之前,Webex 應用程式才會註冊 SIP。 通話完成後,註冊將被移除。 移動用戶端註冊接收推送通知。

對於行動用戶端,請檢查下列項目:

1. 確認 config-wxt.xml 已成功下載並找到裝置設定檔,如適用於 Windows 和 Mac 用戶端的說明。

2. 確認推送註冊成功。

在 Webex 記錄檔中,尋找推送註冊狀態:

OnPushRegistrationStateChanged:: 推送註冊狀態已變更,狀態 = 未註冊

OnPushRegistrationStateChanged:: 推送註冊狀態已變更,狀態 = 已註冊

在 BroadWorks 管理員中,移至使用者 > 公用程式 > 推送通知註冊,並確認 Webex 用戶端是否存在有效的推送註冊。

通話設定網頁檢視問題

1.Webex 應用程式中不顯示自我護理按鈕/連結

此問題的不同症狀是顯示按鈕/連結,但按一下該按鈕會開啟 外部瀏覽器。

  • 確認已部署所需的用戶端組態範本,並且 CSW 標籤已正確 設定。 (請參閱《適用於思科廣域 工程的 Webex 解決 方案指南》中的通話設定網頁檢視區段)。
  • 確認 Webex 應用程式已註冊以在廣域工廠撥打電話。
  • 檢查 Webex 應用程式是否為支援 CSWV 的最新版本。

二.單擊自我保健按鈕/鏈接後的空白頁面或錯誤

一般而言,Webex 應用程式中的這種行為表示 BroadWorks XSP 上 CSWV 應用程式存在組態或部署問題。 收集詳細資訊以供進一步調查,包括 CSWV 記錄檔、存取記錄檔、config-wxt.xml 儲存庫和範本檔案,然後提出案例。

網域索償問題

使用者註冊錯誤可能是因為申請網域時所發生的錯誤。 在註冊任何網域之前,請確保您瞭解下列各項須知:

  • 服務提供者不得註冊其管理的客戶組織的網域。他們只能註冊位於服務提供者內部組織中的使用者網域。註冊其他組織中的使用者網域(即使是服務提供者管理的網域)可能會導致客戶組織中發生使用者註冊錯誤,因為使用者身分驗證請求是透過服務提供者傳送,而不是透過客戶組織傳送。
  • 如果兩個客戶組織(A 公司和 B 公司)共用相同的網域,且 A 公司已註冊該網域,則 B 公司的使用者可能會無法註冊該網域,因為使用者身分驗證請求其實是透過已註冊該網域的組織(A 公司)傳送。

    如果您錯誤地聲稱任何網域,且需要移除聲 明,請參閱管理您的網域 Webex 文章。

一般使用者錯誤代碼

下表說明用戶端使用者啟動入口網站中可能看到的最終使用者 錯誤代碼。

這不是錯誤代碼的詳盡清單。此表格僅列出 Webex 應用程式目前無法向使用者提供明確指導的現有錯誤代碼。

表一表 1:最終使用者錯誤代碼

錯誤碼

錯誤訊息

建議的行動

100006

登入失敗:用戶 ID/密碼不正確。

檢查使用者是否使用正確的密碼。 如果您用來 佈建使用者的客戶組織 (在合作夥伴中心中心) 的範本設定為 BroadWorks 驗證,則使用者應輸入其 BroadWorks「Web 存取」密碼。 如果 使用者的電子郵件地址未 設定為替代使用者 ID,則使用者也可能需要輸入其 BroadWorks 使用者 ID。

確定使用者已正確輸入大寫和 小寫字元。

200010

無法驗證憑證,因為 BroadWorks 使用者未經授權。

用戶應嘗試不同的用戶名和密碼組合。

否則,管理員必須在 Broadworks 中重置密碼。

200013

抱歉,您現在無<name of SP offer>法加入 Webex。 請在幾分 鐘後再試一次。 如果問題仍然存在,請聯繫您的 <客戶組 織管理員 >。

無法更新通用識別中的使用者資訊。 請使用使用者 API 再次更新用戶。

200014

請聯絡您的<Service Provider>管理員。

檢查以確定您的組態是否正確,以及請求中的 佈建 ID 是否正確。
200016由於找不到工作階段,驗證憑證失敗。使用者應重新整理瀏覽器並重試使用者名稱/密碼。
200018由於使用者被鎖定,驗證憑證失敗。使用者應該等待 10 分鐘,然後再試一次。
200019無法驗證憑證,因為新增使用者自行啟用失敗。管理員應檢查控制中心中的自我啟動設定。
200022由於使用者未經驗證,無法傳送電子郵件。使用者應重新嘗試加入並輸入認證。
200025抱歉,您現在無法加入自我激活。請在幾分鐘後再試一次。 如果問題仍然存在,請聯絡您的系統管理員。請使用者在幾分鐘後再試一次。 如果這不起作用,請洽詢 思科支援部門。
200026由於預檢查失敗或 PartnerOrgUUID 的待處理使用者狀態不正確,電子郵件驗證失敗。 : {partnerOrgUUID} ,BroadoworksUUID : {broadworksUUID} ,ConfigSetUUID : {configSetUUID}管理員應通知使用者輸入錯誤的電子郵件地址,因為 電子郵件地址與其他組織相關聯。
200039驗證電子郵件為已在不同組織中使用的電子郵件 ID 失敗。使用者應嘗試再次登入相同的驗證連結,但使用不 同的 BroadWorks 使用者 ID。

否則,來自不同組織的客戶組織管理員 應刪除現有的使用者帳戶。

200040驗證電子郵件失敗,因為 ConfigSet 與客戶配置中的 ConfigSet 不匹配。管理員應將使用者使用的驗證連結與 Control Hub 中設定 的連結進行比較。 兩個鏈接和配置集必須匹配。
200041驗證電子郵件失敗,因為使用者已有權使用另一項衝突的 服務,權利衝突。使用者應嘗試使用不同的 BroadWorks 使用者 ID 再次登入相同 的驗證連結。

否則,管理衝突服務的 客戶組織管理員應刪除衝突的服務或 權限。

200042驗證電子郵件失敗,因為電子郵件已與其他 BroadWorks 使用者 ID 關聯。使用者應使用不同的電子郵件地址再試一次。

否則,管理員必須 刪除使用此電子郵件地址的其他使用者。

200043驗證電子郵件失敗,因為使用者客戶配置對應不正確。使用者應使用不同的電子郵件地址再試一次。 否則,管理員必須 刪除使用此電子郵件地址的其他使用者。
200044驗證電子郵件失敗,因為使用者 ID 已在此 Broad Works 叢集中使用。使用者應使用不同的電子郵件地址再試一次。 否則,管理使用此 電子郵件地址的現有使用者帳戶的客戶組 織管理員必須刪除該使用者帳戶。
200045由於使用者已經是不同組織的一部分,因此透過自我啟動新 增使用者失敗。使用者應重新嘗試加入,但使用不同的電子郵件地址。 否則,管理 不同組織的客戶組織管理員應刪除 現有帳戶。
200046透過自行啟動新增使用者失敗,因為在同一 BroadWorks 叢集中存在多個 具有相同 BroadworksUserID 的待處理使用者。管理員應從控制中心刪除待處理的使用者。
200047由於此 BroadWorks 叢集已經使用使用者 ID,因此無法透過自我啟動新增使用者。使用者應使用不同的電子郵件地址再試一次。 否則,管理現有使用者帳戶的客戶組 織管理員應刪除該 現有使用者帳戶或移除其他權限。
200048透過自行啟動新增使用者失敗,因為電子郵件地址已 經提供了不同的 BroadWorks 使用者 ID。使用者應使用不同的電子郵件地址再試一次。
200049由於此 BroadWorks 叢集已經使用使用者 ID,因此無法透過自我啟動新增使用者。使用者應使用不同的電子郵件地址再試一次。 否則,管理現有使用者帳戶的客戶組 織管理員應刪除該 現有使用者帳戶或移除其他權限。
200050透過自行啟動新增使用者失敗,因為佈建 ID 不符合訂戶企業 預期的佈建 ID。管理員應將使用者使用的驗證連 結與 Control Hub 中設定的連結進行比較。 兩個鏈接和配置集必須匹配。
200051透過自行啟動新增使用者失敗,因為此請 求中指定的 SPEnterpriseID 與已從此 BroadWorks 叢集佈建的服務提供者或企業衝突 。管理員應檢查 Control Hub 中的現有組織,並確定它們並 不是建立具有已存在的名稱的組織。
200054無法驗證電子郵件,因為客戶組織與合作夥伴組織的區域不相符 。管理員應檢查 Control Hub 中的合作夥伴組織和客戶組織設定, 並確定區域是否相符。
200056使用者正在使用相同電子郵件進行登入失敗使用相同的電子郵件地址已經進行使用者入職。 用戶應該等待幾分鐘,然後再試一次。 如果問題持續發生,管理員應檢查該電子郵件地址是否有待處理或重複的入職記錄,並清除待處理使用者狀態,然後再重試。
300005預先檢查失敗,因為使用者已經在佇列中並正在佈建的過 程中。使用者佈建仍在進行中。 請等待幾分鐘,然後再次 檢查。
300006你現在不能<name of SP offer>加入。 請在幾分 鐘後再試一次。 如果問題仍然存在,請聯繫您的 <客戶組 織管理員 >。 參考編號:<reference ID>用戶應該在幾分鐘後再試一次。 如果這不起作用,請聯繫思科 API 支持團隊,請聯繫 https://developer.webex.com/

目錄同步的錯誤代碼

下列錯誤代碼適用於目錄同步。

錯誤碼

錯誤訊息

600000

BroadWorks 外部目錄使用者同步意外錯誤。

600001

BroadWorks 外部目錄使用者同步失敗。
600002

必須在完成之前終止 BroadWorks 外部目錄使用者同步。

600003

BroadWorks 外部目錄使用者同步僅部分成功。 部分客戶組織無法同步。

600004未啟用 [設定組] [BroadWorks 外部目錄使用者同步]。
600005ConfigSet 正在進行「BroadWorks 外部目錄使用者同步」。
600006BroadWorks 外部目錄用戶同步執行緒忙碌或關閉,因此不接受更多同步請求,稍後再試一次。
600007找不到客戶配置的身分組織。
600008在合作夥伴組織中找不到客戶配置。
600009無法執行 BroadWorks 外部目錄使用者同步,因為與 CustomerConfig 相關聯的廣域工作叢集已經忙碌。
600010無法執行 BroadWorks 外部目錄使用者同步,因為沒有與 CustomerConfig 相關聯的廣域作業叢集。
600011客戶配置未啟用 BroadWorks 外部目錄使用者同步。
600012無法執行 BroadWorks 外部目錄使用者同步,因為 CustomerConfig 已啟用混合目錄同步功能。
600013BroadWorks 外部目錄使用者同步無法將使用者和機器帳戶新增到身分識別存放區。
600014嘗試連線至 BroadWorks 叢集時,BroadWorks 外部目錄使用者同步失敗。 來自 Broadworks 的錯誤 - %s。
600015BroadWorks 外部目錄使用者同步在身分識別存放區中找不到任何相符的使用者。
600017BroadWorks 電話清單同步無法同步所有使用者和企業/組織聯絡人。
600018對於企業/組織中的使用者,BroadWorks 電話清單同步失敗。
600019BroadWorks 電話清單同步無法同步企業/組織聯絡人。
600020由於 CustomerConfig 同步處理中,無法停用 BroadWorks 外部目錄使用者同步。
600022由於企業沒有佈建的使用者,因此無法進行 BroadWorks 外部目錄單一使用者同步。
600023BroadWorks 外部目錄單一使用者同步不可能,因為使用者已存在於此組織中。
600024BroadWorks 外部目錄單一使用者同步無法進行,因為在 BroadWorks 中找不到匹配的使用者。
600025BroadWorks 外部目錄使用者同步在 CI 中消費者帳戶使用者同步。
600026BroadWorks 外部目錄使用者同步無法更新 CI 中的機器帳戶。
600027BroadWorks 外部目錄單一使用者同步無法進行,因為在 BroadWorks 中找到多個使用者。
600028BroadWorks 外部目錄單一使用者同步不可能,因為至少應完成一個企業目錄同步。
600029BroadWorks 外部目錄使用者同步失敗,因為企業沒有供應使用者。

變更歷史記錄

此表格包含本指南的變更歷史記錄。

日期變更
二零二六年七月二十八日
  • 新增了一個新的子區段,「來電設定和註冊問題」部分下的輸入行動通話響一次或無法接聽。

  • 添加了新的錯誤代碼詳細信息:200056 和 300006。

二零二五年十月二十九日更新了「有用的記錄檔」表格 XSLog 來源欄。
二零二五年四月二十三日從 Broadworks 呼叫 Webex 應用程式記錄來源中移除 bwc 資料夾。
二零二三年七月二十九日新增 Webex App | 在從合作夥伴中心 擷取使用者記錄檔和取得用戶端記錄或意見區段中報告問題 (以產生記錄檔) 的參考 。
2022 年 6 月 27 日更新了連接(Android)遷移到 Firebase 程序方法中缺 少鏈接的閱讀列表。
二零二年六月二十一日更新了閱讀清單連結,指向 Cisco.com 上的新網址。 針對 BroadWorks 標籤問題,新增至「適用於思科廣域網路設定指南」連結,更新呼叫組態和註冊問題。
二零二年四月十四日新增前後關聯陳述式,以便在服務台中檢查使用者詳細資訊,以及檢視服務台中的 客戶組織,以清楚說明服務台的 角色要求。
二零二年三月二十六日在目錄同步的錯誤代碼中添加了新的錯誤代碼。
2021 年 11 月 15 日將錯誤代碼 200013、200014、200025 和 300005 新增至一般使用者錯誤代碼。
二零二一年九月二十八日新增目錄同步的錯誤代碼。
二零二一年七月十五日在一般使用者錯誤代碼中新增錯誤訊息 100006。 也更新了 使用者登入問題。
二零二一年七月十四日添加了主題,其中包含已知問題和限制文章的鏈接。
二零二一年七月二日更新了 Webex 重新品牌的產品名稱。
2021 年 6 月 18 日更新了圖形中的 Webex 標誌。
2021 年 6 月 8 日在「一般使用者錯誤代碼」表格中新增建議的動作欄。
二零二一年六月四日更正「一般使用者錯誤代碼」 表格。
二零二一年五月十九日新增網域索償問題區段。
2021 年 4 月 22 日使用兩個額外的代碼更新了一般使用者錯誤代碼:200016 和 200054。
二零二一年四月十三日新增 Webex 可維修性連線的資訊。
二零二零年十二月八日更新文件。 將 Webex 團隊重新命名為 Webex(應用程式)。 添加了一般使用者錯誤 代碼。
二零二零年十一月三日添加了通話設置網頁視圖。
2020 年 10 月 22 日新文件介紹。
本文是否有幫助?
本文是否有幫助?