Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpclient — gestion des entrées client sur un serveur maître
Synopsis
-All [-M master_server] [-l | -L | -H]
-client client_name [-M master_server] [-l | -L | -H]
-client client_name [-M master_server] -add | -update [-dynamic_address 0|1] [-free_browse 0|1|2] [-list_restore 0|1|2|3] [-max_jobs [1-99] [-current_host host_name] [[-online] | [-offline [[-ut] -onlineat time]] | [-online_backup] | [-offline_backup [[-ut] -online_backup_at time]] | [-online_restore] | [-offline_restore [[-ut] -online_restore_at time]]] [-WOFB_enabled 0|1] [-WOFB_FIM 0|1] [-WOFB_usage 0|1] [-WOFB_error 0|1] [-connect_options 0|1|2 0|1|2 0|1|2|3] [-granular_proxy granular_proxy_host] [-client_direct 0|1|2] [-client_direct_restore 0|1|2]
-client client_name [-M master_server] -delete
-client client_name -add_alias alias_name | -delete_alias alias_name [-M master_server]
-client client_name -add_all_aliases | -delete_all_aliases | -list_all_aliases [-M master_server]
-policy nom_politique -validate -fi
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/netbackup/bin/admincmd/
Sur les systèmes Windows, le chemin d'accès à cette commande est chemin_d'accès\NetBackup\bin\admincmd\
DESCRIPTION
La commande bpclient permet de connecter un serveur NetBackup aux clients NetBackup.
OPTIONS
- -add
Ajoute une entrée client.
- -add_alias | -delete_alias alias_name
Ajoute une nouvelle entrée pour un alias de client ou supprime une entrée d'alias de client existante.
- -add_all_aliases | -delete_all_aliases | -list_all_aliases
Effectue l'une des opérations suivantes :
-add_all_aliases ajoute une nouvelle entrée pour chaque alias de client.
-delete_all_aliases supprime tous les alias.
-list_all_aliases génère une liste de toutes les entrées d'alias.
- -All
Affiche toutes les entrées client. Seules les entrées client ajoutées de façon explicite avec commande bpclient s'affichent.
- -client client_name
Spécifie le nom du client à répertorier ou à mettre à jour.
- -client_direct 0 | 1 | 2
Client Direct améliore les performances de sauvegarde en utilisant le serveur de stockage OpenStorage au lieu du serveur de médias pour transférer les données vers le client. La définition de l'option -client_direct établit si le client utilise cette fonction et son emplacement. Les paramètres pris en charge sont les suivants :
0 = Ne jamais utiliser Client Direct comme méthode de transfert de données sur l'hôte spécifié. Utilise toujours la méthode de transfert de données standard. Il s'agit du paramètre par défaut.
1 = Préférer l'utilisation de la méthode Client direct. Recherche les capacités Client Direct sur le serveur de stockage identifié pendant la sauvegarde. Si des capacités sont trouvées, NetBackup utilise la méthode de transfert de données Client Direct sur le client spécifié. En cas d'échec de la sonde, la méthode de transfert de données standard est utilisée.
2 = Toujours utiliser la méthode Client direct. Tente d'utiliser uniquement la méthode Client Direct avec le client spécifié. En cas d'échec de cette méthode, le travail échoue également. Aucune autre méthode de transfert n'est tentée.
- -client_direct_restore 0 | 1 | 2
Client Direct Restore améliore les performances de restauration à l'aide du serveur de stockage OpenStorage au lieu du serveur de médias pour restaurer des données vers le client. La définition de l'option -client_direct établit si le client utilise cette fonction et son emplacement. Les paramètres pris en charge sont les suivants :
0 = Ne jamais utiliser Client Direct Restore comme méthode de transfert de données sur l'hôte spécifié. Utilise toujours la méthode de transfert de données standard. Il s'agit du paramètre par défaut.
1 = Utiliser Client Direct Restore. La commande recherche des fonctions Client Direct Restore sur le serveur de stockage identifié pendant la restauration. En cas de réussite de la recherche, NetBackup utilise la méthode de transfert de données de Client Direct Restore sur le client spécifié. En cas d'échec de la sonde, la méthode de transfert de données standard est utilisée.
2 = Toujours utiliser Client Direct Restore. Tente d'utiliser uniquement la méthode Client Direct Restore avec le client spécifié. En cas d'échec de cette méthode, le travail échoue également. Aucune autre méthode de transfert n'est tentée.
- -connect_options 0|1|2 0|1|2 0|1|2|3
Cette option s'applique uniquement aux noms de clients qui sont locaux pour le serveur NetBackup qui effectue la connexion.
Le premier lot d'arguments concernant les ports s'affiche comme suit :
0 = Port réservé : Utiliser un numéro de port réservé.
1 = Port non réservé : Connectez-vous à la commande bpcd du client à l'aide d'un numéro de port non réservé. Si vous sélectionnez cette option, activez l'option Autoriser les ports non réservés pour le client sélectionné.
2 = Utiliser le paramètre par défaut : Il s'agit du paramètre par défaut. Utilisez la valeur définie par l'entrée de configuration DEFAULT_CONNECT_OPTIONS sur le serveur.
Le deuxième lot d'arguments concernant les reconnexions BPCD s'affiche comme suit :
0 = Port aléatoire : NetBackup sélectionne de manière aléatoire un port libre parmi la plage autorisée pour effectuer une reconnexion standard.
1 = port VNETD : cette méthode ne requiert pas une reconnexion à un port aléatoire. La reconnexion se fait plutôtau Daemon Veritas Network ( vnetd). Le daemon Veritas Network a été conçu pour améliorer l'efficacité du pare-feu avec NetBackup pendant les communications entre serveurs ou entre serveurs et clients.
2 = Utiliser le paramètre par défaut : Cette option est l'option par défaut. Utilisez la valeur définie par l'entrée de configuration DEFAULT_CONNECT_OPTIONS sur le serveur.
Le troisième lot d'arguments (port de connexion du daemon) s'affiche comme suit :
0 = Automatique : Cette option signifie que le daemon VNETD est utilisé, le cas échéant. Dans le cas contraire, l'option héritée est utilisée.
1 = Utiliser le port Veritas Network.
2 = Utiliser le numéro de port hérité.
3 = Utiliser le paramètre par défaut : Cette option est l'option par défaut. Utilisez la valeur définie par l'entrée de configuration DEFAULT_CONNECT_OPTIONS sur le serveur.
Remarque :
Si le port de connexion du daemon vnetd est utilisé, le paramètre Reconnexion BPCD ne s'applique pas. Si le port de connexion du daemon vnetd est utilisé, les ports non réservés sont toujours utilisés, peu importe la valeur du paramètre Ports.
- -current_hostname host_name
Le nom d'hôte en cours du client. Cette option n'est utile que si l'option -dynamic_address 1 est utilisée. En règle générale, vous ne devez entrer aucune valeur pour le nom d'hôte en cours (current_hostname). En règle générale, le client contacte le serveur maître pour définir le nom d'hôte et l'adresse IP.
- -delete
Supprime une entrée de client existante.
- -dynamic_address 0 | 1
0 = Le nom du client est considéré comme un nom d'hôte valide pour le client (paramètre par défaut).
1 = Le client doit posséder un nom d'hôte dynamique (tel qu'un protocole DHCP).
- -fi
Valide les options de -snapshot_method_args dans la commande bpplinfo. Voir l'option - validate.
- -free_browse 0 | 1 | 2
Méthode permettant aux utilisateurs de contourner la vérification effectuée par le serveur lorsqu'il parcourt les images (propriétaire ou groupe). Par défaut, les utilisateurs standard ne sont pas autorisés à parcourir les sauvegardes planifiées sous Windows.
0 = Autoriser
1 = Refuser
2 = Utiliser
Par défaut, le client et le serveur doivent être définis sur 0 (Autorisation). Pour parcourir librement les sauvegardes, le client ou le serveur doit être défini sur 2 (Utilisation). Aucun des deux ne peut être défini sur 1 (Refus).
- -granular_proxy hôte_proxy_granulaire
Spécifie l'hôte granulaire de proxy de Windows pour un client source. Vous pouvez utiliser cette option quand vous dupliquez des images de sauvegarde qui sont activées par la technologie GRT.
- -H
Affiche les informations client de l'hôte.
- -l
Affiche les informations client sous forme abrégée.
- -L
Affiche les informations client sous forme détaillée.
- -list_restore 0 | 1 | 2 | 3
Cette option définit une valeur sur le serveur pour autoriser ou refuser les demandes de restauration ou de liste d'un client en particulier. La valeur dans la base de données client remplace le paramètre du fichier
bp.conf
.0 = Non spécifié (paramètre par défaut)
1 = Autoriser les demandes de restauration et de liste
2 = Autoriser uniquement les demandes de liste
3 = Refuser les demandes de restauration et de liste
- -M master_server
Nom du serveur maître contenant les entrées client. Le premier nom du serveur de la configuration locale correspond au serveur maître par défaut.
- -max_jobs [1-99]
Vous pouvez exécuter jusqu'à 99 travaux en simultané sur ce client. Vous pouvez configurer cet élément dans NetBackup Administration Console. Cet élément s'appelle "Nombre maximal de flux de données". Pour effectuer cette fonction à partir de l'interface graphique utilisateur, sélectionnez les éléments suivants : Propriétés de l'hôte cliquez deux fois sur le nom du serveur maître .
- -online | -offline
Définit l'état du client sur en ligne ou hors ligne pour les sauvegardes et les restaurations.
- -onlineat heure
Définit l'état du client sur en ligne pour les sauvegardes et les restaurations à l'heure indiquée.
- -online_backup | -offline_backup
Définit l'état du client sur en ligne ou hors ligne pour la sauvegarde.
- -online_backup_at heure
Définit l'état du client sur en ligne pour la sauvegarde à l'heure indiquée.
- -online_restore | -offline_restore
Définit l'état du client sur en ligne ou hors ligne pour la restauration.
- -online_restore_at heure
Définit l'état du client sur en ligne pour la restauration à l'heure indiquée.
- -policy policy_name
Spécifie le nom de la politique de sauvegarde à valider. Cette option est utilisée avec les options - validate et - fi.
- -update
Met à jour une entrée de client existante.
- -ut
Indique l'heure au format horaire UNIX.
- -validate
Lorsque vous utilisez des commandes NetBackup pour créer une politique basée sur les snapshots telle que VMware ou Hyper-V, cette option permet de valider la politique. Pour valider une politique créée à l'aide de la commande bpplinfo -snapshot_method_args, l'option - validate doit être utilisée avec l'option - fi.
Pour plus d'informations sur l'utilisation des commandes NetBackup pour créer une politique VMware ou Hyper-V, consultez le Guide NetBackup for VMware ou le Guide NetBackup for Hyper-V.
- -WOFB_enabled 0|1
0 = désactive Sauvegarde de fichiers ouverts sous Windows pour le client dans la variable client_name.
1 = active Sauvegarde de fichiers ouverts sous Windows pour le client dans la variable client_name.
- -WOFB_error 0 | 1
0 = Abandonner la sauvegarde en cas d'erreur. Spécifie qu'une sauvegarde est abandonnée si elle échoue pour un problème lié aux snapshots après que le snapshot a été créé et pendant que la sauvegarde utilise le snapshot pour sauvegarder les fichiers ouverts ou actifs sur le système de fichiers.
1 = Désactiver le snapshot et continuer. Indique que si le snapshot n'est plus valide lors de la sauvegarde, les snapshots des volumes de la sauvegarde seront détruits. La sauvegarde se poursuit et l'option Sauvegardes de fichiers ouverts sous Windows est désactivée.
- -WOFB_FIM 0 | 1
0 = utilise Volume Snapshot Provider (VSP) comme fournisseur de snapshots pour Sauvegardes de fichiers ouverts sous Windows. VSP est pris en charge uniquement sur les clients qui utilisent la version 6.x de NetBackup. Les clients qui utilisent la version 7.x de NetBackup prennent uniquement en charge VSS. Si vous exécutez un client de la version 7.x et sélectionnez VSP avec cette option, NetBackup exécute automatiquement le service VSS.
1 = utilise le service Volume Shadow Service (VSS) de Microsoft comme fournisseur de snapshots pour Sauvegardes de fichiers ouverts sous Windows.
- -WOFB_usage 0|1
0 = Snapshot de lecteur individuel Définit le snapshot en tant que lecteur individuel. Lorsque cette propriété est activée, la création de snapshot et la sauvegarde de fichiers sont effectuées de manière séquentielle par volume.
1 = Snapshot de lecteur global Indique que le snapshot vient d'un lecteur global. Les snapshots sont pris en même temps pour tous les volumes nécessitant des snapshots pour le travail de sauvegarde (ou des groupes de flux pour les sauvegardes contenant plusieurs flux).
EXEMPLES
Exemple 1 - Déterminer si le client hagar
est dans la base de données client sur le serveur maître :
# bpclient -client hagar -L
Exemple 2 - Ajouter casper
à la base de données client sur le serveur maître. Elle permet également l'exécution d'un maximum de 5 travaux en simultané sur le serveur casper
.
# bpclient -client casper -add -max_jobs 5
Exemple 3 - Répertorier en détails toutes les informations de client pour le client ollie
.
# bpclient -client ollie -L Client Name: ollie Current Host: Hostname: ollie IP Address: 0.0.0.0 Dynamic Address: no Free Browse: Allow List Restore: Not Specified Max Jobs This Client: Not Specified WOFB Enabled: yes WOFB FIM: VSP WOFB Usage: Individual Drive Snapshot WOFB Error Control: Abort on Error Client Direct: Prefer to use client-side deduplication or Prefer to move data direct to storage Client Direct Restore: Move data via media server OST Proxy: Off OST Proxy Server: Unspecified Connect options: 2 2 3