Transfert de fichiers entre un serveur vEdge et vManage

Introduction

Ce document décrit comment transférer des fichiers entre un serveur vEdge distant et un serveur vManage local via l'interface de ligne de commande.

Contribution d'Eric Garcia Guzman, ingénieur du centre d'assistance technique Cisco.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Réseau étendu défini par logiciel (SD-WAN) de Cisco
• Linux de base

Composants utilisés

Ce document est basé sur les versions logicielles et matérielles suivantes :

•  vEdge version 20.3.6
•  vManage version 20.5.1

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. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

Vous pouvez transférer des fichiers entre un serveur vEdge distant et un serveur vManage local via l'interface de ligne de commande de deux manières :

• Récupérer des fichiers d'un serveur vEdge distant vers un système de fichiers vManage local
• Diffuser les fichiers de vManage vers vEdge via l'interface de ligne de commande vManage

Pour transférer les fichiers d'un emplacement à un autre devient une tâche difficile. Les raisons les plus courantes sont les suivantes :

• Le système de fichiers vEdge n'est pas accessible de l'extérieur
• Aucun FTP/TFTP/SFTP n'est disponible ou accessible
• Aucun accès physique au routeur pour copier des fichiers directement sur un périphérique USB ou un stockage massif

Cependant, la solution SD-WAN permet d'utiliser des connexions de contrôle pour sécuriser les fichiers de copie entre le vManage et un vEdge distant.

Le transfert peut être effectué du répertoire d'accueil du serveur vEdge vers le répertoire d'accueil de l'utilisateur local dans vManage ou vice-versa. Exemples de fichiers :

• Admin-tech
• Images du système d'exploitation Cisco Viptela®
• Journaux
• Captures de paquets
• Fichiers texte

vManage exécute le système d'exploitation Viptela et dispose de 2 modes dans CLI :

• CLI Viptela : contient toutes les fonctionnalités de Viptela
• vShell : shell UNIX dans le périphérique

Copier un fichier à partir d'un vEdge via l'interface de ligne de commande vManage

Remarque : Dans cette section, toutes les commandes sont exécutées à partir de vManage pour récupérer des fichiers d'un vEdge distant dans le répertoire local de vManage.

Option 1. Viptela CLI

Syntaxe de commande :

La commande est lue comme suit : use Secure Copy Protocol in VPN 0 to recovery source_file_name from vEdgeSystemIP into destination_directory_in_vManage with vEdge's username.

request execute vpn 0 scp USERNAME@vEdgeSystemIP:/<source_file_name> <destination_directory_in_vManage>

Exemple :

Connectez-vous à l'interface de ligne de commande vManage et exécutez la requête Viptela, exécutez la commande dans VPN 0 avec la commande Secure Copy Protocol (SCP) pour démarrer la copie.

vmanage# request execute vpn 0 scp admin@192.168.10.1:/home/admin/vEdge-20211229-023316-admin-tech.tar.gz /home/admin/
The authenticity of host '[192.168.10.1]:830 ([192.168.10.1]:830)' can't be established. 
RSA key fingerprint is SHA256:R8KekCx/giwjCqR5woDm+sodjF5kvU7QxnUexoE1xAw. 
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes 
Warning: Permanently added '[192.168.10.1]:830' (RSA) to the list of known hosts. 
admin@192.168.10.1's password: 
vEdge-20211229-023316-admin-tech.tar.gz 100% 13MB 4.8MB/s 00:02 

Option 2. CLI vShell

Exemple :

Connectez-vous à l'interface de ligne de commande vManage, passez en mode vShell et exécutez la commande SCP au format Linux.

vmanage# vshell
vmanage:~$ scp admin@192.168.10.1:/home/admin/vEdge-20211229-023316-admin-tech.tar.gz /home/ericgar/
Viptela 20.5.1 
admin@192.168.10.1's password: 
vEdge-20211229-023316-admin-tech.tar.gz 100% 13MB 4.7MB/s 00:02 

Vérifier 

Passez de l'interface de ligne de commande de Viptela à vShell dans vManage et vérifiez que le fichier est copié correctement.

vmanage# vshell
vmanage:~$ ls -l 
total 12976 
-rw------- 1 ericgar users 13285905 Dec 29 21:21 vEdge-20211229-023316-admin-tech.tar.gz 

Envoyer un fichier à un vEdge via l'interface de ligne de commande vManage

Remarque : Dans cette section, toutes les commandes sont exécutées à partir de vManage pour envoyer des fichiers du répertoire local vManage vers un stockage vEdge distant.

Syntaxe de commande :

La commande est lue comme suit : use Secure Copy Protocol in VPN 0 to copy source_file_name into /home/admin/ at vEdgeSystemIP with username.

request execute vpn 0 scp <source_file_name> username@vEdgeSystemIP:/home/admin/ 

Option 1. Viptela CLI

Exemple :

Connectez-vous à l'interface de ligne de commande vManage et exécutez la requête Viptela, exécutez la commande dans VPN 0 avec la syntaxe SCP pour démarrer la copie.

vmanage# request execute vpn 0 scp /home/ericgar/packet_capture_vEdge.pcap admin@192.168.10.1:/home/admin/ 
admin@192.168.10.1's password: 
packet_capture_vEdge.pcap 100% 13MB 3.8MB/s 00:03

Option 2. CLI vShell

Exemple :

Connectez-vous à l'interface de ligne de commande vManage, passez en mode vShell et exécutez la copie SCP au format Linux.

vmanage# vshell 
vmanage:~$ scp /home/ericgar/packet_capture_vEdge.pcap admin@192.168.10.1:/home/admin/ 
Viptela 20.5.1
admin@192.168.10.1's password: 
packet_capture_vEdge.pcap 100% 13MB 3.8MB/s 00:03 

Vérifier 

Connectez-vous à l'interface de ligne de commande vEdge et affichez le contenu de /home/admin/ pour vérifier que le fichier est copié correctement :

vEdge# vshell
vEdge:~$ ls -l
total 166444
-rw-r--r-- 1 admin admin13285905 Dec  29 16:45 packet_capture_vEdge.pcap

Remarque : Le répertoire de destination dans le vEdge doit toujours être le répertoire d'accueil de l'utilisateur, car c'est le seul répertoire qui a des autorisations d'écriture pour les transferts, sinon, le transfert échoue.

vmanage# request execute vpn 0 scp /home/ericgar/packet_capture_vEdge.pcap admin@192.168.10.1:/home/root/ 
Viptela 20.5.1
Password: 
scp: /home/root/packet_capture_vEdge.pcap: Permission denied

Copier un fichier de vManage vers l'ordinateur local

Option 1. Terminal Linux/Mac

Syntaxe de commande :

La commande est lue comme suit : copiez source_file_name de vManage dans local_destination_path avec vManage username.

scp vManageUsername@PublicIp:<source_file_name> <local_destination_path>

Exemple :

Connectez-vous à votre terminal Linux/Mac local et exécutez la commande SCP pour copier le fichier dans le répertoire souhaité.

adminIT@cisco:~$ scp admin@10.88.244.25:/home/admin/packet_capture_vEdge.pcap /Users/adminIT/Downloads/
viptela 20.5.1
Password:
packet_capture_vEdge.pcap 100% 13MB 3.6MB/s

Remarque : Il est recommandé que le fichier à récupérer se trouve dans le répertoire d'accueil de l'utilisateur, sinon les autorisations du répertoire doivent être vérifiées.

Option 2. FileZilla ou tout autre client FTP ou SFTP

Connectez-vous à :

• SFTP comme protocole ou port 22
• URL vManage, IP publique ou IP privée (si vManage est sur site)
• Utiliser un nom d'utilisateur et un mot de passe valides

Sur la droite, les fichiers du répertoire d'accueil de l'utilisateur vManage sont répertoriés. Il vous suffit de les faire glisser et de les déposer vers la destination locale sur la gauche où vous souhaitez transférer le fichier, comme illustré dans l'image. 

Informations connexes

• Transfert de fichiers entre un serveur vEdge et vManage

• Assistance et documentation techniques - Cisco Systems