Inscreva os gateways gerenciados pelo Cisco IOS no Webex Cloud

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

Os conectores de gateway estão instalados no contêiner 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 do 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 do guestshell.

• Concha de Guestshell

• NETCONF Yang

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

• Rota IP — Para rotear 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 do roteador de serviços integrados da Cisco 1100
• Plataformas configuradas no modo de alta disponibilidade (HA)
• Plataformas configuradas no modo Controller para redes SD-WAN

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

• O IOS XE usa ARP proxy para encaminhar o tráfego para o shell do convidado. Não desative este recurso configurando sem proxy IP ...
• Não use a Tradução de endereços de rede (NAT) em plataformas configuradas para o CUBE. Portanto, configure o aplicativo 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:

• Acesso ao Control Hub como administrador da organização

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

• Versão do Cisco IOS XE:

  • 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 a página Cisco Software Research . Procure a plataforma e selecione uma das versões "Sugeridas".

• Pré-requisitos do sistema

  • Memória mínima livre — 256 MB

  • Espaço mínimo em disco — O disco rígido (SSD) conectado ao gateway usado para instalação do conector deve ter espaço livre de 2000 MB. 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 a instalação do conector. Em seguida, o bootflash deve ter espaço livre de 2000 MB.

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

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

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

2. Expanda a imagem binária do IOS usando request platform software package expand file bootflash:/<image>.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. Se sim:

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

   2. Exclua a imagem binária IOS restante.

   3. Excluir quaisquer imagens principais usando delete /f /r bootflash:/core/*.

   4. Excluir arquivos de registro de rastreamento usando delete /f /r bootflash:/tracelogs/*.

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

• Um roteador Cisco compatível, que é 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:

    • nome-servidor ip <IP address="">

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

  • Credenciais do gateway: Credenciais (nome de usuário e senha) com acesso de nível 15 de privilégio que o conector pode usar para acessar o gateway por meio de sua interface NETCONF.

    Para autenticar e autorizar o acesso NETCONF, certifique-se de que as listas aaa padrão sejam configuradas conforme ilustrado no exemplo. Você pode usar qualquer opção de método na lista padrão. Você não pode usar uma lista aaa nomeada para controlar o acesso 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.

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

  Pré-requisitos de rede

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

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

  • Você deve estar conectado ao Control Hub e aos dispositivos locais para concluir o processo de registro.

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

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 à nuvem do Cisco Webex.
Offline	Indica que o conector Não está conectado à nuvem do Cisco Webex.
Pausado	Indica que o conector está conectado, mas é Paused 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 do script:

Você pode reiniciar 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 do 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 Guestshell

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

Desativar Guestshell

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

Desinstalar conector

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

Coletar registros

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

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/<log-filename> scp://<case-number>:<cxd-token>@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

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

Exibir e modificar configurações do conector de nuvem

Faça as seguintes alterações nas configurações existentes de um conector em nuvem usando o 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 o 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 o v: View and Modify Cloud Connector Settings opção de menu.

Atualizar detalhes do proxy

Você pode executar as seguintes tarefas usando o 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 chave de verificação do pacote do conector

Se você tiver um problema técnico e for solicitado pelo engenheiro de suporte para substituir a chave de verificação do pacote, carregue o novo gateway-webex-connectors.gpg arquivo a bootflash:/gateway_connector/ e use o 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 o l: Modify log level for Cloud Connector opção de menu e, em seguida, selecione uma das seguintes opções:

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

Para gerenciar sua instância de gateway:

1. Em SERVICES , clique em Chamadas e, em seguida, clique na guia Gateways gerenciados.

2. Para a instância de gateway aplicável, clique nos pontos adjacentes (…) na coluna Ações e selecione a ação aplicável.