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 unnumber 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 emergências logging snmp-trap alertas logging snmp-trap erros de logging snmp-trap avisos logging snmp-trap notificações de logging snmp-trap! ! snmp-server community snteway-Webex-Cloud RO snmp-server habilitar armadilhas 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 configure no ip proxy-arp comand 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 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 obter as versões recomendadas, consulte Cisco Software Research . Procure a plataforma e selecione uma das versões Suggested .

• 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. Crie um novo diretório usando mkdir bootflash:/image .

2. Expanda a imagem binária do IOS usando pacote de software da plataforma de solicitação expanda o arquivo bootflash:/.bin para bootflash:/image .

3. No modo de configuração, remova as opções de inicialização atuais usando nenhum sistema de inicialização .

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 do bootflash:/image/packages.conf . Se sim:

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

   2. Exclua a imagem binária IOS restante.

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

   4. Exclua os 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 IP-servidor

  • 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 autenticação login rádio padrão local aaa autorização exec raio padrão local se autenticado nome de usuário privilégio 15 segredo <senha> 

  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.

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

    URL de importação de trustpool de criptografia pki https://www.cisco.com/security/pki/trs/ios.p7b

 =============================================================== Instalação do conector de gateway =============================================================== Webex Escolha a interface externa na lista abaixo de interfaces disponíveis: =============================================================== Status do endereço IP da interface de número ===============================================================      1 GigabitEthernet1 10.65.125.142 até =============================================================== Insira um número para escolher a interface externa: 1 

 Essas configurações DNS foram detectadas na configuração do gateway:  72.163.128.140 Deseja usar essas configurações para o conector? [Y/n]: 

 Essas configurações DNS foram detectadas na configuração do gateway: 72.163.128.140 Deseja usar essas configurações para o conector? [Y/n]: n 

 Essas configurações de proxy foram detectadas na configuração do gateway:  Servidor proxy: Porta de proxy-wsa.esl.cisco.com: 80 Deseja usar essas configurações para o conector? [Y/n]: 

 As Armadilhas SNMP para mensagens syslog são configuradas no nível de  e serão alteradas para o nível de  a fim de enviar notificações para a nuvem Webex. Confirme se está tudo bem para continuar?:  [Y/n]: 

 Insira o endereço IP do conector: 10.65.125.227 

 Insira o nome de usuário do Gateway:  lab  Digite a senha do gateway: *** Confirmar senha do gateway: ***

 =============================================================== O conector de gateway gerenciado =============================================================== Webex =============================================================== *** ------------------------------------------------------- *** Status da interface *** ------------------------------------------------------- Status da interface IP-Address Status ------------------------------------------------------- GigabitEthernet1 10.65.125.142 up VirtualPortGroup0 10.65.125.142 up Conector 10.65.125.188 up ------------------------------------------------------- *** Status do aplicativo *** ------------------------------------------------------- Status do serviço Guestshell RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Selecione a opção h para o menu inicial ou q para sair: 

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 .

 =============================================================== Opções do conector de gateway gerenciado =============================================================== Webex: Exibir página de status v: Exibir e modificar configurações do conector de nuvem e: Ative o Guestshell d: Desative o Guestshell l: Coletar registros r: Limpar registros u : Desinstalar o conector q: Sair =============================================================== Selecione uma opção no menu:

Status de exibição

Use os s: Exibir a opção de menu Página de status . O sistema exibe o status de diferentes módulos do conector.

 =============================================================== Webex Managed Gateway Connector =============================================================== ------------------------------------------------------- *** Status da interface *** ------------------------------------------------------- Status do IP da interface ------------------------------------------------------- GigabitEthernet1 10.123.221.224 up Connector 10.123.221.223 up ------------------------------------------------------- *** Status do aplicativo *** ------------------------------------------------------- Status do serviço Guestshell ------------------------------------------------------- RUNNING Management Connector RUNNING ------------------------------------------------------- =============================================================== Selecione a opção h para o menu inicial ou q para sair: q 

Ativar Guestshell

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

Desativar Guestshell

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

Desinstalar conector

Desinstale o conector de nuvem usando o u: Desinstale a opção de menu Conector . 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: Coletar 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/ scp://:@cxd.cisco.com .

O seguinte é um exemplo de comando:

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

Limpar registros

Limpe todos os arquivos de registro no dispositivo usando o r: Limpar 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 de nuvem usando o v: Exibir e modificar configurações do conector de nuvem opção de menu.

 =============================================================== Versão do script do conector de gateway =============================================================== gerenciado Webex: 2.0.2 Nome do host/Endereço IP: Servidor(es) DNS 10.65.125.188: Nome de usuário do gateway 10.64.86.70: Interface externa de laboratório: Nome do host/Endereço IP de proxy GigabitEthernet1: proxy-wsa.esl.cisco.com:80 =============================================================== Opções c:  Atualizar credenciais do gateway e:  Atualizar interface externa p:  Atualizar detalhes do proxy n:  Atualizar servidor DNS k:  Atualizar a chave de verificação do pacote do conector l:  Modificar o nível de registro do Cloud Connector h:  Vá para o menu inicial q:  Sair =============================================================== Selecione uma opção no menu: c

Atualizar credenciais do gateway

Atualize o nome de usuário e a senha do gateway usando o c: Atualizar credenciais de gateway 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: Exibir e modificar configurações do conector de nuvem opção de menu.

Atualizar detalhes do proxy

Você pode executar as seguintes tarefas usando o p: Atualizar detalhes do proxy opção de menu:

• i: Atualizar IP e porta do proxy

• c: Atualizar credenciais de proxy

• r: Remover credenciais de proxy

• a: Remover todos os detalhes do proxy

• h: Ir para o menu inicial

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 chave de verificação do seu pacote, carregue o novo arquivo gateway-webex-connectors.gpg para bootflash:/gateway_connector/ e use o k: Atualize a opção de menu chave de verificação do pacote do conector para verificar.

Modificar o nível de registro do conector de gerenciamento

Altere o nível de registro do conector usando o l: Modifique o nível de registro para a opção de menu Conector em nuvem e, em seguida, selecione uma das seguintes opções:

 Nível ===================================== de log de número =====================================    1 DEPURAÇÃO     2 INFORÇÕES     3 AVISO     4 ERRO     5 críticos ====================================== 

Para gerenciar sua instância de gateway:

1. Inicie sessão no Control Hub.

2. Vá para SERVICES , clique em Chamadas e, em seguida, clique em Gateways gerenciados .

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