Configurar sesiones de NETCONF que cumplen con RFC
Cuando usa NETCONF para administrar dispositivos Junos, puede requerir que el servidor NETCONF aplique ciertos comportamientos que sean compatibles con RFC 4741, protocolo de configuración de NETCONF durante la sesión de NETCONF. Para aplicar el cumplimiento de RFC, configure la rfc-compliant instrucción en el [edit system services netconf] nivel de jerarquía. La configuración de la rfc-compliant instrucción afecta a los siguientes aspectos de la sesión NETCONF:
-
Espacios de nombres emitidos en las respuestas del servidor NETCONF
-
Los elementos devueltos en RPC responden a
<get>las operaciones y<get-config>a las operaciones en los casos en que no se devuelven datos de configuración -
Respuestas del servidor NETCONF que devolverían tanto un
<ok/>elemento como un<rpc-error>elemento con un nivel de advertencia de gravedad - El servidor NETCONF responde a las operaciones y
<validate>a<commit>las operaciones.
Las diferencias se describen en detalle en las siguientes secciones.
Nombres
De forma predeterminada, el servidor NETCONF establece el espacio de nombres predeterminado en el espacio de nombres NETCONF en la etiqueta de apertura de la respuesta del servidor, y los nombres de etiqueta NETCONF no se califican. Por ejemplo:
<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
<capabilities>
<capability>urn:ietf:params:netconf:base:1.0</capability>
...
</capabilities>
<session-id>27700</session-id>
<hello>
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/15.1R1/junos">
Cuando configure la rfc-compliant instrucción, el servidor NETCONF no define un espacio de nombres predeterminado en sus respuestas. En su lugar, el servidor incluye una declaración de espacio de nombres para el espacio de nombres NETCONF, que está vinculado al nc prefijo, y califica todas las etiquetas NETCONF en sus respuestas con el prefijo. Si establece el espacio de nombres predeterminado en el espacio de nombres NETCONF en una solicitud RPC, el servidor descarta el espacio de nombres predeterminado y emite su respuesta usando solo el espacio de nombres declarado que está vinculado al nc prefijo.
El siguiente resultado de ejemplo muestra el intercambio de funciones y mensajes del <hello> servidor NETCONF cuando se configura la rfc-compliant instrucción. La <hello> etiqueta contiene la xmlns:nc declaración y todas las etiquetas NETCONF incluyen el nc prefijo.
<nc:hello xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">
<nc:capabilities>
<nc:capability>urn:ietf:params:netconf:base:1.0</nc:capability>
...
</nc:capabilities>
<nc:session-id>27703</nc:session-id>
</nc:hello>
En el siguiente resultado, se muestra una respuesta DE EJEMPLO DE LA RPC cuando se configura la rfc-compliant instrucción:
<nc:rpc-reply
xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"
xmlns:junos="http://xml.juniper.net/junos/15.1R1/junos">
<nc:data>
<configuration xmlns="http://xml.juniper.net/xnm/1.1/xnm"
junos:changed-seconds="1417554471"
junos:changed-localtime="2014-12-02 13:07:51 PST">
<!--configuration data-->
</configuration>
<database-status-information>
<database-status>
<user>root</user>
<terminal></terminal>
<pid>47868</pid>
<start-time junos:seconds="1417560303">2014-12-02 14:45:03 PST</start-time>
<edit-path></edit-path>
</database-status>
</database-status-information>
</nc:data>
</nc:rpc-reply>
A partir de Junos OS versión 17.2R1, cuando configura la rfc-compliant instrucción y solicita datos de configuración en una sesión NETCONF, el servidor establece el espacio de nombres predeterminado para el <configuration> elemento en el mismo espacio de nombres que en el modelo YANG correspondiente.
<rpc>
<get-config>
<source>
<running/>
</source>
</get-config>
</rpc>
]]>]]>
<nc:rpc-reply
xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"
xmlns:junos="http://xml.juniper.net/junos/17.2R1/junos">
<nc:data>
<configuration
xmlns="http://yang.juniper.net/yang/1.1/jc/configuration/junos/17.2R1.13"
junos:commit-seconds="1493761452"
junos:commit-localtime="2017-05-02 14:44:12 PDT"
junos:commit-user="user">
...
</configuration>
</nc:data>
</nc:rpc-reply>
]]>]]>
Cambios en <get> y <get-config> operaciones
La rfc-compliant instrucción afecta a las respuestas del <get> servidor y <get-config> en los casos en que no se devuelven datos de configuración. Esto puede ocurrir, por ejemplo, cuando se aplica un filtro para devolver un subconjunto de la configuración y esa parte de la configuración está vacía.
Si ejecuta la <get> o <get-config> operación y no hay datos de configuración en la jerarquía solicitada, entonces si la rfc-compliant instrucción no está configurada, la respuesta de RPC contiene un elemento vacío <configuration> dentro del <data> elemento.
<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/15.1D0/junos"> <data> <configuration> </configuration> </data> </rpc-reply>
Si ejecuta la <get> o <get-config> operación y no hay datos de configuración en la jerarquía solicitada, entonces si la rfc-compliant instrucción está configurada, la respuesta de RPC devuelve un elemento vacío <data> y omite el <configuration> elemento.
<nc:rpc-reply xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/15.1R1/junos"> <nc:data> </nc:data> </nc:rpc-reply>
<rpc-error> elementos con un nivel de advertencia de severidad en las respuestas de RPC
A partir de Junos OS versión 17.4R3, 18.2R2, 18.3R2 y 18.4R1, cuando configure la instrucción, el rfc-compliant servidor NETCONF no puede devolver una respuesta RPC que incluya tanto un <rpc-error> elemento como un <ok/> elemento. Si la operación se realiza correctamente, pero la respuesta del servidor incluiría uno o más <rpc-error> elementos con un nivel de advertencia de gravedad además del <ok/> elemento, las advertencias se omiten. Además, a partir de Junos OS versión 21.2R1, cualquier advertencia que se omita durante una <commit> operación se redirige al archivo de registro del sistema para el seguimiento.
En versiones anteriores, o cuando la rfc-compliant instrucción no está configurada, el servidor NETCONF puede emitir una respuesta DE RPC que incluya un <rpc-error> elemento con un nivel de advertencia de gravedad y un <ok/> elemento. Por ejemplo, una operación de confirmación puede ser correcta, pero devolver una advertencia como en la siguiente respuesta del servidor NETCONF:
<nc:rpc-reply xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/17.4R1/junos">
<nc:rpc-error>
<nc:error-severity>warning</nc:error-severity>
<nc:error-message>
uid changed for jadmin (2001->2014)
</nc:error-message>
</nc:rpc-error>
<nc:ok/>
</nc:rpc-reply>
]]>]]>
Si configura la rfc-compliant instrucción, se omite la advertencia.
<nc:rpc-reply xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/18.4R1/junos"> <nc:ok/> </nc:rpc-reply> ]]>]]>
Respuesta del servidor NETCONF a <commitir> y <validar> operaciones
A partir de Junos OS versión 21.2R1, cuando configure la rfc-compliant instrucción, la respuesta del servidor NETCONF a <commit> las operaciones incluye los siguientes cambios:
-
Si una operación correcta
<commit>devuelve una respuesta con una o más advertencias, las advertencias se redirigen al archivo de registro del sistema, además de omitirse en la respuesta. -
La respuesta del servidor NETCONF emite el
<source-daemon>elemento como un elemento secundario del<error-info>elemento en lugar del<rpc-error>elemento. -
Si también configura la instrucción en el
flatten-commit-results[edit system services netconf]nivel de jerarquía, el servidor NETCONF solo emite un<ok/>o<rpc-error>elemento en su respuesta y suprime cualquier<commit-results>subárbol XML.
A partir de Junos OS versión 23.2R1, cuando configure la rfc-compliant instrucción, el servidor NETCONF emite solo un <ok/> elemento o <rpc-error> en respuesta a <validate> las operaciones. En versiones anteriores, la respuesta de RPC también incluye el <commit-results> elemento.
rfc-compliant instrucción, el servidor NETCONF emite solo un
<ok/> elemento o
<rpc-error> en respuesta a
<validate> las operaciones. En versiones anteriores, la respuesta de RPC también incluye el
<commit-results> elemento.
rfc-compliant instrucción, la respuesta del servidor NETCONF a
<commit> las operaciones se modifica.
rfc-compliant servidor NETCONF no puede devolver una respuesta RPC que incluya tanto un
<rpc-error> elemento como un
<ok/> elemento.