Configuración de NETCONF/YANG y validación del ejemplo para las plataformas Cisco IOS XE 16.x

Introducción

Este documento describe cómo configurar NETCONF/YANG en las plataformas basadas en Cisco IOS XE 16.x. El ejemplo se centra en las pruebas de laboratorio con el Catalyst 3850; sin embargo, la información proporcionada también se aplica a otras plataformas Cisco IOS XE 16.x, como los routers Cisco ASR 1000 Series.

Prerequisites

Requirements

NETCONF/YANG es compatible con el software IOS XE 16.3.1.

Nota: No se requiere experiencia previa con el scripting de NETCONF, YANG o Python para utilizar este documento.

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

En este ejemplo, se utiliza un switch WS-C3850-12X48U independiente que ejecuta Cisco IOS-XE 16.3.3 como servidor NETCONF. Este es el dispositivo que se configura y desde el cual se recopilan datos (resultado del comando show) a través de NETCONF/YANG.

Se utiliza un portátil (Apple MacBook Pro que ejecuta macOS Sierra 10.12.2 y el navegador Google Chrome) como cliente NETCONF. Actúa como la plataforma de administración centralizada utilizando la aplicación Explorador de Yang. Se trata del dispositivo que crea las solicitudes formateadas YANG que se envían al Catalyst 3850 a través de los mensajes NETCONF RPC (llamada de procedimiento remoto) para configurar y recopilar datos del Catalyst 3850.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Antecedentes

Modelos de datos: configuración y supervisión basadas en estándares y programáticos

Los modelos de datos proporcionan una forma alternativa y centralizada de configurar los dispositivos Cisco (en lugar de utilizar la interfaz de línea de comandos (CLI) de Cisco o el protocolo simple de administración de red (SNMP)) y recopilar datos operativos (comandos show) de los dispositivos Cisco. Dado que los modelos de datos se basan en estándares, se puede utilizar el mismo procedimiento para configurar o recopilar datos de dispositivos que no son de Cisco, lo que los convierte en ideales para clientes que admiten varios proveedores. Se puede utilizar una plataforma de gestión centralizada (por ejemplo, un portátil) para configurar o recopilar datos de varios dispositivos de Cisco, y la arquitectura del modelo de datos permite automatizar estos procedimientos mediante scripts Python (dos ventajas clave adicionales).

Otro lenguaje de modelado de datos de última generación (YANG) (RFC 6020)

YANG es un lenguaje de modelado de datos basado en estándares utilizado para crear solicitudes de configuración de dispositivos o solicitudes de datos operativos (show command). Tiene un formato estructurado similar al de un programa informático legible por las personas. Hay varias aplicaciones disponibles que se pueden ejecutar en una plataforma de gestión centralizada (por ejemplo, un portátil) para crear estas solicitudes de datos operativos y de configuración.

Existen modelos de datos YANG estándar (comunes) que se aplican a todos los proveedores (por ejemplo, una solicitud para desactivar o cerrar una interfaz Ethernet debe ser idéntica tanto para los dispositivos Cisco como para los que no lo son), así como modelos de datos de dispositivos (nativos, específicos de proveedores) que facilitan la configuración o recopilación de datos operativos asociados con las funciones de los proveedores.

Protocolo de configuración de red (NETCONF) (RFC 6241)

NETCONF es un protocolo basado en estándares y codificado en lenguaje de marcado extensible (XML) que proporciona el transporte para comunicar la configuración con formato YANG o la solicitud de datos operativos desde una aplicación que se ejecuta en una plataforma de administración centralizada (por ejemplo, un portátil) al dispositivo Cisco desde el que un usuario desea configurar o solicitar datos operativos (comando show). Proporciona servicios basados en transacciones como, por ejemplo, anular toda la solicitud de configuración cuando falla una parte de esa solicitud de configuración. NETCONF utiliza un mecanismo sencillo basado en Remote Process Call (RPF) para facilitar la comunicación entre un cliente (aplicación o script de plataforma de administración centralizada) y un servidor (switch o router de Cisco). Utiliza Secure Shell (SSH) como capa de transporte a través de los dispositivos de red. Algunas operaciones de NETCONF incluyen get, get-config, edit-config y rpc.

Configurar

1. Configuración básica de un Catalyst 3850 que ejecuta el software IOS-XE 16.3.3 para soportar el modelado de datos NETCONF/YANG

3850-1# show running-config

netconf-yang -------------------------------------> Enable NETCONF/YANG globally. It may take up to 90 seconds to initialize

username cisco1 privilege 15 password 0 cisco1 ---> Username/password used for NETCONF-SSH access

Nota: Esta es la configuración completa requerida en el Catalyst 3850 para soportar el modelado de datos NETCONF/YANG, pero supone que "no aaa new-model" se configura globalmente (el valor predeterminado) también. Si se desea habilitar AAA (autenticación, autorización y contabilidad) mediante la configuración de "aaa new-model", también se requiere la siguiente configuración como mínimo. También puede expandir esto para utilizar AAA con una configuración TACACS+ o RADIUS, pero esto está más allá del alcance de este ejemplo.

aaa new-model

aaa authorization exec default local -------------> Required for NETCONF-SSH connectivity and edit-config operations

2. Configuración adicional (opcional) para permitir el monitoreo de eventos SNMP y Syslog de NETCONF/YANG

Estas configuraciones snmp-server deben estar presentes para habilitar la generación de notificaciones NETCONF (RFC 5277 - https://tools.ietf.org/html/rfc5277) para los mensajes Syslog y para que cualquier trampa SNMP configurada también genere notificaciones NETCONF.

Tenga en cuenta que, aunque estos son los mínimos requeridos, también podrían estar presentes entradas adicionales de "snmp-server enable". Un cliente (plataforma de administración centralizada) se registra para recibir el flujo de notificación NETCONF de un servidor (Catalyst 3850) y enviar una suscripción RPC específica (consulte la sección 3 de "Configuración de la plataforma de administración centralizada (portátil)").

 3850-1# show running-config 

 snmp-server community <string> RW ------------------------------> SNMP gateway in DMI requires community public prior to 16.5.1. A configurable community is supported on 16.5.1 and later.
 netconf-yang cisco-ia snmp-community-string <string> -----------> Configure the same community string to enable SNMP MIB access for both NETCONF and RESTCONF.
 snmp-server trap link ietf -------------------------------------> enable traps for IETF link up/down 
 snmp-server enable traps snmp authentication linkdown linkup ---> enable traps for link up/down 
 snmp-server enable traps syslog --------------------------------> enable traps for Syslog so notifications will be generated 
 snmp-server manager --------------------------------------------> enable snmp-server 

Para Syslog, esta configuración debe estar presente para que la Interfaz de modelo de datos (CSI) en el Catalyst 3850 tenga la capacidad de generar notificaciones NETCONF definidas en RFC 5277 cuando los mensajes Syslog son generados por IOSd en el Catalyst 3850.

 logging history debugging -------> required for the generation of any NETCONF notification messages for Syslog 
 logging snmp-trap emergencies ---> configure 1 or more of the following to control which levels of Syslog messages are returned as notifications 
 logging snmp-trap alerts 
 logging snmp-trap critical 
 logging snmp-trap errors 
 logging snmp-trap warnings 
 logging snmp-trap notifications 
 logging snmp-trap informational 
 logging snmp-trap debugging 

Para las trampas SNMP, esta configuración es necesaria para generar notificaciones NETCONF. En el software IOS-XE 16.3.1 se puede configurar un máximo de 10 trampas SNMP para generar notificaciones NETCONF, pero esta restricción se eliminará en una futura versión. La generación de notificaciones para las trampas SNMP está habilitada de forma predeterminada. Para inhabilitar la generación de notificaciones de trampa SNMP, utilice esta CLI "no netconf-yang cisco-ia snmp-trap-control global-forwarding".

 netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.6.3.1.1.5.3 --------> LinkDown trap 
 netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.6.3.1.1.5.4 --------> LinkUp trap 
 netconf-yang cisco-ia snmp-trap-control trap-list 1.3.6.1.4.1.9.9.41.2.0.1 ---> Syslog generated notification trap 

3. Configuración de Conectividad de Red del Catalyst 3850 Utilizado en este Ejemplo

La interfaz de administración de Catalyst 3850 GigabitEthernet0/0 se utiliza para conectarse a la red y a la plataforma de administración centralizada (se utilizará un portátil) en este ejemplo. El protocolo de configuración dinámica de host (DHCP) se ha utilizado para asignar la dirección IP 172.16.167.175 a esta interfaz. Se pueden utilizar configuraciones alternativas en el Catalyst 3850 siempre y cuando el portátil pueda alcanzar el Catalyst 3850 en la red.

 3850-1# show running-config 

 vrf definition Mgmt-vrf 
  ! 
  address-family ipv4 
  exit-address-family 
  ! 
  address-family ipv6 
  exit-address-family 

 interface GigabitEthernet0/0 
  vrf forwarding Mgmt-vrf 
  ip address dhcp 
  negotiation auto 

 ip route vrf Mgmt-vrf 0.0.0.0 0.0.0.0 172.16.167.161 

 3850-1# show ip interface brief  
 
 Interface              IP-Address      OK? Method Status Protocol 
 Vlan1                  1.1.1.1         YES NVRAM  up     up  
 Vlan10                 10.10.10.1      YES NVRAM  up     up  
 Vlan20                 20.20.20.1      YES NVRAM  up     up  
 GigabitEthernet0/0     172.16.167.175  YES DHCP   up     up  
 Fo1/1/1                unassigned      YES unset  down   down  
 Fo1/1/2                unassigned      YES unset  down   down  
 GigabitEthernet1/0/1   unassigned      YES manual up     up  
 GigabitEthernet1/0/2   unassigned      YES unset  up     up  
 GigabitEthernet1/0/3   unassigned      YES unset  down   down  
 GigabitEthernet1/0/4   unassigned      YES unset  down   down  
 GigabitEthernet1/0/5   unassigned      YES unset  down   down 

Verifique NETCONF/YANG en el Catalyst 3850

1. Desde la interfaz de línea de comandos (CLI) del Catalyst 3850, este comando se puede utilizar para garantizar que los procesos de software necesarios para admitir la interfaz de modelo de datos (CSI) en el Catalyst 3850 se ejecuten una vez que se haya configurado netconf-yang.

 3850-1# show platform software yang-management process  
 
 confd : Running  
 nesd : Running  
 syncfd : Running  
 ncsshd : Running  
 dmiauthd : Running  
 vtyserverutild : Running  
 opdatamgrd : Running  
 ngnix : Running 

Los siguientes pasos se realizan desde la plataforma de administración centralizada. En este ejemplo, se utiliza un portátil (Apple MacBook Pro que ejecuta macOS Sierra 10.12.2) que tiene acceso de red al Catalyst 3850. Los comandos se ejecutan desde un terminal prompt en el portátil. No hay ninguna aplicación especial cargada en el portátil en este momento.

2. Asegúrese de que la plataforma de gestión centralizada (portátil) pueda alcanzar el Catalyst 3850 (172.16.167.175) en la red.

 USER1-M-902T:~ USER1$ ping 172.16.167.175  
 
 PING 172.16.167.175 (172.16.167.175): 56 data bytes 
 64 bytes from 172.16.167.175: icmp_seq=0 ttl=247 time=3.912 ms 
 64 bytes from 172.16.167.175: icmp_seq=1 ttl=247 time=6.917 ms 
 64 bytes from 172.16.167.175: icmp_seq=2 ttl=247 time=4.063 ms 
 64 bytes from 172.16.167.175: icmp_seq=3 ttl=247 time=4.371 ms 
 ^C

3. Verifique la conectividad SSH con el Catalyst 3850 (172.16.167.175 en este ejemplo) desde la plataforma de administración centralizada (laptop) con el nombre de usuario y la contraseña (cisco1/cisco1) desde la configuración de Catalyst 3850 anterior. La respuesta será una larga lista de capacidades NETCONF del Catalyst 3850 seguida de un mensaje hello. Puerto TCP 830 = netconf-ssh.

Consejo: Si esta prueba SSH no funciona, asegúrese de que cualquier firewall entre el portátil y Catalyst 3850 permita el puerto TCP 830 (consulte RFC 4742: https://tools.ietf.org/html/rfc4742).

USER1-M-902T:~ USER1$ ssh -s cisco1@172.16.167.175 -p 830 netconf 
cisco1@172.16.167.175’s password: cisco1

<?xml version="1.0" encoding="UTF-8"?>
<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<capabilities>
<capability>urn:ietf:params:netconf:base:1.0</capability>
<capability>urn:ietf:params:netconf:base:1.1</capability>
<capability>urn:ietf:params:netconf:capability:writable-running:1.0</capability>
<capability>urn:ietf:params:netconf:capability:xpath:1.0</capability>
<capability>urn:ietf:params:netconf:capability:validate:1.0</capability>
<capability>urn:ietf:params:netconf:capability:validate:1.1</capability>
<capability>urn:ietf:params:netconf:capability:rollback-on-error:1.0</capability
--snip--
</capabilities>
<session-id>2870</session-id></ hello>]]>]]>

Use < ^C > to exit

Configuración de la plataforma de gestión centralizada (portátil)

1. Instalación de la aplicación Explorador de Yang en un portátil

En este ejemplo, la aplicación Yang Explorer se utiliza en un portátil (Apple MacBook Pro que ejecuta macOS Sierra 10.12.2, navegador Google Chrome) para actuar como la plataforma de administración centralizada. El Explorador de Yang permite al usuario hacer lo siguiente:

· Cargar / Compilar modelos de datos YANG desde la interfaz de usuario o la línea de comandos
· Generar RPC NETCONF (llamadas de procedimiento remoto)
· ejecutar RPC contra un servidor NETCONF real (Catalyst 3850)
· Guardar las RPC creadas en las colecciones para su uso posterior
· Examinar árboles de modelos de datos e inspeccionar las propiedades de YANG

Puede encontrar la guía de usuario, las instrucciones de configuración y la descarga de la aplicación Yang Explorer aquí: https://github.com/CiscoDevNet/yang-explorer.

Nota: La aplicación YANG Explore también es compatible con los sistemas Linux.

2. Utilizar la aplicación Explorador de Yang

Inicie la aplicación Yang Explorer - desde un terminal en el portátil ejecute el comando ./start.sh & desde el directorio yang-explorer.

Nota: Mantenga esta sesión de terminal abierta de lo contrario la aplicación Explorador de Yang se cerrará y se debe reiniciar. También servirá como un registro de consola de la actividad de la aplicación.

USER1-M-902T:~ USER1$ cd yang-explorer

USER1-M-902T:yang-explorer USER1$ ./start.sh &

 Starting YangExplorer server .. 
 Use http://localhost:8088/static/YangExplorer.html

Performing system checks...

System check identified no issues (0 silenced). 
 January 19, 2017 - 23:12:20 
 Django version 1.8.3, using settings 'server.settings' 
 Starting development server at http://localhost:8088/ 
 Quit the server with CONTROL-C.

Inicie la GUI del Explorador de Yang: inicie la GUI de la aplicación del Explorador de Yang y pegue esta URL en el navegador de Google Chrome del portátil (consulte la captura de pantalla): http://localhost:8088/static/YangExplorer.html.

Inicio de sesión: inicie sesión en la GUI de la aplicación Explorador de Yang como invitado/invitado en la esquina superior derecha del menú principal de la GUI de la aplicación.

Recupere las capacidades del Catalyst 3850: introduzca los detalles del Catalyst 3850 (dirección IP, nombre de usuario/contraseña, puerto TCP 830 para ssh-netconf) y haga clic en Capacidades para recuperar la lista de capacidades operativas YANG del software Catalyst 3850.

Consejo: Esta es también una buena prueba para confirmar que la comunicación NETCONF funciona entre la aplicación Yang Explorer en la Plataforma de administración centralizada (Laptop) y el Catalyst 3850.

Cargar modelos de datos de Yang - Se pueden suscribir varios modelos de datos YANG en Administrar modelos. Una vez suscritos, aparecen en el cuadro Explorador de la izquierda. Estos modelos de YANG permiten a la aplicación Yang Explorer crear mensajes de Llamadas de procedimiento remoto (RPC) NETCONF formateados por YANG (que se envían al Catalyst 3850 para configurarlo o recuperar datos de él) sin necesidad de tener una experiencia YANG exhaustiva. En la siguiente sección Ejemplos básicos de operaciones NETCONF/YANG se tratan ejemplos de cómo hacerlo.

3. Suscripción a Notificaciones NETCONF (opcional)

Un cliente (plataforma de administración centralizada) se registra para recibir secuencias de notificación NETCONF de un servidor (Catalyst 3850) mediante el envío de este mensaje RPC NETCONF con formato YANG. El Catalyst 3850 envía notificaciones NETCONF de forma asincrónica a cada cliente que se suscribe. Antes de completar esta tarea, asegúrese de que la configuración correcta esté en su lugar en el Catalyst 3850 para soportar las Notificaciones NETCONF (consulte la sección 2) de Configuración de NETCONF/YANG en el Catalyst 3850. El servidor NETCONF (Catalyst 3850) comienza a enviar las notificaciones de eventos al cliente NETCONF (Plataforma de administración centralizada) a medida que se producen los eventos dentro del sistema. Estas notificaciones de eventos continuarán enviándose hasta que finalice la sesión NETCONF o la suscripción termine por alguna otra razón. Consulte RFC 5277 para obtener más detalles sobre las opciones de suscripción https://tools.ietf.org/html/rfc5277.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <create-subscription xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 
     <stream>snmpevents</stream> 
   </create-subscription> 
 </rpc>

Para ello, debe cortar y pegar esto en la GUI de la aplicación del Explorador de Yang como un RPC personalizado

A continuación, Run se selecciona para enviar el mensaje RPC personalizado al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con un mensaje ok para que el usuario sepa que la operación fue exitosa.

Nota: La versión actual del Explorador de Yang utilizada en este ejemplo no tiene la opción de ver las Notificaciones NETCONF recibidas. Normalmente se almacenan en un registro de notificación en el menú principal de la aplicación.

Ejemplos Operativos Básicos de NETCONF/YANG

Ahora que Catalyst 3850 y la Plataforma de administración centralizada están configurados y han comenzado a comunicarse, veamos algunos ejemplos operativos básicos.

Los ejemplos demostrarán que los mensajes RPC NETCONF formateados por YANG enviados a través de NETCONF desde la aplicación Centralized Management Platform (Laptop) Yang Explorer al Catalyst 3850 se convierten a la CLI estándar de Cisco IOS mediante el proceso de software confd en el Catalyst 3850. Además, los datos de la CLI de Cisco IOS (show command data) se convierten a datos con formato YANG mediante el proceso de software confd en el Catalyst 3850 antes de enviarse como mensaje RPC NETCONF a la aplicación Yang Explorer de la Plataforma de administración centralizada (Laptop). Esto significa que la CLI normal todavía se puede utilizar en el Catalyst 3850 para configurar el switch y recopilar los datos del comando show además de utilizar NETCONF/YANG para hacer lo mismo.

1. Ejemplo de recuperación de datos

Solicitud de una Lista de Nombres de Interfaz del Catalyst 3850

La operación deseada se puede seleccionar en la sección Explorador del lado izquierdo de la GUI de la aplicación Explorador de Yang. En este caso, los datos del nombre de la interfaz se deben recuperar del Catalyst 3850 y por lo tanto Oper (para el funcionamiento) se selecciona seguido de get-config en el menú desplegable del nombre de la interfaz. RPC se selecciona a continuación para generar el YANG formateado (legible por humanos) NETCONF RPC que se debe enviar al Catalyst 3850 a través de NETCONF para recuperar estos datos del Catalyst 3850.

Después de que se genere el mensaje YANG formateado NETCONF RPC, Run se selecciona para enviarlo al Catalyst 3850. El Catalyst 3850 responde con una lista con formato YANG (legible por personas) de los nombres de interfaz de Catalyst 3850 (GigabitEthernet1/1/1, GigabitEthernet1/1/2, etc.).

2. Ejemplo de configuración

Cierre de una interfaz Ethernet en el Catalyst 3850

La operación deseada se selecciona en el lado izquierdo de la sección Explorador de la GUI de la aplicación Explorador de Yang. En este caso, para configurar una interfaz (apagar una interfaz) se requiere en el Catalyst 3850 y por lo tanto, Config (para la configuración) se selecciona seguido de los parámetros operativos requeridos en los menús desplegables de la interfaz. RPC se selecciona a continuación para generar el YANG formateado (legible por humanos) NETCONF RPC que se debe enviar al Catalyst 3850 a través de NETCONF para ejecutar la tarea de configuración.

Después de que se genere el mensaje YANG formateado NETCONF RPC, Run se selecciona para enviarlo al Catalyst 3850. El Catalyst 3850 responde con un mensaje con formato YANG (legible por personas) que indica que la operación de configuración fue correcta (ok).

Para confirmar que el cambio se realizó, la configuración se puede verificar. Se puede utilizar una operación get-config (Oper) donde Catalyst 3850 responde que la configuración de la interfaz GigabitEthernet 1/0/16 ha "habilitado = falso" ahora, lo que significa que la interfaz se cerró.

Consejo: En general, cuando no está claro qué formato deberían tener los Valores en la sección Explorador de la aplicación Explorador de Yang, vaciar la configuración de YANG formada en Catalyst 3850 como se muestra es una buena manera de determinar qué son antes de que se intente modificarlos. El lado derecho de las pantallas siguientes proporciona algunas descripciones y dependencias para estos valores, así como en las columnas Propiedad y Valor.

Después de que se genere el mensaje YANG formateado NETCONF RPC, Run se selecciona para enviarlo al Catalyst 3850. El Catalyst 3850 responde con un mensaje con formato YANG que indica que la configuración de la interfaz GigabitEthernet 1/0/16 ha habilitado = false ahora, lo que significa que la interfaz se cerró.

Visualización CLI de Catalyst 3850 de la Configuración de la Interfaz tanto Antes como Después del Cambio de Configuración de NETCONF/YANG Anterior

En el momento de la operación de cambio de configuración anterior del Explorador de Yang, esto es resultado de la CLI del Catalyst 3850. La interfaz GigabitEthernet 1/0/16 estaba en el estado predeterminado sin apagado hasta que se recibe el mensaje NETCONF RPC como se ve en el mensaje de registro en el Catalyst 3850. Después de recibir el mensaje NETCONF RPC que contiene la solicitud formateada YANG para cerrar la interfaz, la operación se completa, la interfaz se apaga y la configuración en ejecución se modifica para reflejar esto. Esto también demuestra cómo el proceso de software confd en el Catalyst 3850 convierte el mensaje YANG recibido formateado NETCONF RPC en la CLI estándar de Cisco IOS. Esto significa que un usuario todavía puede utilizar la CLI normal de Cisco IOS para modificar la configuración y ejecutar los comandos show además de utilizar NETCONF/YANG para hacer lo mismo.

3850-1# show running-config interface gigabitEthernet 1/0/16 

Building configuration...

Current configuration : 39 bytes 

! 

interface GigabitEthernet1/0/16 

end

3850-1# show startup-config | begin 1/0/16 

interface GigabitEthernet1/0/16 

!

*Jan 5 17:05:55.345: %DMI-5-CONFIG_I:Switch 1 R0/0: nesd: Configured from NETCONF/RESTCONF by cisco1, transaction-id 31332 

*Jan 5 17:05:57.335: %LINK-5-CHANGED: Interface GigabitEthernet1/0/16, changed state to administratively down 

3850-1# show running-config interface gigabitEthernet 1/0/16 

Building configuration...

Current configuration : 49 bytes 

! 

interface GigabitEthernet1/0/16 

shutdown -------------------------> the interface is shutdown now

end 

3850-1#

Nota: La configuración no se ha guardado (copiada de la configuración en ejecución a la configuración de inicio) en el Catalyst 3850 todavía.

3850-1# show startup-config | begin 1/0/16 
 interface GigabitEthernet1/0/16 
 !

Guardar la configuración en un Catalyst 3850

La configuración en ejecución se puede guardar en la configuración de inicio en el Catalyst 3850 mediante el envío de este mensaje RPC NETCONF formateado por YANG al Catalyst 3850 a través de NETCONF.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:save-config xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"/> 
 </rpc>

Esto se hace cuando se corta y pega esto en la aplicación Explorador de Yang como un RPC personalizado.

Ejecutar se selecciona para enviar el mensaje RPC personalizado al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con un mensaje exitoso.

Visualización de la CLI de Catalyst 3850 de la Configuración de Inicio Guardada después de la Operación anterior para Guardar la Configuración NETCONF/YANG

La configuración de inicio ahora coincide con la configuración en ejecución:

3850-1# show running-config interface gigabitEthernet 1/0/16 
 Building configuration...
Current configuration : 49 bytes 
 ! 
 interface GigabitEthernet1/0/16 
 shutdown 
 end 

3850-1# show startup-config | begin 1/0/16 
 interface GigabitEthernet1/0/16 
 shutdown 
 ! 

Configuración del Catalyst 3850 desde la CLI

Como se mencionó anteriormente, la CLI normal de Catalyst 3850 todavía se puede utilizar para configurar el switch y recopilar los datos del comando show además de usar NETCONF/YANG para hacer lo mismo. Cuando se utiliza la CLI de Catalyst 3850 en lugar de NETCONF/YANG para configurar el switch, la nueva configuración en ejecución se sincroniza con la interfaz del modelo de datos (CSI) en el Catalyst 3850 mediante el proceso de software syncfd.

3850-1# show running-config interface gigabitEthernet 1/0/16
Building configuration...
Current configuration : 49 bytes
!
interface GigabitEthernet1/0/16
 shutdown 
end

3850-1# config t
Enter configuration commands, one per line.  End with CNTL/Z.
3850-1(config)# interface gigabitEthernet 1/0/16
3850-1(config-if)#no shutdown 
3850-1(config-if)# exit
3850-1(config)# exit
3850-1#
*Jan 24 16:39:09.968: %LINK-3-UPDOWN: Interface GigabitEthernet1/0/16, changed state to down
*Jan 24 16:39:13.479: %SYS-5-CONFIG_I: Configured from console by console
*Jan 24 16:39:15.208: %DMI-5-SYNC_START:Switch 1 R0/0: syncfd:  External change to running configuration detected. The running configuration will be synchronized to the DMI data store. 
*Jan 24 16:39:43.290: %DMI-5-SYNC_COMPLETE:Switch 1 R0/0: syncfd:  The running configuration has been synchronized to the DMI data store. 
3850-1#

La próxima vez que la aplicación Explorador de Yang solicite una copia de la configuración de la interfaz después del cambio de CLI, el cambio se refleja correctamente en el resultado de YANG.

Ejecutar se selecciona para enviar el mensaje get-config RPC para GigabitEthernet1/0/16 al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con la configuración de la interfaz GigabitEthernet1/0/16 que muestra enabled = true.

3. Comprobar qué datos operativos MIB SNMP están disponibles a través de las operaciones de solicitud GET

Los datos MIB SNMP que se pueden devolver con las operaciones GET de NETCONF no se pueden configurar por el usuario. Todos los MIB SNMP soportados que se convierten en datos estructurados definidos por los modelos de datos YANG forman parte del software IOS-XE en el Catalyst 3850. Para descubrir qué datos MIB están disponibles en las solicitudes GET, se indican tres opciones. Todas las MIB admitidas incluirán smiv2 en la respuesta de capacidad.

Opción 1. El botón Capacidades se puede seleccionar en la GUI de la aplicación Explorador de Yang. El Catalyst 3850 responde con su lista de capacidades que contiene entradas smiv2 MIB.

Opción 2. Este mensaje YANG formateado NETCONF RPC se puede enviar al Catalyst 3850 a través de NETCONF para recuperar la lista de capacidades que incluye los modelos MIB smiv2 disponibles.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <get> 
     <filter type="subtree"> 
       <ncm:netconf-state xmlns:ncm="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> 
         <ncm:capabilities/> 
       </ncm:netconf-state> 
     </filter> 
   </get> 
 </rpc>

Esto se realiza cuando se corta y pega en la aplicación Explorador de Yang como un RPC personalizado.

Ejecutar se selecciona para enviar el mensaje RPC personalizado al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con una lista de funciones que incluye las MIB smiv2 soportadas.

Opción 3.  Se puede ver una lista de los modelos MIB disponibles en las capacidades de NETCONF y en el mensaje Hello devuelto por el Catalyst 3850 en respuesta a una conexión SSH desde la Plataforma de administración centralizada (Laptop).

USER1-M-902T:~ USER1$ ssh -s cisco1@172.16.167.175 -p 830 netconf 
cisco1@172.16.167.175’s password: cisco1 
 
<?xml version="1.0" encoding="UTF-8"?> 
<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> 
<capabilities> 
<capability>urn:ietf:params:netconf:base:1.0</capability> 
<capability>urn:ietf:params:netconf:base:1.1</capability> 
<capability>urn:ietf:params:netconf:capability:writable-running:1.0</capability> 
<capability>urn:ietf:params:netconf:capability:xpath:1.0</capability> 
<capability>urn:ietf:params:netconf:capability:validate:1.0</capability> 
<capability>urn:ietf:params:netconf:capability:validate:1.1</capability> 
<capability>urn:ietf:params:netconf:capability:rollback-on-error:1.0</capability 
--snip--

     
     
       urn:ietf:params:xml:ns:yang:smiv2:CISCO-CONFIG-MAN-MIB?module=CISCO-CONFIG-MAN-MIB&revision=2007-04-27 
      

     
     
       urn:ietf:params:xml:ns:yang:smiv2:CISCO-CONTEXT-MAPPING-MIB?module=CISCO-CONTEXT-MAPPING-MIB&revision=2008-11-22 
      

     
     
       urn:ietf:params:xml:ns:yang:smiv2:CISCO-DATA-COLLECTION-MIB?module=CISCO-DATA-COLLECTION-MIB&revision=2002-10-30 
      
--snip-- 
</capabilities> 
<session-id>2870</session-id></ hello >]]>]]>

Use < ^C > to exit 

Cargar modelos de datos YANG adicionales

Este enlace contiene archivos de modelo de datos YANG adicionales.Estos archivos permiten que se ejecuten operaciones adicionales a través de NETCONF/YANG que se relacionan con otras funciones de Catalyst 3850 como configurar el ruteo unicast IPv4, QoS, etc.

https://github.com/YangModels/yang

Los modelos estándar (comunes, Internet Engineering Task Force (IETF)) que se aplican a todos los proveedores se pueden encontrar seleccionando estándar, ietf, rfc. Esto proporciona los modelos de datos YANG basados en estándares tomados de las publicaciones RFC por el cuerpo de estándares IETF.

https://github.com/YangModels/yang/tree/master/standard/ietf/RFC

Los modelos nativos de Cisco (dispositivo, proveedor específico) se pueden encontrar seleccionando proveedor, cisco, xe, 1632. Esto proporciona los modelos de datos YANG patentados para la versión 16.3.2 del software Cisco IOS XE para el Catalyst 3850.

https://github.com/YangModels/yang/tree/master/vendor/cisco/xe/1632

Estos archivos se pueden descargar en la plataforma de gestión centralizada (Laptop) y, a su vez, cargarse en la aplicación Explorador de Yang. Existen dos maneras para hacer esto. La primera es cargar los distintos archivos del modelo de datos YANG individualmente, la segunda es una carga masiva de todos los archivos.

1. Cargar los distintos archivos del modelo de datos YANG individualmente

Consejo: http://rawgit.com/ podría ser necesario para descargar los archivos de Github. Para descargar archivos de github, seleccione el botón Raw asociado al archivo YANG. Si se proporciona una URL en lugar de una opción de descarga de archivos, la URL se puede pegar en http://rawgit.com/ que a su vez proporcionará una URL de producción. Si coloca esta nueva URL de producción en un navegador, debe proporcionar la opción de descarga de archivos.

En este ejemplo, cisco-ethernet.yang ya se ha descargado de github en la plataforma de administración centralizada (Laptop). Estos son los pasos para cargar el archivo en la GUI de la aplicación Explorador de Yang y luego Suscribirse a él para que se cargue en la sección Explorador de la herramienta.

Consejo: La funcionalidad de las capacidades NETCONF se puede utilizar para determinar qué modelos de datos son compatibles con el software Catalyst 3850. Ver sección 2. de Configuración de la plataforma de gestión centralizada (portátil).

2. Carga masiva de todos los archivos del modelo de datos YANG a la vez

Este procedimiento también se menciona en la sección 5.2.2 aquí: https://github.com/CiscoDevNet/yang-explorer.

Desde un terminal en la plataforma de administración centralizada (portátil - Apple MacBook Pro ejecutando macOS Sierra 10.12.2):

USER1-M-902T:~ USER1$ cd yang-explorer 

USER1-M-902T:yang-explorer USER1$ cd server 

USER1-M-902T:server USER1$ python manage.py bulkupload --user guest --git https://github.com/YangModels/yang.git --dir vendor/cisco/xe/1632

Git upload .. 

Cloning into '/Users/USER1/yang-explorer/server/data/session/tmpk7V4O6'... 

remote: Counting objects: 5610, done. 

remote: Total 5610 (delta 0), reused 0 (delta 0), pack-reused 5610 

Receiving objects: 100% (5610/5610), 11.80 MiB | 2.34 MiB/s, done. 

Resolving deltas: 100% (3159/3159), done. 

Checking out files: 100% (3529/3529), done. 

Cleaning up /Users/USER1/yang-explorer/server/data/session/tmpk7V4O6 

Compiling : user: guest, file: /Users/USER1/yang-explorer/server/data/session/tmpHTAEP3/cisco-acl-oper.yang 

DEBUG:root:Compiling session dependency ... 

//anaconda/bin/pyang 

DEBUG:root:Rebuilding dependencies for user guest 

--snip--

Todos los modelos de datos de Yang se ven ahora en la GUI de la aplicación Yang Explorer. Los archivos asociados a las características de interés se pueden seleccionar al hacer clic en Suscribir y después agregarlos a la sección Explorador de la herramienta.

Consejo: La funcionalidad de las capacidades NETCONF se puede utilizar para determinar qué modelos de datos son compatibles con el software Catalyst. Ver sección 2. de Configuración de la plataforma de gestión centralizada (portátil).

Ahora se pueden completar otras tareas, como generar el RPC NETCONF/YANG necesario para guardar la configuración en el Catalyst 3850. Esto se realiza cuando se selecciona el RPC save-conf en la sección Explorador del lado izquierdo de la aplicación Explorador de Yang. A continuación, RPC se selecciona para generar el YANG formateado NETCONF RPC que se enviará al Catalyst 3850 a través de NETCONF para guardar la configuración en el Catalyst 3850.

Ejecutar se selecciona para enviar el mensaje RPC personalizado al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con un mensaje exitoso.

Modelos de datos YANG notables

Modelo de datos de cisco-ia.yang

Estos son algunos ejemplos de RPC para el modelo de datos de cisco-ia.yang. Son notables, ya que implican operaciones como guardar la configuración de Catalyst 3850, sincronizar la configuración de ejecución de Catalyst 3850 con el almacén de datos de la Interfaz de modelo de datos (CSI) local, y restablecer la interfaz de HDMI en el Catalyst 3850.

El primer paso es Suscribirse al modelo de datos de cisco-ia.yang para que aparezca en la sección Explorador a la izquierda de la GUI de la aplicación Explorador de YANG.

Una vez que el modelo de datos cisco-ia se expande en la sección Explorador a la izquierda de la GUI de la aplicación del Explorador de YANG, se ven las diversas opciones operativas. Como ejemplo para utilizar una de las opciones disponibles del modelo de datos de cisco-ia.yang, se selecciona la operación save-config y se genera el RPC asociado cuando se selecciona el botón RPC.

A continuación, Run se selecciona para enviar el mensaje RPC al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con un mensaje exitoso para que el usuario sepa que la operación fue exitosa.

Aquí se describen todas las operaciones del modelo de datos de cisco-ia.yang:

sync-from - Este RPC hace que la interfaz NETCONF en el Catalyst 3850 sincronice la representación del almacén de datos NETCONF del dispositivo que ejecuta la configuración con la configuración en ejecución en el dispositivo. Ambos existen en el propio Catalyst 3850.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:sync-from xmlns:cisco-ia="http://cisco.com/yang/cisco-ia">> 
 </rpc>

El comportamiento predeterminado de este RPC es realizar una sincronización sin valores predeterminados que hace que el resultado de un comando show running-config enviado al dispositivo se sincronice con el almacén de datos NETCONF. Si hay valores predeterminados de sincronización, la interfaz NETCONF también lee la información de configuración predeterminada proporcionada por el código de función. En la mayoría de los casos, esta opción no se utiliza. Normalmente, esto sólo se usaría si el usuario de la interfaz NETCONF deseara utilizar los comandos replace NETCONF para reemplazar las secciones completas de la configuración del dispositivo.

<?xml version="1.0" encoding="utf-8"?> 
<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:sync-from xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"> 
     <cisco-ia:sync-defaults/> 
   </cisco-ia:sync-from> 
 </rpc>

save-config - Este RPC ejecuta un comando write memory (copy running-config startup-config) para guardar la configuración actual del dispositivo en ejecución en la configuración de inicio del dispositivo.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:save-config xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"/> 
 </rpc> 

checkpoint - Este RPC hace que la interfaz NETCONF guarde la configuración en ejecución en almacenamiento no volátil usando la función de archivo de configuración integrada de IOSd.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:checkpoint xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"/> 
 </rpc> 

rollback - Este RPC hace que la interfaz NETCONF revierta la configuración en ejecución del dispositivo a una configuración en ejecución que se guardó con el RPC del punto de control o cualquier otra configuración en ejecución válida guardada en el dispositivo.

target-url              string (name of the saved checkpoint file) 
 verbose?              Boolean (show detail during rollback process) 
 nolock?                Boolean (lock configuration) 
 revert-on-error?   Empty (if error occurs during rollback, leave running unchanged) 
 revert-timer?        int16 (time in seconds before revets to the original configuration)

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:rollback xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"> 
     <cisco-ia:target-url>saved-config</cisco-ia:target-url> 
     <cisco-ia:verbose>true</cisco-ia:verbose> 
     <cisco-ia:nolock>true</cisco-ia:nolock> 
     <cisco-ia:revert-on-error></cisco-ia:revert-on-error> 
     <cisco-ia:revert-timer>10</cisco-ia:revert-timer> 
   </cisco-ia:rollback> 
 </rpc>

revert - Este RPC hace que la interfaz NETCONF cambie el temporizador inverso del RPC de reversión, esto cancela la reversión temporizada y activa la reversión inmediatamente o restablece los parámetros para la reversión temporizada.

now?   empty 
timer?  int16 
idle?    int16

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:revert xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"> 
     <cisco-ia:now/> 
     <cisco-ia:timer>10</cisco-ia:timer> 
     <cisco-ia:idle>60</cisco-ia:idle> 
   </cisco-ia:revert> 
 </rpc>

reset - La interfaz NETCONF se puede reiniciar con este RPC. Si reinicializar es true, la interfaz NETCONF borra toda la información de estado que existe en el almacén de datos en ejecución modificable. Si es false (el valor predeterminado), se conserva la información de estado del almacén de datos de la configuración NETCONF.

<?xml version="1.0" encoding="utf-8"?> 
 <rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id=""> 
   <cisco-ia:reset xmlns:cisco-ia="http://cisco.com/yang/cisco-ia"> 
     <cisco-ia:reinitialize>true</cisco-ia:reinitialize> 
   </cisco-ia:reset> 
 </rpc>

Nota: Es posible que algunas plataformas de Cisco o versiones de software de Cisco IOS no admitan todas las funciones dadas en este momento. Por ejemplo, cuando envía el reinicio anterior a un Catalyst 3850 que ejecuta IOS 16.3.3, el Catalyst 3850 devuelve el error "Restablecer no admitido" a la Plataforma de administración centralizada (Laptop) como respuesta RPC.

<nc:rpc-error xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> 
   <nc:error-type>application</nc:error-type> 
   
     
     
       operation-failed 
      
   <nc:error-severity>error</nc:error-severity> 
   <nc:error-path xmlns:cisco-ia="http://cisco.com/yang/cisco-ia">/nc:rpc/cisco-ia:reset> 
   <nc:error-message lang="en" xmlns="http://www.w3.org/XML/1998/namespace">Reset not supported 
   <nc:error-info> 
     <nc:bad-element>reset</nc:bad-element> 
   </nc:error-info> 
 </nc:rpc-error> 

Modelo de datos de ned.yang

Los modelos de datos del controlador de elementos de red (NED), como ned.yang, proporcionan la máxima potencia en términos de la configuración del dispositivo Cisco (Catalyst 3850). Estas son algunas capturas de pantalla que lo demuestran.

El primer paso es Suscribirse al modelo de datos ned.yang de modo que aparezca en la sección Explorador a la izquierda de la GUI de la aplicación Explorador de YANG.

Desplácese por las opciones disponibles en la sección Explorer en el lado izquierdo de la aplicación YANG Explorer, la GUI muestra una larga lista de características configurables de Catalyst 3850 en el modelo de datos ned.yang.

A modo de ejemplo, estas capturas de pantalla demuestran cómo mostrar la configuración de ruteo OSPF del Catalyst 3850 después de desplazarse por la lista de opciones disponibles de configuración del modelo de datos de ned.yang en la sección Explorador del lado izquierdo de la GUI de la aplicación del Explorador de YANG. La subopción ospf se encuentra dentro de la opción router. El RPC get-config asociado se genera al seleccionar el botón RPC.

A continuación, Run se selecciona para enviar el mensaje RPC al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con su configuración de ruteo OSPF.

Aquí hay una expansión de la configuración de ruteo OSPF devuelta por el Catalyst 3850 en respuesta a la operación get-config RPC.

<rpc-reply message-id="urn:uuid:0e2c04cf-9119-4e6a-8c05-238ee7f25208" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
  <data>
    <native xmlns="http://cisco.com/ns/yang/ned/ios">
      <router>
        <ospf>
          <id>100</id>
          <redistribute>
            <connected>
              <redist-options>
                <subnets/>
              </redist-options>
            </connected>
          </redistribute>
          <network>
            <ip>10.10.0.0</ip>
            <mask>0.0.255.255</mask>
            <area>0</area>
          </network>
          <network>
            <ip>20.20.0.0</ip>
            <mask>0.0.255.255</mask>
            <area>0</area>
          </network>
          <network>
            <ip>100.100.0.0</ip>
            <mask>0.0.255.255</mask>
            <area>0</area>
          </network>
        </ospf>
      </router>
    </native>
  </data>
</rpc-reply>

El YANG formó la configuración de ruteo OSPF que se recuperó del Catalyst 3850 a través de NETCONF es legible por las personas y coincide con lo que se ve cuando se observa la configuración del Catalyst 3850 a través de la CLI del Catalyst 3850.

3850-1# show running-config | section ospf 
 router ospf 100 
 redistribute connected subnets 
 network 10.10.0.0 0.0.255.255 area 0 
 network 20.20.0.0 0.0.255.255 area 0 
 network 100.100.0.0 0.0.255.255 area 0 
 3850-1#

Si lo desea, el modelo de datos ned.yang también se puede utilizar para modificar la configuración de ruteo OSPF. En este ejemplo, los nuevos parámetros de red se agregan a la configuración de ruteo OSPF existente en el Catalyst 3850 ingresando primero los parámetros deseados en la sección Explorer de la GUI de la aplicación del Explorador de Yang a la izquierda (observe que el ID de router OSPF 100 también se ingresó pero no se ve debido al desplazamiento de la pantalla del Explorador) y luego generando el YANG formado RPC asociado y pulsando el botón RPC.

A continuación, Run se selecciona para enviar el mensaje RPC al Catalyst 3850 a través de NETCONF. El Catalyst 3850 responde con un mensaje ok para que el usuario sepa que la operación fue exitosa.

Esta operación NETCONF/YANG RPC para modificar la configuración de ruteo OSPF a través del modelo de datos ned.yang se refleja en la configuración de Catalyst 3850 como se ve a través de la CLI de Catalyst 3850. También hay un mensaje syslog en el Catalyst 3850 que indica que se realizó un cambio de configuración a través de NETCONF.

3850-1#

*Jan 30 14:13:41.659: %DMI-5-CONFIG_I:Switch 1 R0/0: nesd: Configured from NETCONF/RESTCONF by cisco1, transaction-id 23143 

3850-1# show running-config | section ospf 
 router ospf 100 
 redistribute connected subnets 
 network 10.10.0.0 0.0.255.255 area 0 
 network 20.20.0.0 0.0.255.255 area 0 
 network 30.30.0.0 0.0.255.255 area 0 ------> new line added to OSPF configuration
 network 100.100.0.0 0.0.255.255 area 0 
 3850-1# 

Refiérase a la operación save-config mencionada en la sección anterior del modelo de datos de cisco-ia.yang para obtener detalles sobre cómo guardar running-config en startup-config en el Catalyst 3850 a través de NETCONF/YANG.

Guión de Python

Generar un script de Python desde la GUI de la aplicación Explorador de Yang

La GUI de la aplicación Yang Explore también se puede utilizar para generar un script Python para una operación NETCONF/YANG dada. Una ventaja clave de Python scripting es que permite la orquestación y automatización de las operaciones NETCONF/YANG.

En este ejemplo, se selecciona una operación save-config en la ventana del Explorador a la izquierda de la GUI de la aplicación Explorador de Yang en la plataforma de administración centralizada (laptop). A continuación, se selecciona el botón Script para generar el script Python. El botón Copiar se puede seleccionar para copiar la secuencia de comandos de modo que pueda pegarse en un archivo que se pueda guardar en la plataforma de administración centralizada (portátil) con una extensión de archivo Python.py. Para este ejemplo (no se muestra), este archivo se ha denominado example.py.

Nota: En el siguiente ejemplo, al utilizar el tipo "Plataforma" otro en la GUI, se produjo un error al ejecutar el script Python. Como resultado, el tipo "Plataforma" se cambió a csr, ya que el router Cisco CSR también ejecuta el software Cisco IOS-XE tal como hace el Catalyst 3850. Al hacer esto se evitó el error.

A continuación, se muestra una expansión del script Python que se generó y se copió y pegó en un archivo denominado example.py en la plataforma de administración centralizada (laptop).

Nota: Los comentarios al inicio del archivo "example.py" generado por la GUI de la aplicación del Explorador de Yang incluyen los pasos necesarios para ejecutar el script Python. La "carga útil" incluye la operación NETCONF/YANG que ejecutará el script. En este ejemplo es una operación save-config.

""" 
    
   Netconf python example by yang-explorer (https://github.com/CiscoDevNet/yang-explorer)
   
   Installing python dependencies: 
    
   > pip install lxml ncclient
    
   Running script: (save as example.py) 
    
   > python example.py -a 172.16.167.174 -u cisco1 -p cisco1 --port 830 

"""

import lxml.etree as ET 

from argparse import ArgumentParser 

from ncclient import manager 

from ncclient.operations import RPCError

payload = """ 

     
      

""" 

if __name__ == '__main__':
    parser = ArgumentParser(description='Usage:')
    # script arguments 
    
    parser.add_argument('-a', '--host', type=str, required=True, 
                        
               help="Device IP address or Hostname") 
    
    parser.add_argument('-u', '--username', type=str, required=True, 
                        
               help="Device Username (netconf agent username)") 
    
    parser.add_argument('-p', '--password', type=str, required=True, 
                            
               help="Device Password (netconf agent password)") 
    
    parser.add_argument('--port', type=int, default=830, 
                        
               help="Netconf agent port") 
    
    args = parser.parse_args()
    
    # connect to netconf agent 
    
    with manager.connect(host=args.host, 
                         
                port=args.port, 
                                  
                username=args.username, 
                         
                password=args.password, 
                         
                timeout=90, 
                         
                hostkey_verify=False, 
                         
                device_params={'name': 'csr'}) as m:

# execute netconf operation 

try: 
    
   response = m.dispatch(ET.fromstring(payload)).xml 
    
   data = ET.fromstring(response) 

except RPCError as e: 
      
   data = e._raw
# beautify output 

print(ET.tostring(data, pretty_print=True))

Ejecutar un guión de Python desde la plataforma de gestión centralizada (portátil)

Esta es la comprobación de CLI de Catalyst 3850 antes de ejecutar el ejemplo de script Python.py que guardará running-config en startup-config. En este punto, el comando shutdown está en running-config pero no en startup-config para la interfaz GigabitEthernet1/0/10.

3850-1# show running-config interface gigabitEthernet 1/0/10 
 Building configuration...

Current configuration : 49 bytes 
 ! 
 interface GigabitEthernet1/0/10 
 shutdown 
 end 

3850-1# show startup-config | begin 1/0/10 
 interface GigabitEthernet1/0/10 
 ! 
 interface GigabitEthernet1/0/11 
 ! 
 interface GigabitEthernet1/0/12 
 ! 
 interface GigabitEthernet1/0/13 
 !

Desde un terminal normal en la plataforma de administración centralizada (portátil), el archivo Python ejemplo.py generado por la GUI de la aplicación Explorador de Yang se copia primero en el directorio yang-explore en el portátil.

USER1-M-902T:~ USER1$ pwd 
 /Users/USER1 
 USER1-M-902T:~ USER1$ cp /Users/USER1/Desktop/example.py /Users/USER1/yang-explorer  
 USER1-M-902T:~ USER1$ cd yang-explorer 
 USER1-M-902T:yang-explorer USER1$ ls -l 
 total 112 
 -rw-r--r-- 1 USER1 staff 11358 Jan 4 17:59 LICENSE 
 -rw-r--r-- 1 USER1 staff 13635 Jan 4 17:59 README.md 
 drwxr-xr-x 12 USER1 staff 408 Jan 4 17:59 YangExplorer 
 drwxr-xr-x 7 USER1 staff 238 Jan 4 17:59 default-models 
 drwxr-xr-x 3 USER1 staff 102 Jan 4 17:59 docs 
 -rw-r--r-- 1 USER1 staff 72 Jan 4 17:59 env.sh 
 -rw-r--r--@ 1 USER1 staff 1990 Jan 30 17:50 example.py 
 -rw-r--r-- 1 USER1 staff 207 Jan 4 17:59 requirements.txt 
 drwxr-xr-x 11 USER1 staff 374 Jan 5 14:37 server 
 -rwxr-xr-x 1 USER1 staff 4038 Jan 4 17:59 setup.sh 
 -rwxr-xr-x 1 USER1 staff 640 Jan 4 17:59 start.sh 
 drwxr-xr-x 5 USER1 staff 170 Jan 4 18:00 v 
 USER1-M-902T:yang-explorer USER1$ 

A continuación, desde un terminal normal en la plataforma de administración centralizada (laptop), se ejecutan estos dos comandos que se proporcionaron en la sección de comentarios al comienzo del archivo example.py generado por la GUI de la aplicación Explorador de Yang (consulte la sección anterior "Generación de un Script de Python desde la GUI de la aplicación de Yang Explorer").

 USER1-M-902T:yang-explorer USER1$ pip install lxml ncclient 
 Collecting lxml 
 Downloading lxml-3.7.2.tar.gz (3.8MB) 
 100% |████████████████████████████████| 3.8MB 328kB/s 
 Collecting ncclient 
 Downloading ncclient-0.5.3.tar.gz (63kB) 
 100% |████████████████████████████████| 71kB 3.5MB/s 
 Requirement already satisfied: setuptools>0.6 in /Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages (from ncclient) 
 Collecting paramiko>=1.15.0 (from ncclient) 
 Downloading paramiko-2.1.1-py2.py3-none-any.whl (172kB) 
 100% |████████████████████████████████| 174kB 3.1MB/s 
 Collecting six (from ncclient) 
 Using cached six-1.10.0-py2.py3-none-any.whl 
 Collecting cryptography>=1.1 (from paramiko>=1.15.0->ncclient) 
 Using cached cryptography-1.7.2-cp27-cp27m-macosx_10_6_intel.whl 
 Collecting pyasn1>=0.1.7 (from paramiko>=1.15.0->ncclient) 
 Using cached pyasn1-0.1.9-py2.py3-none-any.whl 
 Collecting cffi>=1.4.1 (from cryptography>=1.1->paramiko>=1.15.0->ncclient) 
 Using cached cffi-1.9.1-cp27-cp27m-macosx_10_10_intel.whl 
 Collecting enum34 (from cryptography>=1.1->paramiko>=1.15.0->ncclient) 
 Using cached enum34-1.1.6-py2-none-any.whl 
 Collecting ipaddress (from cryptography>=1.1->paramiko>=1.15.0->ncclient) 
 Using cached ipaddress-1.0.18-py2-none-any.whl 
 Collecting idna>=2.0 (from cryptography>=1.1->paramiko>=1.15.0->ncclient) 
 Using cached idna-2.2-py2.py3-none-any.whl 
 Collecting pycparser (from cffi>=1.4.1->cryptography>=1.1->paramiko>=1.15.0->ncclient) 
 Downloading pycparser-2.17.tar.gz (231kB) 
 100% |████████████████████████████████| 235kB 2.6MB/s 
 Installing collected packages: lxml, six, pycparser, cffi, pyasn1, enum34, ipaddress, idna, cryptography, paramiko, ncclient 
 Running setup.py install for lxml ... - 
 done 
 Running setup.py install for pycparser ... done 
 Running setup.py install for ncclient ... done 
 Successfully installed cffi-1.9.1 cryptography-1.7.2 enum34-1.1.6 idna-2.2 ipaddress-1.0.18 lxml-3.7.2 ncclient-0.5.3 paramiko-2.1.1 pyasn1-0.1.9 pycparser-2.17 six-1.10.0 
 USER1-M-902T:yang-explorer USER1$

El segundo comando ejecuta la secuencia de comandos Python example.py contra el Catalyst 3850 en la dirección IP 172.16.167.174 con el nombre de usuario/contraseña cisco1/cisco1 a través del puerto TCP 830 (netconf-ssh). El Catalyst 3850 envía una respuesta RPC a la plataforma de administración centralizada (laptop) de que la operación save-config fue exitosa.

USER1-M-902T:yang-explorer USER1$ python example.py -a 172.16.167.174 -u cisco1 -p cisco1 --port 830

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:31e0fdee-b72f-4695-9e03-91ec771b37f5"><result xmlns="http://cisco.com/yang/cisco-ia">Save running-config successful 
 </result> 
 </rpc-reply> 

USER1-M-902T:yang-explorer USER1

Esta es la comprobación de la CLI de Catalyst 3850 después de ejecutar el ejemplo de secuencia de comandos de Python.py que guardó la configuración de ejecución en la configuración de inicio. El comando shutdown ahora está presente tanto en running-config como en startup-config para la interfaz GigabitEthernet1/0/10 debido a la exitosa operación save-config NETCONF/YANG.

3850-1# show running-config interface gigabitEthernet 1/0/10 
 Building configuration...

Current configuration : 49 bytes 
 ! 
 interface GigabitEthernet1/0/10 
 shutdown 
 end 

3850-1# show startup-config | begin 1/0/10 
 interface GigabitEthernet1/0/10 
 shutdown 
 ! 
 interface GigabitEthernet1/0/11 
 ! 
 interface GigabitEthernet1/0/12 
 ! 
 interface GigabitEthernet1/0/13 
 ! 

Troubleshoot

En esta sección encontrará información que puede utilizar para solucionar problemas de configuración.

Mensajes de Error NETCONF

El protocolo NETCONF define un conjunto de operaciones y mensajes que se intercambian entre NETCONF Client (Centralized Management Platform (Laptop)) y la implementación NETCONF en el dispositivo Server (Catalyst 3850). Entre las operaciones de NETCONF que se utilizan habitualmente se incluyen las siguientes:

<get>, <get-config>, <edit-config> y <rpc>

Los modelos de datos YANG definen el formato y otras restricciones del contenido del mensaje NETCONF. El cliente NETCONF y el servidor interactúan enviando RPC.

Si hay un error en el formato del mensaje NETCONF o el contenido del mensaje no coincide con las definiciones de los modelos de datos YANG implementados por el dispositivo, el servidor NETCONF en el dispositivo devolverá un error RPC.

<error-type>application</error-type>

Estos errores RPC no indican que la interfaz NETCONF no funciona, estos errores indican que el cliente está intentando realizar una operación que no es soportada por los modelos de datos YANG implementados en el dispositivo del servidor. Los usuarios deben revisar los modelos de datos YANG implementados en el dispositivo del servidor para identificar y resolver las causas de estos errores.

Ejemplo de Error RPC

En este ejemplo, se utiliza un tipo de interfaz incorrecto ianaift:fastEtherFX para generar el mensaje RPC <edit-config> NETCONF formateado por YANG para enviarlo a través de NETCONF al Catalyst 3850.

Una vez que Run se selecciona para enviar el mensaje RPC al Catalyst 3850, el Catalyst 3850 responde con un mensaje de error.

Este es el error que devolvió el Catalyst 3850. Observe que contiene una etiqueta de error "operation-failed" y más detalles que se refieren al error al declarar "Unsupported - value debe ser ethernetCsmacd o softwareLoopback"</nc:error-message>".

<nc:rpc-error xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"> 
   
     
     
       application 
      
  
     
     
       operation-failed 
      
   <nc:error-severity>error</nc:error-severity> 
   <nc:error-path xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">/rpc/edit-config/config/if:interfaces/if:interface[if:name='GigabitEthernet1/0/16']/if:type</nc:error-path> 
   <nc:error-message lang="en" xmlns="http://www.w3.org/XML/1998/namespace">/interfaces/interface[name='GigabitEthernet1/0/16']/type: "Unsupported - value must be ethernetCsmacd or softwareLoopback" 
   <nc:error-info> 
     <nc:bad-element>type</nc:bad-element> 
   </nc:error-info> 
 </nc:rpc-error> 

A continuación, solucionemos el error especificando el tipo de interfaz correcto ianaift:ethernetCsmacd en el mensaje RPC enviado al Catalyst 3850 de modo que el Catalyst 3850 responda con un mensaje ok en lugar de un error.

Esta vez, una vez que Run se selecciona para enviar el mensaje RPC al Catalyst 3850, el Catalyst 3850 responde con un mensaje ok para indicar que la operación fue exitosa.

Consejo: Cuando no está seguro de cuál debe ser el formato correcto de los valores del Explorador, se puede ver la configuración existente antes de intentar realizar un cambio en sus parámetros. Esto se puede hacer con la operación get-config (Oper) como se muestra.

Una vez que se selecciona Run para enviar el mensaje RPC al Catalyst 3850, el Catalyst 3850 responde con la configuración de interfaz con formato YANG que muestra que el tipo de interfaz es ianaift:ethernetCsmacd.

Ejemplos de Otros Tipos de Error RPC

1. Mensaje de respuesta a errores RPC "En uso" (bloqueado por configuración)

Esta es una respuesta de error NETCONF a una solicitud <edit-config>. El <error-tag> indica en uso". La respuesta indica que el dispositivo de servidor (Catalyst 3850) NETCONF que ejecuta el almacén de datos está actualmente bloqueado y la operación NETCONF <edit-config> no se pudo realizar en este momento. Esto no indica un error en la implementación de la interfaz NETCONF. Si un cliente NETCONF intenta escribir en el almacén de datos en ejecución NETCONF cuando el almacén de datos está en uso, el cliente recibe esta respuesta RPC. El cliente NETCONF debería reintentar el mensaje de edición-configuración de NETCONF. Esta respuesta puede recibirse cuando el dispositivo está realizando una operación interna "sync-from-device" para sincronizar el almacenamiento de datos en ejecución de NETCONF con la configuración IOSd del dispositivo.

Respuesta NETCONF del servidor (Catalyst 3850) al cliente (Plataforma de gestión centralizada (portátil)).

<?xml version="1.0" encoding="utf-8"?> 
 
     
     
       xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3"> 
      
 
         
        
      
     
       
       
         application 
        
      
     
       
       
         in-use 
        
      
     <error-severity>error</error-severity> 
      
     
       
       
         config-locked 
        
      
     <error-info> 
      
       <session-id>0</session-id> 
      
     </error-info> 
      
   </rpc-error> 
      
 </rpc-reply> 
     

<?xml version="1.0" encoding="utf-8"?> 
 
      
      
        xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="3"> 
       
 
         
         
       
     
        
        
          application 
         
       
     
        
        
          data-missing 
         
       
     <error-severity>error</error-severity> 
       
     <error-path xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces">/rpc/edit-config/config/if:interfaces/if:interface[if:name='Loopback1111']/if:type</error-path> 
       
     
        
        
          /interfaces/interface[name='Loopback1111']/type is not configured 
         
       
     <error-info> 
       
       <bad-element>type</bad-element> 
       
     </error-info> 
       
   </rpc-error> 
       
 </rpc-reply> 
      

<?xml version="1.0" encoding="utf-8"?>
 

<?xml version="1.0" encoding="utf-8"?> 
 
       
       
         xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="6"> 
        
 
           
          
        
    
          
         
           application 
          
        
     
         
         
           invalid-value 
          
        
     <error-severity>error</error-severity> 
        
     <error-app-tag> 
        http://cisco.com/ns/yang/ned/ios> 
      
          
            inconsistent value: Device refused command "logging buffered bogus" at column 20 
           
   </rpc-error> 
 </rpc-reply>