Implante o Yang Suite e teste o XPath no Catalyst 9800 WLC

Introdução

Este documento descreve como implantar o Yang Suite no ambiente Python e testar o XPath no Cisco Catalyst 9800 WLC.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

- Configuração do Catalyst 9800 WLC

- Conhecimento básico de Python e ambientes virtuais

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Cisco Catalyst9800 WLC Cisco IOS® XE versão 17.15.3

• Microsoft Windows 11 Enterprise com Python 3.8.2 instalado

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configurar

Etapa 1. Instale o Python no PC Windows.

Baixe e instale o Python 3.8.2 para Windows.

Link de download: Versões Python para Windows

Explicação:
Python é necessário para executar o YANG Suite. A versão 3.8.2 é usada aqui para compatibilidade.

Etapa 2. Verificar a instalação do Python e do PIP.

Após a instalação, confirme se o Python e o PIP estão funcionando corretamente.

Comandos:

C:\Users\Administrator>python --version
C:\Users\Administrator>pip --version

Resultado esperado (exemplo):

C:\Users\Administrator>python --version
Python 3.8.2

C:\Users\Administrator>pip --version
pip 25.0.1 from c:\users\administrator\appdata\local\programs\python\python38-32\lib\site-packages\pip (python 3.8)

Etapa 3. Atualize o PIP para a versão mais recente para garantir a compatibilidade com o YANG Suite.

Comando:

C:\Users\Administrator>python -m pip install --upgrade pip

Explicação:
Este comando desinstala a versão antiga do PIP e instala a mais recente para garantir a compatibilidade com o YANG Suite.
Resultado esperado (exemplo):
- A versão antiga (por exemplo, pip 19.2.3) é desinstalada.
- A nova versão (por exemplo, pip 25.0.1) foi instalada com êxito.

Etapa 4. Crie um ambiente virtual para manter as dependências isoladas do Python do sistema.

Comando:

C:\Users\Administrator>python -m venv yangsuitevenv

Resultado esperado:
Uma nova pasta chamada yangsuitevenv é criada no seu computador C:\Users\Administrator.

Etapa 5. Ativar o ambiente virtual.

Ative o ambiente antes de instalar pacotes.

Comando:

C:\Users\Administrator>.\yangsuitevenv\Scripts\activate

Resultado esperado:
O prompt de comando é alterado para mostrar o ambiente ativo, por exemplo:

(yangsuitevenv) C:\Users\Administrator>

Etapa 6. Instale o YANG Suite.

Instale o YANG Suite e seus módulos necessários para garantir que o YANG Suite e suas dependências sejam instalados sem erros.

Comando:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core]

Se você encontrar erros de proxy:

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProxyError('Your proxy appears to only use HTTP and not HTTPS, try changing your proxy URL to be HTTP. See: https://xxx.xxx.xx/en/1.26.x/advanced-usage.html#https-proxy-error-http-proxy', SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1108)')))': /simple/yangsuite/

Verifique a conectividade de rede ou o proxy. Se o seu ambiente exigir o uso de um proxy, use este comando:

Comando:

(yangsuitevenv) C:\Users\Administrator>pip install yangsuite[core] --proxy http://x.x.x.x:port

Etapa 7. Atualizar os módulos do YANG Suite.

Atualize todos os módulos do YANG Suite para garantir a funcionalidade total.

Comando:

pip3 install --upgrade yangsuite yangsuite-devices yangsuite-filemanager yangsuite-yangtree yangsuite-coverage yangsuite-gnmi yangsuite-grpc-telemetry yangsuite-netconf yangsuite-restconf

Explicação:
Esta etapa garante que o YANG Suite tenha os plug-ins mais recentes para NETCONF, RESTCONF, gNMI e telemetria.

Etapa 8. Inicialize o YANG Suite.

Execute o processo de inicialização para entrar no modo de configuração interativa.

Comando:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Etapa 9. Configurar as definições do conjunto YANG.

Durante a inicialização, você é solicitado a configurar a porta de serviço, o nome do host, o nome de usuário e a senha :

Crie uma pasta chamada yangsuitespecdata para armazenar os dados específicos do usuário (módulos YANG, perfis de dispositivo e assim por diante).

Número da porta de serviço: o padrão é 8480.

Nome do host: recomendado usar localhost ou 127.0.0.1.

Salvar configurações: confirme com y.

Criar nome de usuário e senha: para acessar a IU da Web do YANG Suite.

Resultado esperado:
A configuração é salva e os serviços podem ser iniciados com o comando yangsuite:

(yangsuitevenv) C:\Users\Administrator>yangsuite

Etapa 10. Efetue login no Yang Suite através do navegador: http://localhost:8480/ para acessar o Cisco Yang Suite:

Verificar

Etapa 1. Configurar o Catalyst 9800 WLC.

Certifique-se de que o status Netconf Yang e a porta SSH estejam ativados no WLC.

Navegue para WLC > Administration > Management > HTTP/HTTPS/Netconf/VTY para ativar o Netconf Yang Configuration Status e habilitar a Porta SSH 830.

Configuração de CLI:

9800(config)#netconf-yang

Defina as configurações de AAA.

Configuração de CLI:

9800(config)#aaa authentication login default local
9800(config)#aaa authorization exec default local

Etapa 2. Adicionar a WLC ao conjunto YANG.

No YANG Suite, navegue para Setup > Device Profiles > Create New Device.

 Insira o Nome do perfil, o endereço IP da WLC, o nome de usuário e a senha.

Ative o netconf clicando em O dispositivo suporta NETCONF e clicando em Ignorar validação de chave SSH para este dispositivo.

Ative o Restconf clicando em O dispositivo suporta RESTCONF e limpe a URL base RESTCONF padrão para esvaziar.

Ative o SSH clicando em Device permite o login do SSH e verifique as informações do WLC.

Etapa 3. Verifique a acessibilidade do dispositivo.

Clique em Check seleted device’s reachability e selecionou o perfil do dispositivo para verificar se a WLC pode ser acessada a partir do YANG Suite.

Etapa 4. Crie um Repositório de Suítes YANG.

Crie um repositório para armazenar os modelos YANG de WLC necessários.

Selecione NETCONF e Select device profile para Get schema List para baixar todos os esquemas do WLC

Etapa 5. Crie um Novo módulo YANG definido para o repositório de arquivos YANG associado.

Por exemplo, se as informações sem fio dos modelos YANG específicos do Catalyst 9800 forem necessárias, insira wireless para escolher todos os módulos e clique em Add seleted.

Se precisar de mais do que apenas componentes sem fio, basta clicar em Adicionar repositório inteiro nesta etapa. 

Se você adicionar apenas os módulos sem fio, também haverá um botão chamado Localizar e adicionar dependências ausentes. Clicar nele automaticamente trará todos os módulos adicionais exigidos pelo módulo sem fio.

Etapa 6. Testar consultas XPath.

Use o XPath fornecido pelo YANG Suite para obter dados do WLC.

Obtenha o XPath necessário no YANG Suite.

Aqui você vê o nome da interface de gerenciamento do controlador como um exemplo.

Configurar o ietf de telemetria na CLI da WLC

C9800(config)#telemetry ietf subscription <subscription-id>
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath <xpath-expression>
C9800(config-mdt-subs)#source-address <wlc-ip>
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic <interval-in-centiseconds>
C9800(config-mdt-subs)#receiver ip address <collector-ip> <collector-port> protocol grpc-tcp

Por exemplo:

C9800(config)#telemetry ietf subscription 104
C9800(config-mdt-subs)#encoding encode-kvgpb
C9800(config-mdt-subs)#filter xpath /general-oper-data/mgmt-intf-data/intf-name
C9800(config-mdt-subs)#source-address 10.124.38.111
C9800(config-mdt-subs)#stream yang-push
C9800(config-mdt-subs)#update-policy periodic 2500
C9800(config-mdt-subs)#receiver ip address 10.124.41.144 18800 protocol grpc-tcp

Habilite o monitoramento na telemetria gRPC para obter os dados necessários enviados pela WLC.

Informações Relacionadas

• Guia de implantação de telemetria e programabilidade do Catalyst 9800
• Bem-vindo ao Cisco YANG Suite!
• Comunidade Cisco para DevNet