将Cisco IOS管理的网关注册到Webex Cloud

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

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

连接器有两种类型：

• 管理连接器

• 遥测连接器

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

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

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

下图显示不同组件如何在Webex 解决方案中连接：

作为TCL脚本执行的一部分，将从用户收集以下信息：

• 外部接口

• DNS服务器地址

• 代理详细信息

• 连接器IP地址

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

TCL脚本会执行以下配置：

• 虚拟端口组-guestshell配置必需。

• 盖斯特壳

• NETCONF Yang

• 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将流量路由到来宾外壳。 请勿通过配置 来禁用此功能 ip代理-。
• 请勿在为CUBE配置的平台上使用网络地址转换(NAT)。 因此，为连接器应用程序配置一个可路由的IP地址。 也就是说，它不能共享路由器接口地址。

为网关注册准备设备：

• 以组织管理员身份访问Control Hub

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

• Cisco IOS XE版本：

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

  • 存活网关- Cisco IOS XE Dublin 17.12.3或更高版本

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

• 系统前提条件

  • 最小可用内存- 256 MB

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

    如果硬盘未连接到网关，则使用bootflash安装连接器。 然后，bootflash必须有2000MB的可用空间。

如果您的路由器的bootflash为4GB并且可用容量（最小容量）小于2GB，请删除当前正在运行的IOS二进制(。bin)映像。 删除文件后，释放额外的空间。

使用以下步骤展开二进制图像并从组件启动：

1. 使用以下方式创建新目录 mkdir bootflash:/image 。

2. 使用扩展IOS二进制图像 request platform software package expand file bootflash:/<image>.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列表。 可使用默认列表中的任何方法选项。 您不能使用已命名的aaa列表来控制NETCONF访问。 如果默认列表未正确配置，您可能会在系统日志中看到“无效方法列表”错误消息。

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

  网络前提条件

  • 连接器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 <alerts> level and they would be changed to <notifications>
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中的连接器状态	描述
Online	表示连接器 到Cisco Webex云。
离线	表示连接器 连接 到Cisco Webex云。
已暂停	表示连接器已连接，但暂时暂停。

管理连接器的本地管理

成功安装连接器后，您可以将Webex 与网关一起使用。 如果需要，您可以使用脚本菜单中的选项更新连接器设置数量：

您可以使用以下命令随时重新启动脚本： 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/<log-filename> scp://<case-number>:<cxd-token>@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设置

对云连接器的现有设置进行以下更改 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 菜单选项。

更新外部接口

更改连接器所绑定的接口和连接器IP地址 v: View and Modify Cloud Connector Settings 菜单选项。

更新代理详细信息

您可以使用以下功能 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. 对于适用的网关实例，单击“操作”列中的相邻点()，然后选择相应的操作。