Registrar gateways gerenciados pelo Cisco IOS no Webex Cloud

Os conectores de gateway são pequenos aplicativos executados no gateway GuestShell para manter uma conexão com o Control Hub, coordenar eventos e coletar informações de status. Para obter mais informações sobre o GuestShell, consulte GuestShell.

Os conectores de gateway estão instalados no contêiner do Cisco IOS XE GuestShell.

Existem dois tipos de conectores:

• Conector de gerenciamento

• Conector de telemetria

Um script TCL orientado por menu interativo ajuda a configurar o GuestShell, bem como a instalação e manutenção do conector de gerenciamento.

O conector de gerenciamento cuida da inscrição do gateway e do gerenciamento do ciclo de vida do conector de telemetria.

Após a conclusão bem-sucedida da inscrição, o conector de gerenciamento baixa e instala o conector de telemetria mais recente.

O gráfico a seguir mostra como os diferentes componentes se conectam em uma solução Webex Calling:

Como parte da execução do script TCL, as seguintes informações são coletadas do usuário:

• Interface externa

• Endereços de servidor DNS

• Detalhes do proxy

• Endereço IP do conector

• Credenciais do gateway (nome de usuário e senha)

O script TCL executa as seguintes configurações:

• Grupo de porta virtual — Necessário para configuração da shell guestshell.

• Predefinição: Guestshell

• NETCONF Yang

• Configuração de armadilha SNMP — Necessária para notificações do Cisco IOS XE.

• Rota IP — Para encaminhar o tráfego relacionado ao conector por meio do grupo de portas virtuais.

O script TCL executa as seguintes configurações:

!
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
!
 

Antes da instalação, considere que o aplicativo do conector não pode ser usado com o seguinte:

• Plataformas de roteador de serviços integrados Cisco 1100
• Plataformas configuradas no modo de Alta disponibilidade (HA)
• Plataformas configuradas no modo Controlador para redes SD-WAN

Considere o seguinte ao configurar o roteador para uso com um aplicativo de conector:

• O IOS XE usa proxy ARP para encaminhar o tráfego para o shell de convidado. Não configure nenhum proxy-arp ip para desativar esse recurso.

• Não use a Tradução de endereços de rede (NAT) em plataformas configuradas para um Cisco Unified Border Element (CUBE). Portanto, configure o aplicativo do conector com um endereço IP roteável. Ou seja, ele não pode compartilhar o endereço da interface do roteador.

Prepare seu dispositivo para uma inscrição de gateway:

• Acessar o Control Hub como administrador da organização

• Endereço IP, nome de usuário e senha dos dispositivos que você deseja configurar.

• Cisco IOS XE versão:

  • Gateways locais—Cisco IOS XE Bengaluru 17.6.1a ou posterior

  • Gateways de sobrevivência—Cisco IOS XE Dublin 17.12.3 ou posterior

  Para as versões recomendadas, consulte Pesquisa de software da Cisco. Procure a plataforma e selecione uma das versões Sugeridas .

• Pré-requisitos do sistema

  • Memória livre mínima — 256 MB

  • Espaço mínimo em disco — O disco rígido (SSD) conectado ao gateway usado para instalação do conector deve ter 2000 MB de espaço livre. Além disso, o bootflash deve ter 50 MB de espaço livre. Ele é usado para armazenar os registros e arquivos RPM.

    Se um disco rígido não estiver conectado ao gateway, o bootflash será usado para instalação do conector. Em seguida, o bootflash deve ter 2000 MB de espaço livre.

Se o flash de inicialização do roteador for de 4 GB e houver menos de 2 GB de capacidade disponível (a capacidade mínima), exclua todas as imagens binárias (.bin) do IOS, exceto a que está em execução no momento. Depois de excluir os arquivos, libere espaço extra.

Use as seguintes etapas para expandir a imagem binária e inicialização dos componentes:

1. Crie um novo diretório usando mkdir bootflash:/image.

2. Expanda a imagem binária do IOS usando request platform software package expand file bootflash:/.bin to bootflash:/image.

3. No modo de configuração, remova as opções de inicialização atuais usando no boot system.

4. Configure uma nova declaração de inicialização: boot system bootflash:/image/packages.conf.

5. Saia do modo de configuração, salve a configuração e reinicie.

6. Depois que o roteador for reiniciado, use show version para verificar se o roteador foi inicializado de bootflash:/image/packages.conf. Em caso afirmativo:

   1. Verifique se o bootflash:/sysboot diretório está vazio.

   2. Exclua a imagem binária restante do IOS.

   3. Exclua qualquer imagem principal usando o delete /f /r bootflash:/core/*.

   4. Exclua os arquivos de log de rastreamento usando o delete /f /r bootflash:/tracelogs/*.

   5. Se ainda não houver espaço em disco suficiente, revise os arquivos restantes no bootflash: e excluir quaisquer outros arquivos não essenciais, como registros e CDRs.

• Um roteador Cisco compatível, que está conectado a uma rede com um caminho para a Internet. A configuração básica deve ter o seguinte:

  • O servidor DNS é configurado para resolver nomes de domínio público.

  • Para configurar o servidor DNS, use o seguinte comando:

    • Servidor de nome IP <IP address>

  • Servidor proxy HTTP se você quiser acessar a Internet por meio de um proxy.

  • Credenciais do gateway: Uma credencial local (nome de usuário e senha) com acesso de nível de privilégio 15 é necessária pelo conector para acessar o gateway por meio de sua interface NETCONF.

    Para autenticar e autorizar o acesso ao NETCONF, certifique-se de que as listas AAA padrão sejam configuradas conforme ilustrado no exemplo. Você não pode usar uma lista aaa nomeada para controlar o acesso ao NETCONF. Se as listas padrão não estiverem configuradas corretamente, você poderá ver uma mensagem de erro "lista de métodos inválidos" no registro do sistema. Você pode querer usar outros métodos juntamente com o local para AAA, isso pode ser alcançado, no entanto, será necessária uma atualização específica da configuração.

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

  Pré-requisitos de rede

  • O endereço IP do conector deve estar na mesma rede que a escolhida para conectividade externa. Pode ser um endereço de rede privada, mas deve ter acesso HTTPS à Internet.

    Se você usar o CUBE virtual no Amazon Web Services (AWS) como seu Gateway local, consulte Associar um endereço IP secundário ao Virtual CUBE na AWS para obter as etapas sobre como associar um endereço IP secundário ao uso do conector.

  • Esteja conectado ao Control Hub e aos dispositivos locais para concluir o processo de inscrição.

  • URLs dos serviços Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocolos de transporte: Segurança da camada de transporte (TLS) versão 1.2

  • Importe o pacote de autoridade de certificação pública do IOS. Os certificados adicionados ao pool de confiança do gateway são usados para verificar o acesso aos servidores Webex. Use o seguinte comando de configuração para importar o pacote.

    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: 

O status geral do conector exibido no Control Hub depende do estado dos conectores de telemetria e gerenciamento no Gateway gerenciado.

Estados do conector no Control Hub	Descrição
Online	Indica que o conector está Conectado ao Cisco Webex em nuvem.
Offline	Indica que o conector Não está conectado ao Cisco Webex em nuvem.
Pausado	Indica que o conector está conectado, mas está Pausado temporariamente.

Administração local do conector de gerenciamento

Você pode usar o Webex Calling com seu gateway depois de instalar o conector com êxito. Se necessário, você pode atualizar várias configurações do conector usando as opções disponíveis no menu script:

Você pode reinicializar o script a qualquer momento usando o seguinte comando: 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:

Status de exibição

Use a s: Display Status Page opção de menu. O sistema exibe o status de diferentes módulos de conector.

===============================================================
                 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 

Ativar Consola de Teste

Habilite o conector em nuvem usando a opção de e: Enable Guestshell menu. Isso altera o status do conector de INACTIVE para ACTIVE.

Desativar Guestshell

Desative o conector em nuvem usando a d: Disable Guestshell opção de menu. Isso altera o status do conector de ACTIVE para INACTIVE.

Desinstalar o conector

Desinstale o conector em nuvem usando a opção de u: Uninstall Connector menu. Isso exclui todos os dados no recipiente Guestshell e remove todas as configurações relacionadas ao conector em nuvem.

Coletar registros

Colete os registros usando a l: Collect Logs opção de menu. O sistema exibe o local onde esses registros são armazenados após a coleta dos registros.

Se você tiver um caso de suporte ativo com o TAC da Cisco, poderá anexar os registros diretamente à sua solicitação de serviço usando o comando copy bootflash:/guest-share/ scp://:@cxd.cisco.com.

O seguinte é um exemplo de comando:

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

Limpar registros

Limpe todos os arquivos de registro no dispositivo usando a r: Clear Logs opção de menu. Isso exclui todos os registros existentes, exceto os registros mais recentes do script TCL e dos conectores.

Visualizar e modificar as configurações do Cloud Connector

Faça as seguintes alterações nas configurações existentes de um conector em nuvem usando a v: View and Modify Cloud Connector Settings opção de menu.

===============================================================
                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

Atualizar credenciais do gateway

Atualize o nome de usuário e a senha do gateway usando a c: Update Gateway Credentials opção de menu.

Atualizar interface externa

Altere a interface à qual o conector está vinculado e o endereço IP do conector usando a opção de menu v: View and Modify Cloud Connector Settings .

Atualizar detalhes do proxy

Você pode executar as seguintes tarefas usando a p: Update Proxy Details opção de menu:

• i: Update Proxy IP and Port

• c: Update Proxy Credentials

• r: Remove Proxy Credentials

• a: Remove All Proxy Details

• h: Go to home menu

Atualizar a chave de verificação do pacote do conector

No caso de um problema técnico, se o engenheiro de suporte solicitar a substituição da chave de verificação de pacotes, carregue o novo gateway-webex-connectors.gpg arquivo para bootflash:/gateway_connector/ e use a k: Update Connector Package Verification Key opção de menu para verificar.

Modificar o nível de registro do conector de gerenciamento

Altere o nível de registro do conector usando a opção de menu l: Modify log level for Cloud Connector e selecione uma das seguintes opções:

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

Para gerenciar sua ocorrência de gateway:

1. Inicie sessão no Control Hub.

2. Vá para SERVIÇOS, clique em Chamadas e, em seguida, em Gateways gerenciados.

3. Para a ocorrência do gateway aplicável, clique em na coluna de Ações e selecione a ação aplicável.