Avamar : Comment utiliser l’outil mapall

Summary: Avamar dispose d’un outil de ligne de commande appelé « mapall » qui permet de transmettre des instructions à un ou plusieurs nœuds de la grille. Cet article explique comment utiliser l’outil. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Cet article explique comment utiliser Avamar mapall pour émettre des commandes à partir du nœud utilitaire vers d’autres nœuds.

La commande mapall peut atteindre les nœuds Avamar qui sont définis dans le fichier probe.xml .

Ces scripts sont des wrappers autour du shell sécurisé standard (ssh) outils (ssh) et le protocole SCP (Secure Copy Protocol) et sont tous écrits en Perl.

 

Les scripts mapall, ssh et scp

 

  • mapall - Envoie une commande à plusieurs nœuds 
  • SSN  - Un wrapper autour de ssh qui accepte les numéros de nœuds (physiques) au lieu des adresses IP ou du nom d’hôte
  • Le RCS - Un wrapper autour de SCP, comme ci-dessus
Remarque : Connectez-vous à Avamar Utility Node et chargez les clés ssh pour utiliser les outils ssh.

Pour plus d’informations, reportez-vous à la section suivante : Avamar : Connexion à un serveur Avamar et chargement de différentes clés.
 
 

MAPALL :

Spécification des nœuds sur lesquels exécuter la commande :

Pour exécuter des commandes sur certains nœuds uniquement :

Pour exécuter la commande> uniquement sur les <nœuds 0.0, 0.2 et 0.3:

mapall --nodes=0.0,0.2,0.3 <command>
 

Pour exécuter la <commande> sur tous les nœuds à l’exception du nœud utilitaire et de la version 0.0 :

mapall --nodes=all+,-0.s,0.0 <command>
 

Balises utiles :

Vous trouverez ci-dessous quelques balises utiles qui peuvent être utilisées avec les trois outils. (Les indicateurs sont documentés dans l’Addendum technique Avamar)
Comme pour toute tâche de ligne de commande Avamar, soyez prudent lors de l’exécution.
  • --user=<username> : Specify the user on the remote system that runs the command.
  • --verbose : Provides maximum information.
  • --quiet : Disable all messages.
  • --parallel : Runs the command on all nodes simultaneously.
  • --noerror : Do not stop if an error occurs. (This flag should always be used) For legacy reasons, mapall command execution stops if an error occurs.
  • --bg : Run the command in the background and does not wait for completion.
  • --debug : Enable extended debugging information (for example, which nodes map to which IP addresses).
  • --copy : Copies a file from the utility node to remote nodes.
  • --get : Pulls a file to the utility node from remote nodes.
  • --all : Issues the command on all the data nodes plus the utility node
  • --all+ : Issues the command on all the nodes in probe.xml, including NDMP accelerator nodes, spare nodes so forth.

 

 

Exemples MAPALL :

MAPALL GET : C’est l’inverse de la commande copy.  

Procurez-vous le GSAN binaire à partir de chaque nœud de données et copiez-le sur Avamar Utility Node pour /home/admin/0.*/gsan:

mapall --noerror get 'gsan'  
 

MAPALL COPY :

Copiez le fichier /etc/hosts dans /root/etc/hosts sur chaque nœud de données.

mapall --noerror --user=root copy 'etc/hosts' 
 
Comment cela fonctionne-t-il en pratique ?
1. La commande mapall copy crée un tarball contenant les fichiers spécifiés.
2. Utilise scp pour pousser le tarball à chaque nœud.
3. Décompresse le tarball dans le répertoire de base de l’utilisateur.

Additional Information

Exemples de N° S.S. :

Connectez-vous au nœud 0.1 et ouvrez un shell interactif.

ssn 0.
 

Connectez-vous au nœud 0.2 et exécutez la commande date.

ssn 0.2 'date' 
 

Exemples de SCN :

Copiez le fichier /home/admin/gsan binaire du noeud 0.1 vers le btfix sur Avamar Utility Node.

scn 0.1:/home/admin/gsan ./btfix
 

Copier "testscript« depuis le répertoire /home/admin du nœud utilitaire sur le nœud 0.2 et placez-le en tant que »runscript" dans /data01/cur:

scn testscript 0.2:/data01/cur/runscript
 
Remarque : La commande scn ne peut pas être utilisée pour copier des fichiers d’un nœud de données vers un autre nœud de données.

Les fichiers doivent être copiés à l’aide du nœud utilitaire en deux étapes, ou bien utiliser scp pour transférer des fichiers directement entre les deux nœuds.

Affected Products

Avamar, Avamar Server

Products

Avamar
Article Properties
Article Number: 000156632
Article Type: How To
Last Modified: 01 Oct 2025
Version:  10
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.