Commande hostmap

Fonction

Manipule directement des entrées de mappage d'adresse dans la base de données de configuration du système.

Syntaxe

Pour ajouter un mappage d'adresse vers un nom d'hôte

hostmap -addr AdresseIP -host NomHôte...

Pour supprimer un mappage d'adresse vers un nom d'hôte

hostmap -rm AdresseIP

Pour afficher des mappages d'adresse vers un nom d'hôte

hostmap -ls

Description

La commande de niveau inférieur hostmap permet d'ajouter, de supprimer ou de répertorier des entrées de mappage d'adresse dans la base de données de configuration du système. Les entrées de la base de données sont utilisées pour mapper une adresse IP (locale ou éloignée) avec ses noms d'hôte équivalents.

L'adresse IP d'un hôte local ou éloigné donné peut être associée à un ou plusieurs noms d'hôte. Un nom d'hôte doit être indiqué sous la forme d'une chaîne comportant 255 caractères au maximum sans espaces.

Remarque :
  1. Les noms d'hôte ou les noms d'hôte d'alias admis doivent contenir au moins un caractère alphabétique. Si vous choisissez de spécifier un nom d'hôte ou un alias qui commence par un x suivi d'un chiffre hexadécimal (0-f), le nom d'hôte ou l'alias doit également contenir au moins une lettre supplémentaire qui ne peut pas être exprimée sous la forme d'un chiffre hexadécimal. Le système interprète un x de début suivi d'un chiffre hexadécimal comme la représentation en base 16 d'une adresse, à moins que le nom d'hôte ou l'alias contienne au moins un caractère qui ne soit pas un chiffre hexadécimal. Par conséquent, "xdeer" est un nom d'hôte valide, à l'inverse de "xdee".
  2. La commande hostmap ne reconnaît pas les adresses suivantes : .08, .008, .09 et .009. Les adresses avec des zéros à gauche sont interprétées comme octales et les numéros en octal ne peuvent pas contenir de 8 ni de 9.
Remarque : Lorsque le cluster est actif, vous ne pouvez pas changer la configuration IP ni la passerelle utilisées pour la communication du cluster (pool de stockage partagé).

Indicateurs

Nom de l'indicateur Description
-addr AdresseIP Permet d'ajouter une entrée de mappage de nom de l'adresse hôte IP pour l'adresse IP donnée dans la base de données. Spécifiez les noms d'hôte avec l'option -host.
-host NomHôte... Permet de préciser une liste de noms d'hôte. Les entrées de la liste doivent être séparées par des blancs.
-ls Permet d'afficher toutes les entrées de la base de données.
-rm AdresseIP Permet de supprimer l'entrée de mappage d'adresse IP en nom d'hôte de la base de données correspondant à l'adresse spécifiée par la variable AdresseIP.

Etat de sortie

Voir Etat de sortie des commandes Virtual I/O Server.

Exemples

  1. Pour ajouter une entrée dans la base de données en associant une adresse à une série de noms d'hôte, entrez la commande au format suivant : 
    hostmap  -addr 192.100.201.7  -host alpha bravo charlie
    L'adresse IP 192.100.201.7 est spécifiée en tant qu'adresse de l'hôte dont le nom d'hôte principal est alpha avec des synonymes bravo et charlie.
    Remarque : Si vous tentez d'utiliser .08, .008, .09 ou .009 dans une adresse à ajouter, le message d'erreur indiquant que l'adresse IP existe déjà s'affiche, bien que l'adresse ne se trouve pas dans la base de données.
  2. Pour répertorier toutes les entrées de la base de données, entrez la commande au format suivant : 
    hostmap -ls
Remarque : Si vous tentez de supprimer l'IP qui est utilisée pour la communication du cluster en entrant la commande suivante :
hostmap -rm 9.126.85.102

Le système affiche le message d'erreur suivant avec le code retour 78 :

The requested operation is not allowed because partition is a member of "test_cluster" cluster.
L'interface utilisée est "en0" (famille "inet") pour la communication du cluster.

Rubriques connexes

Commandes hostname et mktcpip.