Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
nbhostmgmt — permet de gérer les ID d'hôte pour les mappages de noms d'hôte
Synopsis
-hostid hostid | -host host -mappingname mappingname [-isshared] [-reason reason] [-server master_server]
-host host [-reason reason] [-server master_server]
-hostid hostid | -host host -autoreissue 0|1 [-reason reason] [-server master_server]
-hostid hostid | -host host -mappingname mappingname [-reason reason] [-server master_server]
[-short | -json | -json_compact] [-hostid hostid | -host host | -approved | -pending | -conflict] [-server master_server]
-hostid hostid | -host host -comment comment [-server master_server]
-hostid hostid | -host host [-server master_server]
-hostid hostid | -host host -newhostname newhostname [-reason reason] [-server master_server]
-hostid hostid | -host host -reason "reason" [-force] [-json | -json_compact]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\
DESCRIPTION
La commande nbhostmgmt vous permet de gérer les mappages d'ID d'hôte aux noms d'hôte ou d'adresses IP. Vous pouvez utiliser la commande pour :
Identifier un hôte ayant des noms différents.
Mapper ces autres noms aux ID d'hôte respectifs.
Ajouter, supprimer et lister les mappages.
Désactiver un client.
Seul l'utilisateur racine peut exécuter cette commande.
Avant d'exécuter la commande nbhostmgmt, vous devez exécuter la commande bpnbat - login - loginType WEB. La commande bpnbat authentifie votre connexion aux services web.
OPTIONS
- -add | -a
Utilisez cette option pour ajouter et approuver l'ID d'hôte pour le mappage de nom d'hôte ou d'adresse IP pour l'hôte spécifié.
Remarque :
Utilisez -add sans l'option -isshared pour ajouter le premier partage. Ajoutez tous les partages supplémentaires avec l'option -isshared.
- -addcomment | -ac
Utilisez cette option pour ajouter un commentaire pour l'hôte principal. Vous pouvez afficher le commentaire à l'aide de l'option nbhostmgmt -list. Le commentaire ajouté est uniquement associé à l'hôte principal et non à l'autre nom d'hôte mappé. Vous ne pouvez pas modifier les commentaires. Vous pouvez uniquement écraser ou supprimer le commentaire existant.
- -ah | -addhost
Utilisez cette option pour ajouter un hôte à la base de données hôte.
L'option vous permet d'ajouter l'entrée d'hôte, de sorte que l'administrateur NetBackup puisse définir le paramètre autoreissue. Le paramètre autoreissue vous permet de déployer le certificat sur l'hôte sans avoir recours à un jeton de renouvellement. Pendant la restauration Bare Metal Restore dans une configuration Auto Image Replication (AIR), une entrée d'hôte doit être ajoutée dans la base de données hôte du domaine cible.
Cohesity déconseille d'ajouter un hôte manuellement, sauf dans le cadre de scénarios spécifiques, comme une configuration Bare Metal Restore AIR.
- -aa | -allowautoreissuecert
Utilisez cette option afin de définir le paramètre autoreissue pour l'hôte ou l'ID d'hôte spécifié. Le paramètre autoreissue vous permet de déployer le certificat sur l'hôte sans avoir recours à un jeton de renouvellement. Le paramètre autoreissue est uniquement associé au nom d'hôte principal, et non à l'autre nom mappé.
- -approved |-ap
Utilisez cette option pour répertorier les noms d'hôte ou les adresses IP mappés approuvés.
- -comment | -c
Utilisez cette option pour spécifier le contenu du commentaire à ajouter à l'hôte principal. Vous devez spécifier l'hôte ou l'ID d'hôte pour ajouter un commentaire. Si le commentaire contient un espace, vous devez placer ce commentaire entre guillemets ( "..." ). Le champ comment est limité à 2 048 caractères.
- -conflict | -cf
Utilisez cette option pour répertorier les noms d'hôte ou les adresses IP mappés dont les entrées sont en conflit avec d'autres mappages.
- -decommissionhost | -dh
Utilisez cette option pour désactiver un hôte client du domaine NetBackup.
- -delete | -d
Utilisez cette option pour supprimer l'ID d'hôte pour le mappage de nom d'hôte ou d'adresse IP.
- -deletecomment | -dc
Utilisez cette option afin de supprimer un commentaire pour l'hôte ou l'ID d'hôte spécifié. Cette option supprime le commentaire associé à l'hôte principal.
Si vous essayez de supprimer un commentaire inexistant pour un hôte avec l'option nbhostmgmt-deletecomment, nbauditreport affiche une entrée correspondante pour une mise à jour réussie.
- -force
Utilisez cette option pour forcer l'opération de désactivation.
- -help | -h
Affiche le message d'utilisation de ligne de commande.
- -host | -n
Spécifie le nom d'hôte principal ou un autre nom d'hôte ou adresse IP mappé. Pour les opérations add (ajouter) et delete (supprimer), assurez-vous que l'autre nom d'hôte ou adresse IP mappé est associé à un ID d'hôte unique.
Pour l'opération de désactivation, spécifie le nom d'hôte client à désactiver.
- -hostid | -i
Spécifie l'ID d'hôte NetBackup.
- -isshared | -is
Indique que vous voulez ajouter le nom de mappage en tant que partagé.
Remarque :
Utilisez -add sans l'option -isshared pour ajouter le premier partage. Ajoutez tous les partages supplémentaires avec l'option -isshared.
- -json | -j
Cette option génère des données au format
json
et les répartit sur plusieurs lignes.
- -json_compact | -jc
Cette option génère des données au format
json
sur une seule ligne
- -list | -li
Utilisez cette option pour répertorier les noms d'hôte ou les adresses IP mappés selon différents filtres. Vous pouvez répertorier selon les états suivants : approuvés, en attente d'approbation et noms ou adresses en conflit.
- -mappingname | -hm
Spécifie le nom d'hôte ou l'adresse IP à ajouter ou supprimer.
- -newhostname | -nh
Spécifie le nom du nouvel hôte principal à mettre à jour.
- -pending | -p
Utilisez cette option pour répertorier les noms d'hôte ou les adresses IP mappés en attente d'approbation.
- -reason | -r
Utilisez cette option pour spécifier la raison de l'action de commande. La chaîne de texte que vous entrez est capturée et affichée dans le rapport d'audit. Placez cette chaîne entre guillemets ("..."). Le champ Raison est limité à 512 caractères. Il ne peut pas commencer par un tiret (-) ni contenir un guillemet simple (').
- -server | -s
Indique le nom du serveur maître NetBackup avec lequel la communication doit être établie. La valeur par défaut de l'option -server est le premier nom de serveur répertorié dans le fichier
bp.conf
.
- -short | -l
Utilisez cette option pour répertorier les ID d'hôte et les noms d'hôte mappés uniquement.
- -updatehost | -uh
Utilisez cette option pour mettre à jour le nom d'un hôte principal.
EXEMPLES
Exemple 1 : ajout d'un ID d'hôte valide pour le mappage du nom d'hôte.
#nbhostmgmt - add -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 - mappingname testhost1 testhost1 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
Exemple 2 : ajout d'un ID d'hôte pour le mappage du nom d'hôte avec le nom d'hôte.
#nbhostmgmt -add -host testhost1 -mappingname testhost2 testhost2 is successfully mapped to 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0.
Exemple 3 : approbation d'un mappage en attente. Cet exemple montre l'approbation du mappage de testhost3 pour le nom d'hôte mappé host3.
#nbhostmgmt - add -host host3 - mappingname testhost3 testhost3 is successfully updated.
Exemple 4 : suppression d'un ID d'hôte du mappage de nom d'hôte avec un ID d'hôte.
#nbhostmgmt - delete -hostid 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 - mappingname testhost1 Mapping between testhost1 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
Exemple 5 : suppression d'un ID d'hôte du mappage de nom d'hôte avec un hôte.
#nbhostmgmt - delete -host fs001 - mappingname testhost4 Mapping between testhost4 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
Exemple 6 : suppression d'un ID d'hôte du mappage de nom d'hôte avec un hôte à partir du serveur principal spécifié.
#nbhostmgt -delete -server nbmaster01 -host fs001 -mappingname testhost3 Mapping between testhost3 and 0a0aa0a0-0000-0aa0-aa00-000a0a00a0a0 is removed.
Exemple 7 : désactivation d'un hôte avec un nom d'hôte.
#nbhostmgmt -dh -host testhost1 -reason "Protected by different primary"
Exemple 8 : désactivation d'un hôte avec un ID d'hôte.
#nbhostmgmt -decommissionhost -hostid 0a0aa0a0-0000-0aa0-aa00- 000a0a00a0a0 -reason "Protected by different primary"
VOIR AUSSI
Se reporter à bpnbat.