Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpstuadd — création d'une unité ou d'un groupe d'unités de stockage NetBackup
Synopsis
-label label_unité_stockage -path chemin_accès [-dt type_disque] | -dp pool_disques [-dt type_disque] | -density type_densité [-rt type_robot -rn numéro_robot] [-host nom_hôte] [-cj max_travaux] [-odo indicateur_demande_uniquement] [-flags indicateurs] [-cf fichiers_clear] [-tt limitation_transfert] [-hwm borne_haute] [-lwm borne_basse] [-okrt ok_racine] [-mfs taille_max_fragment] [-maxmpx facteur_multiplexage] [-nh hôte_attache_ndmp] [-nodevhost] [-verbose] [-hostlist nom_hôte...] [-M serveur_maître,...] [-reason "chaîne"]
-group groupe_unité_stockage label_unité_stockage ... [-sm méthode_sélection]
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 bpstuadd crée une unité de stockage ou un groupe d'unités de stockage NetBackup. Lorsque vous créez une unique unité de stockage, assurez-vous d'ajouter un label pour la nouvelle unité de stockage : option -density, -path ou -dp. La commande bpstuadd ne peut pas créer l'unité de stockage si le serveur maître a déjà créé le nombre maximal d'unités de stockage autorisé par la configuration NetBackup. La commande ne crée aucune unité de stockage spécifiant le même média d'emplacement comme unité de stockage existante.
Remarque :
Cette commande ne permet pas de modifier une unité de stockage sur disque ou une unité de stockage sur bande vers une unité de stockage de sauvegarde intermédiaire. De plus, vous ne pouvez pas convertir unité de stockage de sauvegarde intermédiaire en unité de stockage sur disque ou en unité de stockage sur bande.
NetBackup contient plusieurs types d'unités de stockage. Le type d'unité de stockage affecte la manière dont NetBackup enregistre les données. Les options de la ligne de commande bpstuadd permettent d'établir l'un des éléments suivants :
Disque : emplacement de stockage correspondant à un répertoire système de fichiers sur un disque, un pool de disques ou les deux.
Sauvegarde intermédiaire. une unité de stockage de sauvegarde intermédiaire traitant automatiquement (balayage planifié) les images de l'unité de stockage de sauvegarde intermédiaire et les envoyant vers l'unité de stockage finale.
Media Manager : emplacement de stockage correspondant à un périphérique de bande géré par le composant Media Manager.
NDMP. Un serveur NDMP correspondant à une unité de stockage contrôlée par le composant Media Manager. Pour utiliser cet élément, vous devez installer NetBackup for NDMP. Dans cette description de commande, les références aux types d'unités de stockage du composant Media Manager s'appliquent également au type d'unités de stockage NDMP, sauf mention contraire. Les médias d'une unité de stockage NDMP sont toujours associés directement à un hôte NDMP et ne peuvent pas être utilisés pour enregistrer des données pour d'autres clients NetBackup. Pour définir une unité de stockage NDMP, exécutez la commande bpstuadd sur le serveur maître.
Pour plus d'informations sur l'ajout d'unités de stockage NDMP, consultez le Guide de l'administrateur NetBackup for NDMP.
Les erreurs sont transmises à stderr. Un journal des activités de commande est envoyé quotidiennement au fichier journal d'administration NetBackup.
Pour plus d'informations sur les unités de stockage, consultez le Guide de l'administrateur NetBackup, volume II.
Seuls les utilisateurs autorisés peuvent exécuter cette commande.
Pour plus d'informations sur l'autorisation NetBackup, consultez le Guide de sécurité et de chiffrement NetBackup.
OPTIONS
- -cf fichiers_clear
Permet au média NetBackup d'exécuter des opérations de traduction sur les données de sauvegarde. Généralement, les plug-ins OpenStorage utilisent les métadonnées pour exécuter les opérations de déduplication au niveau des blocs qui réduisent la quantité totale d'espace disque utilisée. Cette valeur est valide uniquement pour les unités de stockage sur disque configurées avec des pools de disques OST.
La variable clearfiles peut renvoyer l'une des valeurs suivantes :
0 - Désactive toutes les opérations de traduction de données.
1 - Active l'opération de traduction détaillée. Les métadonnées décrivent tous les attributs des fichiers sauvegardés. Ces fichiers sont appelés fichiers "clear".
2 - Active l'opération de traduction simple. Les métadonnées identifient uniquement le nom, la taille et l'emplacement de décalage d'octets des fichiers sauvegardés. Il s'agit des fichiers "opaque".
- -cj max_travaux
Spécifie le nombre maximal de travaux simultanés de cette unité de stockage. La variable max_travaux doit être un nombre entier non négatif. Pour définir correctement cette valeur, cela dépend des capacités du serveur à exécuter rapidement plusieurs processus de sauvegarde et de l'espace disponible sur les médias de stockage.
Pour plus d'informations sur le nombre de travaux maximum par client, consultez le Guide de l'administrateur NetBackup, volume I.
Lorsque l'option max_jobs est définie sur 0 (zéro), cela signifie que cette unité de stockage n'est jamais sélectionnée lorsqu'un travail est planifié. La valeur par défaut est 1.
- -density type_densité
Spécifie le type de densité des médias. Si cette option est activée, le type d'unité de stockage correspond au composant Media Manager. Cette option ne contient aucune valeur par défaut. Vous devez spécifier l'une de ces options sur la ligne de commande : -density, -path ou -dp. Si vous avez spécifié le type de robot sur la ligne de commande, la valeur de la densité (density) doit correspondre au type de robot. Vous ne pouvez associer les options -density, -path et -dp.
Les valeurs autorisées pour le type de densité (density_type) sont les suivantes :
dlt - cartouche DLT
dlt2 - autre cartouche DLT
8mm - cartouche 8 mm
4mm - cartouche 4 mm
qscsi - cartouche de quart de pouce
Remarque :
NetBackup prend en charge les densités suivantes pour les serveurs NetBackup Enterprise :
hcart - cartouche demi-pouce
hcart2 - autre cartouche demi-pouce
dtf - cartouche DTF
- -dp pool_disques
Spécifie le nom du pool de disques correspondant à la zone de stockage des données de cette unité de stockage. Vous devez utiliser un pool de disques existant.
- -dt type_disque
Permet à l'utilisateur de spécifier un type de disque. Vous pouvez spécifier les valeurs suivantes pour le type de disque (disk_type) :
1 - BasicDisk
3 - SnapVault
6 - DiskPool
- -flags indicateurs
Spécifie l'unité de stockage en tant qu'unité de stockage intermédiaire. Cela permet d'effectuer restauration rapide. Les valeurs autorisées pour les indicateurs (flags) sont les suivantes : NONE et STAGE_DATA. Ces valeurs sont actuellement autorisées pour les unités de stockage sur disque uniquement.
- -group groupe_unité_stockage label_unité_stockage...
Ajoute un groupe d'unités de stockage et spécifie le nom du groupe et les unités de stockage constituant le groupe. Si vous ajoutez plusieurs unités de stockage au groupe, séparez-les par des espaces. La longueur maximale d'une étiquette d'unité de stockage est de 128 caractères.
- -host host_name
Indique un serveur de médias unique associé à l'unité de stockage. Vous ne pouvez sélectionner que ce serveur de médias pour lire ou enregistrer des données sur l'unité de stockage. Le paramètre par défaut correspond au nom d'hôte du système local.
Remarque :
Le serveur NetBackup ne prend pas en charge les serveurs de médias distants.
L'hôte sélectionné doit correspondre au serveur maître NetBackup ou à un serveur de médias distant (si vous avez configuré des serveurs de médias distants). Le nom d'hôte doit correspondre au nom de réseau du serveur référencé par les serveurs et les clients NetBackup.
Si la variable host_name correspond à un nom de réseau valide et si ce dernier n'a pas été configuré précédemment dans NetBackup, il est ajouté à la configuration NetBackup en tant que serveur de médias. Pour UNIX, ce serveur s'affiche comme une entrée de server (SERVER) du fichier
bp.conf
. Pour sous Windows, l'option Propriétés de l'hôte spécifie le serveur dans la liste Serveurs. Si la variable host_name ne correspond pas à un nom de réseau valide, vous devez le configurer manuellement.
- -hostlist nom_hôte...
Vous devez utiliser un sous-ensemble de serveurs de médias ayant accès au stockage avec cette option. Utilisez cette option si les serveurs contenant plusieurs médias partagent un pool de disques. Si vous voulez dédier un ensemble de serveurs de médias à un ensemble de politiques et de clients, vous devez définir un autre ensemble contenant d'autres politiques et d'autres clients (ou pour un rôle spécifique comme les travaux de duplication).
- -hwm borne_haute
Spécifie le taux de remplissage maximal d'une unité de stockage sur disque. Cette option est un seuil configurable par utilisateur. La plage de valeurs autorisées pour la borne haute se situe entre 0 et 100 (pourcentage). Le paramètre par défaut est de 98 %. Lorsque la borne haute est atteinte, NetBackup intervient dans les deux cas suivants :
Lorsque vous exécutez un travail et que tout l'espace est utilisé, l'unité de stockage sur disque est considérée comme pleine. Si vous sélectionnez une unité de stockage d'un groupe d'unités de stockage, les événements suivants se produisent : La sélection de média et de périphérique n'assigne aucun nouveau travail à une unité de stockage ayant dépassé la valeur de la borne haute. Elle recherche plutôt une autre unité de stockage dans le groupe pour assigner le travail.
Lors d'un travail, si un attribut intermédiaire est défini et si tout l'espace est utilisé, l'attribut intermédiaire fait expirer toutes les images pour libérer de l'espace sur l'unité de stockage sur disque. Cette action permet d'augmenter le nombre de sauvegardes.
- -label label_unité_stockage
Spécifie le nom de l'unité de stockage. Vous devez spécifier cette option à moins que vous n'utilisiez l'option -group. La longueur maximale de l'étiquette d'une unité de stockage est de 128 caractères.
- -lwm borne_basse
Cette option est un seuil configurable par l'utilisateur. Les unités de stockage sur disque faisant appel à des sauvegardes intermédiaires utilisent la valeur de cette option. La plage de valeurs autorisées pour la borne basse se situe entre 0 et 100 (pourcentage). Le paramètre par défaut est de 80 %.
Lorsque la borne haute est atteinte, effectuez l'une des opérations suivantes :
Migrez les images vers d'autres unités de stockage jusqu'à ce que la borne basse soit atteinte.
Libérez de l'espace disque en faisant expirer les images disque des images intermédiaires les plus anciennes jusqu'à ce que la borne basse soit atteinte.
Si vous voulez enregistrer la plupart de vos données, configurez la valeur de la borne basse sur une valeur proche de la borne haute.
- -M master_server,...
Liste des serveurs maîtres. Cette liste de noms d'hôtes est délimitée par des virgules. Si cette option est activée, la commande est exécutée sur chacun des serveurs maîtres de cette liste. Les serveurs doivent en garantir l'accès par le biais du système ayant exécuté la commande. En cas d'erreur sur un serveur maître quelconque, le processus s'interrompt sur ce serveur. Par défaut, il s'agit du serveur maître du système sur lequel la commande est entrée.
- -maxmpx facteur_multiplexage
Le facteur de multiplexage maximal. Le multiplexage envoie les sauvegardes multiples, simultanées d'un ou plusieurs clients vers un lecteur unique.
Pour plus d'informations sur le multiplexage (MPX), consultez le Guide de l'administrateur NetBackup, Volume I.
La plage de valeurs du facteur de multiplexage s'étend entre 1 à 32. Le paramètre par défaut est de 1 (aucun multiplexage). Une valeur supérieure à un (1), cela signifie que NetBackup peut créer des images multiplexées sur le média cible. La licence détermine le sous-ensemble pertinent de la plage 1 à 32 pour l'installation locale de NetBackup.
- -mfs taille_max_fragment
Spécifie la taille maximale des fragments en méga-octets ou la taille du fragment d'une image NetBackup. NetBackup prend en charge une taille maximale de fragment de 1 000 000 méga-octets (soit un téraoctet).
Pour les médias amovibles, cette valeur est égale à 0 (zéro) ou tout nombre entier compris entre 50 (méga-octets) et 1 048 576 (méga-octets) (1 024 Go) inclus. La valeur par défaut est de 0. Cela signifie une valeur maximale de 1 048 576 Mo.
Pour une unité de stockage sur disque, cette plage de valeurs est comprise entre 20 Mo et 512 000 Mo (512 Go). La valeur par défaut est 512,000 Mo.
- -nh hôte_attache_ndmp
Spécifie le nom d'hôte du serveur NDMP. Si cette option est activée, le type d'unité de stockage est défini sur NDMP. La valeur par défaut ne représente aucun serveur NDMP.
- -nodevhost
Cette option Indique qu'aucun serveur de médias n'est associé à cette unité de stockage. Vous pouvez sélectionner un serveur de médias quelconque ayant accès au stockage pour déplacer les données (telles que les opérations de sauvegarde, de duplication ou de restauration).
- -odo indicateur_demande_uniquement
L'indicateur A la demande uniquement (on_demand_only_flag) contrôle uniquement les conditions dans lesquelles NetBackup utilise l'unité de stockage :
Pour mettre l'unité de stockage à disposition uniquement des politiques ou des planifications qui le demandent, définissez l'indicateur sur 1 (activé).
Pour mettre l'unité de stockage à disposition de toutes les politiques ou les planifications, définissez l'indicateur sur 0 (désactivé).
Si l'unité de stockage correspond à un disque, le paramètre par défaut est de 1. NetBackup utilise l'unité de stockage en cas de demande explicite. Dans le cas contraire, la valeur par défaut est de 0 (zéro).
Les unités de stockage de sauvegarde intermédiaire sont fournies à la demande de l'utilisateur. Vous devez les sélectionner explicitement en tant que cible de sauvegarde.
- -okrt ok_racine
Si cet indicateur n'est pas défini, aucune sauvegarde n'est effectuée sur le système de fichiers racine et aucun répertoire n'y est créé. Si l'indicateur ok_on_root est défini, les sauvegardes sont effectuées et les répertoires sont créés.
La valeur par défaut de cet indicateur est de 0 (zéro). Si le chemin d'accès se trouve sur le système de fichiers racine, les sauvegardes sont effectuées et les répertoires sont créés sur une unité de stockage sur disque (BasicDisk).
- -path chemin_accès
Spécifie le chemin d'accès d'un système de fichier sous forme de nom d'accès absolu. Il s'agit de la zone de stockage de données de cette unité de stockage. Lorsque cette option est spécifiée, l'unité de stockage correspond à un disque. Cette option ne contient aucune valeur par défaut. Vous devez spécifier l'une de ces options sur la ligne de commande : -path, -dp ou -density. Vous ne pouvez associer les options -density, -path et -dp.
En règle générale, lorsque cette option est utilisée, l'indicateur A la demande uniquement est activé (voir la commande -odo). Dans le cas contraire, si aucune politique NetBackup fait appel à une unité de stockage en particulier, vous pouvez utiliser le nom de cette politique comme chemin d'accès (path_name) du système de fichiers sur le disque. Cette action peut provoquer de graves problèmes de dysfonctionnement sur le système. Par exemple, si la zone d'échange du système se trouve sur le système de fichiers, cela peut empêcher l'exécution de nouveaux processus.
- -reason "chaîne"
Indique la raison pour laquelle vous choisissez cette action de commande. La chaîne de texte de raison que vous entrez est capturée et apparaît dans le rapport d'audit. Entourez cette chaîne avec des guillemets ("… "). La chaîne ne doit pas dépasser 512 caractères. Elle ne peut pas commencer par un tiret (-) ni contenir un guillemet simple (').
- -rn numéro_robot
Spécifie le numéro de robot de cette unité de stockage. Ce numéro doit être supérieur ou égal à 0. Vous pouvez obtenir le numéro de robot à partir du gestionnaire de périphériques et de médias de la console d'administration. Cette option n'est pas prise en compte, à moins que l'option -rt ne soit spécifiée. Cette option ne contient aucune valeur par défaut.
Pour plus d'informations sur les règles d'utilisation du numéro de robot, consultez le Guide de l'administrateur NetBackup, volume II.
- -rt robot_type
Type de robot de cette unité de stockage. Pour les périphériques (autonomes) non robotiques, sélectionnez AUCUN ou ne spécifiez aucune option. La valeur par défaut est AUCUN - Non robotique. La valeur de la densité doit être compatible avec le type de robot.
Si cette option est définie sur une autre valeur que le paramètre AUCUN, vous devez spécifier l'option -rn. Les codes de type de robot sont les suivants :
AUCUN - Non robotique
TLD - bandothèque DLT
ACS - système de cartouche automatisé
TL8 - bandothèque 8 mm
TL4 - bandothèque 4 mm
TLH - Bandothèque demi-pouce
TLM - bandothèque multimédia
- -sm méthode_sélection
Définit la méthode de sélection d'un groupe d'unités de stockage. Vous ne pouvez utiliser cette option que pour des groupes d'unités de stockage. Les valeurs de méthode de sélection (selection_method) sont les suivantes :
1 = Prioritaire (paramètre par défaut)
2 = La moins sélectionnée récemment
3 = Basculement
4 =Equilibrage de la charge
Option 1 : Prioritaire, sélectionne la première unité de stockage de la liste jusqu'à ce que l'unité soit arrêtée, pleine ou que le nombre maximal de travaux simultanés soit atteint. Les unités de stockage de la liste sont ensuite examinées une par une jusqu'à ce qu'une unité disponible soit trouvée.
Option 2 : Sélectionné le moins récemment, sélectionne l'unité de stockage sélectionnée le moins récemment.
Option 3 : Basculement, cette valeur est identique à la valeur Prioritaire, sauf que la fonction de sélection des périphériques de média met un travail en file d'attente en attendant la première unité de stockage, si le nombre maximal de travaux simultanés est atteint. La fonction de sélection des périphériques de média passe à l'unité de stockage suivante dans la liste uniquement si la première unité est arrêtée ou pleine.
Option 4 : Répartition de charge. Si l'utilisateur sélectionne cette option et s'il a installé la licence de gestion des capacités, la fonction de sélection des périphériques de média (MDS) équilibre la charge de travail. Elle équilibre la charge de travail en vérifiant si les serveurs de médias remplissent les conditions suivantes :
Vous disposez d'un espace disque disponible suffisant pour la taille estimée du travail.
Vous disposez d'un nombre de ressources UC suffisant et d'assez de mémoire pour prendre en charge un autre travail.
La taille estimée du travail en cours de traitement doit être inférieure à la taille des travaux des autres serveurs de médias de la même classe ou du même rang.
Si l'utilisateur ne dispose pas de la licence de gestion des capacités, la répartition de charge retourne alors à l'option 2, à savoir l'unité de stockage la moins récemment sélectionnée.
- -tt transfer_throttle
Le paramètre Limitation de transfert s'affiche uniquement pour les unités de stockage SnapVault.
Le paramètre indique la bande passante maximale du transfert des données de SnapVault. Un paramètre égal à zéro (paramètre par défaut) indique qu'une bande passante et un transfert de données illimités se produiront en utilisant la totalité de la bande passante du réseau. (Plage : 0 (paramètre par défaut) à 9999999.)
- -verbose
Sélectionnez le mode détaillé pour la consignation. Cette option est utile uniquement lorsqu'elle est exécutée avec la fonction de débogage de journal (à savoir : lorsque le répertoire suivant est défini) :
UNIX systems: /usr/openv/netbackup/logs/admin
Windows systems: install_path\NetBackup\logs\admin
EXEMPLES
Exemple 1 - Création d'une nouvelle unité de stockage nommée hatunit. Cette type d'unité de stockage doit être un disque.
Sur les systèmes UNIX, le chemin d'accès de l'unité de stockage est le suivant : /tmp/hatdisk
.
Sur les systèmes Windows, le chemin d'accès de l'unité de stockage est le suivant : C:\tmp\hatdisk
.
Systèmes UNIX :
# bpstuadd -label hatunit -path /tmp/hatdisk -verbose
Systèmes Windows :
# bpstuadd -label hatunit -path C:\tmp\hatdisk -verbose <2>bpstuadd: INITIATING: NetBackup 8.0 created: 0 <2>bpstuadd: EXIT status = 0.
Exemple 2 - Création d'une unité de stockage à l'aide d'un serveur UNIX qui n'a pas été configuré précédemment dans NetBackup :
Remarque :
L'exemple suivant se rapporte à des serveurs de médias distants et s'applique uniquement au serveur NetBackup Enterprise. Le serveur NetBackup prend en charge un seul serveur maître et aucun serveur de médias distant.
# bpstuadd -label parrot_stu -host parrot -density dlt -rt TLD -rn 2
Le serveur de médias distant "parrot" a été ajouté au fichier bp.conf
.
Vous devez également installer NetBackup et le composant Media Manager sur le serveur "parrot" et exécuter le fichier add_media_server_on_clients sur le serveur maître.
% grep parrot /usr/openv/netbackup/bp.conf SERVER = parrot
VALEURS DE RETOUR
Un code état de sortie 0 (zéro) signifie que la commande est exécutée.
Tout autre code d'état de sortie autre que zéro (0) signifie qu'une erreur s'est produite.
Si le journal d'administration est activé, la commande bpstuadd consigne l'état de sortie dans le journal d'administration quotidien se trouvant sous le répertoire de journaux :
Systèmes UNIX :
/usr/openv/netbackup/logs/admin
Systèmes Windows :
install_path\NetBackup\logs\admin
Le format est le suivant :
# bpstuaddnew: EXIT status = exit status
En cas d'erreur, un diagnostic s'affiche avant ce message.
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/*
Systèmes Windows :
install_path\NetBackup\logs\admin\*
Base de données EMM