網關連接器是在網關 GuestShell 中運行的小型應用程序，用於維持與控制中心的連接、協調事件和收集狀態資訊。有關 GuestShell 的更多信息，請參閱 GuestShell。

網關連接器安裝在 Cisco IOS XE GuestShell 容器上。

連接器有兩種類型：

• 管理連接器

• 遙測連接器

互動式選單驅動的 TCL 腳本有助於設定 GuestShell，以及管理連接器的安裝和維護。

管理連接器負責遙測連接器的網關註冊和生命週期管理。

成功完成註冊後，管理連接器將下載並安裝最新的遙測連接器。

下圖顯示了 Webex Calling 解決方案中不同元件的連接方式：

作為 TCL 腳本執行的一部分，將從使用者收集以下資訊：

• 外部介面

• DNS 伺服器位址

• 代理詳細信息

• 連接器 IP 位址

• 網關憑證（使用者名稱和密碼）

TCL腳本執行以下配置：

• 虛擬連接埠群組——Guestshell 配置所需。

• 蓋斯特爾

• NETCONF楊

• SNMP 陷阱設定 - Cisco IOS XE 通知所需。

• IP 路由 - 透過虛擬連接埠群組路由連接器相關的流量。

TCL腳本執行以下配置：

!
interface VirtualPortGroup 0
 ip unnumbered GigabitEthernet1
 no mop enabled
 no mop sysid
!

!
app-hosting appid guestshell
 app-vnic gateway0 virtualportgroup 0 guest-interface 0
  guest-ipaddress 10.65.125.227 netmask 255.255.255.128
 app-default-gateway 10.65.125.142 guest-interface 0
 app-resource profile custom
  cpu 800
  memory 256
  persist-disk 500
 name-server0 72.163.128.140
 name-server1 8.8.8.8
!

!
netconf-yang
netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1
netconf-yang cisco-ia snmp-community-string Gateway-Webex-Cloud
!

!
logging snmp-trap emergencies
logging snmp-trap alerts
logging snmp-trap critical
logging snmp-trap errors
logging snmp-trap warnings
logging snmp-trap notifications
!

!
snmp-server community Gateway-Webex-Cloud RO
snmp-server enable traps syslog
snmp-server manager
!

!
ip route 10.65.125.227 255.255.255.255 VirtualPortGroup0
!
 

在安裝之前，請考慮連接器應用程式不能與以下應用程式一起使用：

• Cisco 1100 整合式服務路由器平台
• 以高可用性 (HA) 模式配置的平台
• 為 SD-WAN 網路配置控制器模式的平台

設定路由器以與連接器應用程式一起使用時，請考慮以下事項：

• IOS XE 使用代理 ARP 將流量路由到客戶機外殼。不要設定 no ip proxy-arp 指令來停用此功能。

• 請勿在為 Cisco Unified Border Element (CUBE) 配置的平台上使用網路位址轉換 (NAT)。因此，使用可路由的 IP 位址設定連接器應用程式。也就是說，它不能共用路由器介面位址。

準備設備以進行網關註冊：

• 以組織管理員身分存取控制中心

• 您要設定的設備的 IP 位址、使用者名稱和密碼。

• Cisco IOS XE 版本：

  • 本地網關 - Cisco IOS XE Bengaluru 17.6.1a 或更高版本

  • 生存性閘道 - Cisco IOS XE Dublin 17.12.3 或更高版本

  建議的版本，請參閱 Cisco Software Research。搜尋平台並選擇 建議的 版本之一。

• 系統先決條件

  • 最小可用記憶體 - 256 MB

  • 最小磁碟空間 — 用於安裝連接器的閘道器所連接的硬碟 (SSD) 必須有 2000MB 的可用空間。此外，Bootflash 必須有 50MB 的可用空間。它用於存儲日誌和 RPM 文件。

    如果網關未連接硬碟，則使用 Bootflash 來安裝連接器。然後，Bootflash 必須有 2000MB 的可用空間。

如果您的路由器的 bootflash 為 4GB，且可用容量（最小容量）小於 2GB，請刪除目前正在執行的 IOS 二進位（.bin）映像之外的所有 IOS 二進位（.bin）映像。刪除檔案後，釋放額外的空間。

使用以下步驟擴展二進位映像並從元件啟動：

1. 使用建立一個新目錄。mkdir bootflash:/image

2. 使用下列方法擴充 IOS 二進位映像。request platform software package expand file bootflash:/.bin to bootflash:/image

3. 在配置模式下，使用以下命令刪除目前啟動選項。no boot system

4. 配置新的啟動語句：boot system bootflash:/image/packages.conf.

5. 退出配置模式，儲存配置並重新啟動。

6. 路由器重新啟動後，使用show version 驗證路由器是否從 bootflash:/image/packages.conf啟動。如果是這樣：

   1. 驗證 bootflash:/sysboot 目錄是否為空。

   2. 刪除剩餘的 IOS 二進位映像。

   3. 刪除所有使用的核心影像。delete /f /r bootflash:/core/*

   4. 使用刪除追蹤日誌檔。delete /f /r bootflash:/tracelogs/*

   5. 如果磁碟空間仍然不足，請查看 Bootflash 中的剩餘檔案：並刪除任何其他不必要的文件，例如日誌和 CDR。

• 支援的 Cisco 路由器，連接到具有網際網路路徑的網路。基本配置必須具備以下內容：

  • DNS伺服器用於解析公網網域名稱。

  • 若要設定 DNS 伺服器，請使用下列命令：

    • IP 名稱伺服器 <IP address>

  • 如果您想透過代理程式存取互聯網，請使用 HTTP 代理伺服器。

  • 網關憑證：連接器需要具有權限等級 15 存取的本機憑證（使用者名稱和密碼）才能透過其 NETCONF 介面存取網關。

    若要驗證和授權 NETCONF 訪問，請確保按照以下範例所示配置預設 aaa 清單。僅本文檔中列出的命令已驗證並支援託管網關。涉及其他方法（例如 TACACS 或 ISE）的設定尚未經過驗證，目前不受支援。

    
    aaa new-model
    aaa authentication login default local
    aaa authorization exec default local if-authenticated
    username test privilege 15 secret 
    

  網路前提條件

  • 連接器 IP 位址必須與選擇用於外部連接的 IP 位址位於同一網路中。它可以是私人網路位址，但必須具有互聯網的 HTTPS 存取權限。

    如果您使用 Amazon Web Services (AWS) 上的虛擬 CUBE 作為本機網關，請參閱 為 AWS 上的虛擬 CUBE 關聯輔助 IP 位址 ，以了解如何關聯輔助 IP 位址以供連接器使用的步驟。

  • 連接到控制中心和本地設備以完成註冊程序。

  • Webex 服務的 URL：

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • 傳輸協定：傳輸層安全性 (TLS) 版本 1.2

  • 導入 IOS 公共憑證授權單位包。新增至網關信任池的憑證用於驗證對 Webex 伺服器的存取。使用以下配置命令導入該包。

    crypto pki trustpool import url https://www.cisco.com/security/pki/trs/ios.p7b

 ===============================================================
             Webex Gateway Connector Installation
 ===============================================================


 Choose the external-interface from the below list of available interfaces:
 ===============================================================
   Number          Interface          IP-Address        Status
 ===============================================================
     1          GigabitEthernet1      10.65.125.142       up    
 ===============================================================

 Enter a number to choose the external interface: 1

These DNS settings were detected in the gateway configuration:
 72.163.128.140 
Do you want to use these settings for the connector? [Y/n]: 

These DNS settings were detected in the gateway configuration:
72.163.128.140
Do you want to use these settings for the connector? [Y/n]: n

These proxy settings were detected in the gateway configuration:
 Proxy Server : proxy-wsa.esl.cisco.com
 Proxy Port   : 80
Do you want to use these settings for the connector? [Y/n]: 

SNMP Traps for syslog messages are
configured at  level and they would be changed to 
level in order to push notifications to the Webex Cloud.
Please confirm if it is ok to proceed?:  [Y/n]: 

 Enter Connector IP address: 10.65.125.227

Enter Gateway username: lab
Enter Gateway password: ***
Confirm Gateway password: ***

===============================================================
                 Webex Managed Gateway Connector
===============================================================

  *** Cloud connector is installed successfully. ***
-------------------------------------------------------
         *** Interface Status ***
-------------------------------------------------------
   Interface               IP-Address          Status
-------------------------------------------------------
   GigabitEthernet1        10.65.125.142       up    
   VirtualPortGroup0       10.65.125.142       up    
   Connector               10.65.125.188       up
   
-------------------------------------------------------

          *** App Status ***
-------------------------------------------------------
 Service                 Status
-------------------------------------------------------
 Guestshell              RUNNING
 Management Connector    RUNNING
-------------------------------------------------------

===============================================================
 Select option h for home menu or q to quit: 

控制中心中顯示的連接器的整體狀態取決於託管網關上的遙測和管理連接器的狀態。

控制中心中的連接器狀態	說明
線上	表示連接器已 連接 到 Cisco Webex 雲端。
離線	表示連接器 未連接 到 Cisco Webex 雲端。
已暫停	表示連接器已連接，但暫時 暫停 。

管理連接器的本機管理

成功安裝連接器後，您可以將 Webex Calling 與網關一起使用。如果需要，您可以使用腳本選單中提供的選項更新多個連接器設定：

您可以隨時使用以下命令重新啟動腳本：tclsh bootflash:/gateway_connector/gateway_onboarding.tcl.

===============================================================
Webex Managed Gateway Connector
===============================================================
Options
s : Display Status Page
v : View and Modify Cloud Connector Settings
e : Enable Guestshell
d : Disable Guestshell
l : Collect Logs
r : Clear Logs
u : Uninstall Connector
q : Quit
===============================================================
Select an option from the menu:

顯示狀態

使用 s: Display Status Page 選單選項。系統顯示不同連接器模組的狀態。

===============================================================
                 Webex Managed Gateway Connector
===============================================================
     -------------------------------------------------------
                     *** Interface Status ***
     -------------------------------------------------------
       Interface               IP-Address          Status
     -------------------------------------------------------
       GigabitEthernet1        10.123.221.224        up    
       Connector               10.123.221.223        up
     -------------------------------------------------------
                       *** App Status ***
     -------------------------------------------------------
		Service                   Status
     -------------------------------------------------------
            Guestshell                  RUNNING
            Management Connector        RUNNING
     -------------------------------------------------------
===============================================================
          Select option h for home menu or q to quit: q 

啟用 Guestshell

使用 e: Enable Guestshell 選單選項啟用雲端連接器。這會將連接器的狀態從 INACTIVE 變更為 ACTIVE。

禁用 Guestshell

使用 d: Disable Guestshell 選單選項可停用雲端連接器。這會將連接器的狀態從 ACTIVE 變更為 INACTIVE。

解除安裝連接器

使用 u: Uninstall Connector 選單選項卸載雲端連接器。這將刪除 Guestshell 容器中的所有資料並刪除與雲端連接器相關的所有配置。

收集日誌

使用 l: Collect Logs 選單選項收集日誌。系統收集日誌後會顯示這些日誌的儲存位置。

如果您有 Cisco TAC 的有效支援案例，則可以使用命令 copy bootflash:/guest-share/ scp://:@cxd.cisco.com將日誌直接附加到您的服務請求中。

以下是範例命令：

vcubeprod#copy bootflash:/guest-share/gateway_webex_cloud_logs_2022114090628.tar.gz scp://123456789:a1b2c3d4e5@cxd.cisco.com

清除日誌

使用 r: Clear Logs 選單選項清除設備中的所有日誌檔案。這將刪除除 TCL 腳本和連接器的最新日誌之外的所有現有日誌。

查看和修改雲端連接器設定

使用 v: View and Modify Cloud Connector Settings 選單選項對雲端連接器的現有設定進行以下變更。

===============================================================
                Webex Managed Gateway Connector
===============================================================
		Script Version         : 2.0.2
		Hostname/IP Addr       : 10.65.125.188
		DNS Server(s)          : 10.64.86.70
		Gateway Username       : lab
		External Interface     : GigabitEthernet1
		Proxy Hostname/IP Addr : proxy-wsa.esl.cisco.com:80
===============================================================
             Options
               c :  Update Gateway Credentials
               e :  Update External Interface
               p :  Update Proxy Details
               n :  Update DNS Server
               k :  Update Connector Package Verification Key
               l :  Modify log level for Cloud Connector
               h :  Go to home menu
               q :  Quit

===============================================================
                        Select an option from the menu: c

更新網關憑證

使用 c: Update Gateway Credentials 選單選項更新網關使用者名稱和密碼。

更新外部介面

使用 v: View and Modify Cloud Connector Settings 選單選項變更連接器綁定的介面和連接器IP位址。

更新代理詳細信息

您可以使用 p: Update Proxy Details 選單選項執行下列任務：

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

更新連接器包驗證金鑰

如果出現技術問題，支援工程師要求更換您的套件驗證金鑰，請將新的 gateway-webex-connectors.gpg 檔案上傳到 bootflash:/gateway_connector/ 並使用 k: Update Connector Package Verification Key 選單選項進行驗證。

修改管理連接器的日誌級別

使用 l: Modify log level for Cloud Connector 選單選項變更連接器的日誌記錄級別，然後選擇以下選項之一：

=====================================
  Number      Log Level 
=====================================
   1           DEBUG 
   2           INFO 
   3           WARNING 
   4           ERROR 
   5           CRITICAL 
======================================

若要管理您的網關實例：

1. 登入 Control Hub。

2. 前往 服務，按一下 呼叫，然後按一下 託管網關。

3. 對於適用的網關實例，按一下 操作 列中的 … 並選擇適用的操作。