閘道連接器是在閘道 GuestShell 中執行的小型應用程式，用於維護與 Control Hub 的連線、協調活動以及收集狀態資訊。如需 GuestShell 的相關資訊，請參閱GuestShell 。

閘道連接器安裝在 Cisco IOS XE GuestShell 容器上。

有兩種類型的連接器：

• 管理連接器

• 遙測連接器

互動式功能表驅動 TCL 指令碼可協助設定 GuestShell，以及安裝和維護 Management Connector。

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

成功完成註冊後，Management Connector 會下載並安裝最新的遙測連接器。

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

作為 TCL 指令檔執行的一部分，系統會從使用者處收集下列資訊：

• 外部介面

• DNS 伺服器位址

• Proxy 詳細資料

• 連接器 IP 位址

• 閘道憑證（使用者名稱和密碼）

TCL 指令碼執行下列組態：

• 虛擬通訊埠群組—guestshell 組態所需。

• 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 網路在 Controller 模式下設定的平台

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

• IOS XE 使用 Proxy ARP 將流量路由至訪客 Shell。不設定無 ip proxy-arp 指令以停用此功能。

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

準備裝置以進行閘道註冊：

• 以組織管理員身分存取 Control Hub

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

• Cisco IOS XE 版本：

  • 本機閘道 — Cisco IOS XE Bengaluru 17.6.1a 或更高版本

  • 生存能力閘道—Cisco IOS XE Dublin 17.12.3 或更高版本

  有關建議的版本，請參閱Cisco 軟體研究。搜尋平台並選取其中一個建議 版本。

• 系統先決條件

  • 最小可用記憶體 — 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 Proxy 伺服器（如果您想要透過 Proxy 連線至網際網路）。

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

    若要驗證和授權 NETCONF 存取，請確保如範例中所示設定預設 aaa 清單。您無法使用命名的 aaa 清單來控制 NETCONF 存取。如果未正確設定預設清單，您可能會在系統日誌中看到「無效的方法清單」錯誤訊息。您可能想要將其他方法與本地 AAA 一起使用，但可以實現，但是將需要特定的設定更新。

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

  網路先決條件

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

    如果您使用 Amazon Web Services (AWS) 上的虛擬 CUBE 作為本機閘道，請參閱為 AWS 上的虛擬 CUBE 關聯次要 IP 位址 以獲取有關如何關聯次要 IP 位址以供連接器使用的步驟。

  • 連線至 Control Hub 和內部部署裝置以完成註冊程序。

  • 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: 

Control Hub 中顯示的連接器的整體狀態取決於託管閘道上遙測和管理連接器的狀態。

Control Hub 中的連接器狀態	說明
線上	指示連接器已連線 至 Cisco Webex 雲端。
離線	指示連接器未連線 至 Cisco Webex 雲端。
已暫停	表示連接器已連線，但已暫停 暫時。

Management Connector 的本地管理

成功安裝連接器後，您可以將 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 指令碼和連接器的最新日誌除外。

檢視和修改 Cloud Connector 設定

使用以下命令對 Cloud Connector 的現有設定進行以下變更：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 功能表選項。

更新 Proxy 詳細資料

您可以使用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 功能表選項進行驗證。

修改 Management Connector 的日誌層級

使用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. 對於適用的閘道執行個體，按一下… 在動作 欄，然後選取適用的動作。