Os conectores de gateway são pequenos aplicativos executados no GuestShell do gateway 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 são instalados no contêiner Cisco IOS XE GuestShell.

Existem dois tipos de conectores:

• Conector de gerenciamento

• Conector de telemetria

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

O conector de gerenciamento cuida do registro do gateway e do gerenciamento do ciclo de vida do conector de telemetria.

Após a conclusão bem-sucedida do registro, 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 portas virtuais — necessário para configuração do guestshell.

• Concha de hóspedes

• NETCONF Yang

• Configuração de interceptação 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 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 seu roteador para uso com um aplicativo de conector:

• O iOS XE usa proxy ARP para rotear o tráfego para o shell convidado. Não configure o comando no ip proxy-arp para desabilitar esse recurso.

• Não use a Network Address Translation (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 um registro de gateway:

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

• Endereço IP, nome de usuário e senha para os 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 Cisco Software Research. Pesquise a plataforma e selecione um dos lançamentos sugeridos.

• 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 2.000 MB de espaço livre. Além disso, o bootflash deve ter 50 MB de espaço livre. Ele é usado para armazenar os logs e arquivos RPM.

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

Se o bootflash do seu roteador tiver 4 GB e houver menos de 2 GB de capacidade disponível (a capacidade mínima), exclua todas as imagens binárias do IOS (.bin), exceto aquela 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 inicializar a partir 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 instruçã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, useshow version para verificar se o roteador inicializou a partir de bootflash:/image/packages.conf. Se for assim:

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

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

   3. Exclua todas as imagens principais usando.delete /f /r bootflash:/core/*

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

   5. Se ainda não houver espaço em disco suficiente, revise os arquivos restantes no bootflash: e exclua quaisquer outros arquivos não essenciais, como logs 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 está configurado para resolver nomes de domínio público.

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

    • servidor de nomes 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 para que o conector acesse o gateway por meio de sua interface NETCONF.

    Para autenticar e autorizar o acesso NETCONF, certifique-se de que as listas aaa padrão estejam configuradas conforme ilustrado no exemplo a seguir. Somente os comandos listados neste documento foram validados e são suportados para Gateways Gerenciados. Configurações envolvendo outros métodos (por exemplo, TACACS ou ISE) não foram validadas e não são suportadas atualmente.

    
    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 escolhida para conectividade externa. Pode ser um endereço de rede privada, mas deve ter acesso HTTPS à internet.

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

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

  • URLs para serviços Webex:

    • *.ucmgmt.cisco.com

    • *.webex.com

    • *.wbx2.com

  • Protocolos de transporte: Transport Layer Security (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 Managed Gateway.

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

Administração Local do Conector de Gestão

Você pode usar o Webex Calling com seu gateway após instalar o conector com sucesso. Se necessário, você pode atualizar uma série de configurações do conector usando as opções disponíveis no menu de 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 opção de menu s: Display Status Page. O sistema exibe o status de diferentes módulos de conectores.

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

Habilitar Guestshell

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

Desativar Guestshell

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

Desinstalar conector

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

Coletar registros

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

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

A seguir, 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 log no dispositivo usando a opção de menu r: Clear Logs. Isso exclui todos os logs existentes, exceto os logs 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 de nuvem usando a opção de menu 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

Atualizar credenciais do Gateway

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

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 opção de menu 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

Atualizar 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 sua chave de verificação de pacote, carregue o novo arquivo gateway-webex-connectors.gpg para bootflash:/gateway_connector/ e use a opção de menu k: Update Connector Package Verification Key para verificar.

Modificar o nível de log 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 instância de gateway:

1. Inicie sessão no Control Hub.

2. Vá para SERVIÇOS, clique em Chamadase, em seguida, clique em Gateways Gerenciados.

3. Para a instância de gateway aplicável, clique em … na coluna Ações e selecione a ação aplicável.