SUR CETTE PAGE
Exemple: Opérations de session protocolaire XML Trace NETCONF et Junos
Cet exemple montre comment configurer les opérations de traçage pour les sessions de protocoleS XML NETCONF et Junos.
À partir de Junos OS version 16.1, [edit system services netconf traceoptions] lorsque vous activez les opérations de traçage au niveau de la hiérarchie, Junos OS permet d’opérations de traçage pour les sessions de protocole NETCONF et Junos XML, et ajoute les balises et les entrées [NETCONF] [JUNOScript] du fichier journal pour distinguer le type de session. Avant Junos OS version 16.1, seules les données de session NETCONF ont été enregistrées et [NETCONF] la balise a été omise.
Exigences
Un équipement de routage, de commutation ou de sécurité Junos OS version 16.1 ou ultérieure est requis.
Aperçu
Cet exemple configure les opérations de traçage de base pour les sessions de protocoleS XML NETCONF et Junos. L’exemple configure le fichier trace netconf-ops.log et définit un nombre maximum de 20 fichiers de trace et une taille maximale de 3 Mo pour chaque fichier. L’instruction flag all configure le traçage pour toutes les données de protocole NETCONF ou XML entrantes et sortantes. Cette world-readable option permet d’accéder sans restriction aux fichiers de traçabilité.
Configuration
CLI configuration rapide
Pour configurer rapidement cet exemple, copiez les commandes suivantes, collez-les dans un fichier texte, supprimez toutes les interruptions de ligne, modifiez les détails nécessaires pour correspondre à votre configuration réseau, puis copiez/collez les commandes dans le CLI [edit] au niveau de la hiérarchie.
set system services netconf ssh set system services netconf traceoptions file netconf-ops.log set system services netconf traceoptions file size 3m set system services netconf traceoptions file files 20 set system services netconf traceoptions file world-readable set system services netconf traceoptions flag all
Configuration des opérations de protocoles NETCONF et Junos XML
Procédure étape par étape
Pour configurer les opérations de protocoles NETCONF et Junos XML:
Pour les sessions NETCONF, activez NETCONF sur SSH.
[edit] user@R1# set system services netconf ssh
Configurez l’indicateur traceoptions pour spécifier les données de session à capturer.
Vous pouvez spécifier toutes les données entrantes, sortantes ou non. Cet exemple configure le traçage de toutes les données de session.
[edit] user@R1# set system services netconf traceoptions flag all
(Facultatif) Configurez le nom de fichier du fichier trace.
L’instruction suivante configure le fichier trace netconf-ops.log, stocké dans le répertoire /var/log . Si vous ne spécifiez pas de nom de fichier, les données de session de protocole XML NETCONF et Junos sont stockées dans /var/log/netconf.
[edit] user@R1# set system services netconf traceoptions file netconf-ops.log
(Facultatif) Configurez le nombre maximal de fichiers de trace et la taille maximale de chaque fichier.
Les instructions suivantes configurent un maximum de 20 fichiers trace avec une taille maximale de 3 Mo par fichier.
[edit] user@R1# set system services netconf traceoptions file files 20 user@R1# set system services netconf traceoptions file size 3m
(Facultatif) Limiter la sortie de trace pour inclure uniquement les lignes qui correspondent à une expression régulière particulière.
La configuration suivante, qui n’est pas utilisée dans cet exemple, correspond et enregistre uniquement les données de session contenant un « message d’erreur ».
[edit] user@R1# set system services netconf traceoptions file match error-message
(Facultatif) Configurez le traçage à la demande pour contrôler les opérations de traçage à partir de la session de protocole NETCONF ou XML Junos.
La configuration suivante, qui n’est pas utilisée dans cet exemple, permet le traçage à la demande.
[edit] user@R1# set system services netconf traceoptions on-demand
(Facultatif) Configurez les autorisations sur le fichier de traçage en spécifieant si le fichier est ou
world-readable.no-world-readableCet exemple permet un accès illimité au fichier de traces.
[edit] user@R1# set system services netconf traceoptions file world-readable
Valider la configuration.
[edit] user@R1# commit
Résultats
[edit]
system {
services {
netconf {
ssh;
traceoptions {
file netconf-ops.log size 3m files 20 world-readable;
flag all;
}
}
}
}
Vérification
Vérification du fonctionnement du protocole NETCONF et Junos XML
But
Vérifiez que l’équipement a écrit les données de session de protocole XML NETCONF et Junos sur le fichier de suivi configuré. Cet exemple enregistre les données de protocoleS NETCONF et XML entrantes et sortantes. Dans l’exemple de session NETCONF, qui n’est pas détaillée ici, l’utilisateur modifie la configuration du candidat sur le modèle R1 pour inclure le script d’opération bgp-troubleshoot.slax , puis il commit la configuration.
Action
Affichez le trace output du fichier de trace configuré /var/log/netconf-ops.log en show log 2017.
user@R1 show log netconf-ops.log Apr 3 13:09:04 [NETCONF] Started tracing session: 3694 Apr 3 13:09:29 [NETCONF] - [3694] Incoming: <rpc> Apr 3 13:09:29 [NETCONF] - [3694] Outgoing: <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos"> Apr 3 13:09:39 [NETCONF] - [3694] Incoming: <edit-config> Apr 3 13:09:43 [NETCONF] - [3694] Incoming: <target> Apr 3 13:09:47 [NETCONF] - [3694] Incoming: <candidate/> Apr 3 13:09:53 [NETCONF] - [3694] Incoming: </target> Apr 3 13:10:07 [NETCONF] - [3694] Incoming: <default-operation>merge</default-operation> Apr 3 13:10:10 [NETCONF] - [3694] Incoming: <config> Apr 3 13:10:13 [NETCONF] - [3694] Incoming: <configuration> Apr 3 13:10:16 [NETCONF] - [3694] Incoming: <system> Apr 3 13:10:19 [NETCONF] - [3694] Incoming: <scripts> Apr 3 13:10:23 [NETCONF] - [3694] Incoming: <op> Apr 3 13:10:26 [NETCONF] - [3694] Incoming: <file> Apr 3 13:10:44 [NETCONF] - [3694] Incoming: <name>bgp-troubleshoot.slax</name> Apr 3 13:10:46 [NETCONF] - [3694] Incoming: </file> Apr 3 13:10:48 [NETCONF] - [3694] Incoming: </op> Apr 3 13:10:52 [NETCONF] - [3694] Incoming: </scripts> Apr 3 13:10:56 [NETCONF] - [3694] Incoming: </system> Apr 3 13:11:00 [NETCONF] - [3694] Incoming: </configuration> Apr 3 13:11:00 [NETCONF] - [3694] Outgoing: <ok/> Apr 3 13:11:12 [NETCONF] - [3694] Incoming: </config> Apr 3 13:11:18 [NETCONF] - [3694] Incoming: </edit-config> Apr 3 13:11:26 [NETCONF] - [3694] Incoming: </rpc> Apr 3 13:11:26 [NETCONF] - [3694] Outgoing: </rpc-reply> Apr 3 13:11:26 [NETCONF] - [3694] Outgoing: ]]>]]> Apr 3 13:11:31 [NETCONF] - [3694] Incoming: ]]>]]> Apr 3 13:14:20 [NETCONF] - [3694] Incoming: <rpc> Apr 3 13:14:20 [NETCONF] - [3694] Outgoing: <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos"> Apr 3 13:14:26 [NETCONF] - [3694] Incoming: <commit/> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: <ok/> Apr 3 13:14:35 [NETCONF] - [3694] Incoming: </rpc> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: </rpc-reply> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: ]]>]]> Apr 3 13:14:40 [NETCONF] - [3694] Incoming: ]]>]]> Apr 3 13:30:48 [NETCONF] - [3694] Outgoing: <!-- session end at 2016-12-03 13:30:48 PDT -->
Sens
Cet exemple a configuré l’instruction flag all , de sorte que le fichier de trace affiche toutes les opérations de session de protocole NETCONF et sortantes et de protocole XML Junos. Chaque opération inclut la date et l’heure d’utilisation. Le fichier journal indique respectivement le type de session, NETCONF ou le protocole XML Junos, [NETCONF] [JUNOScript] en incluant la ou la balise. Plusieurs sessions de protocole NETCONF et XML Junos se distinguent par un numéro de session. Dans cet exemple, une seule session NETCONF, utilisant l’identifiant de session 3694, est active.