将您的 Cisco IOS 网关注册到控制中心，有助于简化设备管理，并允许您使用新的 Webex 通话服务。由于网关与控制中心保持连接，您可以从任何地方管理和监控它们，以及您的其他 Webex Calling 设备。要注册网关，您必须安装管理连接器应用程序，并确保与 Cisco Webex 云建立安全连接。建立连接后，您可以通过登录控制中心来注册网关。

此过程不适用于 Cisco IOS 语音网关，例如 VG400，它作为控制中心中的设备进行完全管理。

一个名为 GuestShell 的小型连接器应用程序负责建立和维护从网关到控制中心的连接。GuestShell 和连接器应用程序是使用脚本进行配置和设置的，该脚本在注册过程中从 Webex 云在网关上运行。

为了简化安装过程，该脚本添加了一些必要的网关配置。

网关连接器是在网关 GuestShell 中运行的小型应用程序，用于维护与控制中心的连接、协调事件和收集状态信息。有关 GuestShell 的更多信息，请参阅 GuestShell。

网关连接器安装在 Cisco IOS XE GuestShell 容器上。

连接器有两种类型：

• 管理连接器

• 遥测连接器

交互式菜单驱动的 TCL 脚本有助于设置 GuestShell，以及安装和维护管理连接器。

管理连接器负责网关注册和遥测连接器的生命周期管理。

注册成功后，管理连接器会下载并安装最新的遥测连接器。

下图展示了 Webex Calling 解决方案中各个组件的连接方式：

在执行 TCL 脚本时，会从用户收集以下信息：

• 外部接口

• DNS 服务器地址

• 代理详情

• 连接器 IP 地址

• 网关凭证（用户名和密码）

TCL脚本执行以下配置：

• 虚拟端口组——配置客户机 shell 所必需。

• Guestshell

• NETCONF Yang

• SNMP Trap 配置——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 将流量路由到客户机 shell。不要配置 no ip proxy-arp 命令来禁用此功能。

• 请勿在配置为 Cisco Unified Border Element (CUBE) 的平台上使用网络地址转换 (NAT)。因此，请为连接器应用程序配置一个可路由的 IP 地址。也就是说，它不能共享路由器接口地址。

请准备好您的设备以进行网关注册：

• 以组织管理员身份访问控制中心

• 您要配置的设备的 IP 地址、用户名和密码。

• Cisco IOS XE 版本：

  • 本地网关 - Cisco IOS XE Bengaluru 17.12.3 或更高版本

  • 生存性网关—Cisco IOS XE Dublin 17.12.3 或更高版本

  有关推荐版本，请参阅 Cisco 软件研究。搜索平台并选择 建议的 版本之一。

• 系统先决条件

  • 最低可用内存：256 MB

  • 最小磁盘空间——连接到网关用于连接器安装的硬盘（SSD）必须有 2000MB 的可用空间。此外，bootflash 必须有 50MB 的可用空间。它用于存储日志和 RPM 文件。

    如果网关未连接硬盘，则使用 bootflash 进行连接器安装。那么，bootflash 必须有 2000MB 的可用空间。

如果您的路由器启动闪存为 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 文件。

• 一台受支持的思科路由器，连接到一个可以访问互联网的网络。基本配置必须包含以下内容：

  • 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 地址必须与用于外部连接的网络位于同一网络中。它可以是私有网络地址，但必须能够通过 HTTPS 访问互联网。

    如果您使用 Amazon Web Services (AWS) 上的 Virtual CUBE 作为本地网关，请参阅 为 AWS 上的 Virtual CUBE 关联辅助 IP 地址 以了解如何为连接器使用关联辅助 IP 地址的步骤。

  • 连接到控制中心和本地设备以完成注册过程。

  • Webex 服务的网址：

    • *.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 

启用 Guest Shell

使用 e: Enable Guestshell 菜单选项启用云连接器。这将连接器的状态从 INACTIVE 更改为 ACTIVE。

禁用 Guest Shell

使用 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. 前往 服务 > PSTN & 路由 > 网关配置 > 管理网关

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