网关连接器是在网关 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. 登录到控制中心。

2. 转到 服务，单击 呼叫，然后单击 托管网关。

3. 对于适用的网关实例，单击 操作 列中的 … 并选择适用的操作。