Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpsturep — remplace les attributs d'unité de stockage sélectionnés de NetBackup
Synopsis
-label label_unité_stockage [-verbose] [-host nom_hôte | -nodevhost] [-path chemin_accès | -dp pool_disques | -density densité [-rt type_robot -rn numéro_robot] [-nh hôte_attache_ndmp] [-cj max_travaux] [-odo indicateur_demande_uniquement] [-mfs taille_max_fragment] [-maxmpx facteur_multiplexage] [-cf fichiers_clear] [-flags indicateurs] [-tt limitation_transfert] [-hwm borne_haute] [-lwm borne_basse] [-okrt ok_racine] [[-addhost | -delhost] nom_hôte [nom_hôte]] [-hostlist nom_hôte [nom_hôte]] [-M serveur_maître [,...]
-group groupe_unité_stockage [-addstu | -delstu] label_unité_stockage [-M serveur_maître [,...]] [-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 bpsturep modifie une unité de stockage existante de NetBackup en remplaçant des attributs sélectionnés d'unité de stockage ou de groupe d'unités de stockage dans le catalogue NetBackup. La ligne de commande doit inclure une étiquette pour l'unité de stockage ou un nom de groupe pour le groupe d'unités de stockage. L'étiquette ou le nom de groupe est le seul attribut d'unité de stockage que bpsturep ne peut pas modifier.
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.
Utilisez la commande bpsturep avec soin. Les modifications de l'unité de stockage ou du groupe d'unités de stockage doivent être compatibles avec les attributs existants. Assurez-vous que les combinaisons d'attributs résultantes sont valides, particulièrement pour les attributs suivants :
robot_type robot_number density_type max_fragment_size path_type NDMP_attach_host
La manière la plus sûre de modifier ces attributs est d'exécuter bpsturep une fois pour que chaque attribut soit remplacé.
bpsturep apporte les modifications en modifiant l'unité de stockage avec les modifications d'attribut spécifiées. Exécutez bpstulist après bpsturep pour déterminer si les modifications souhaitées ont été appliquées.
Les erreurs sont transmises à stderr
. Un journal consignant l'activité de la commande est envoyé au fichier journal d'administration de NetBackup pour le jour en cours.
Pour plus d'informations sur les unités de stockage, consultez le Guide de l'administrateur NetBackup, Volume I.
Tout utilisateur disposant des autorisations nécessaires peut 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édias NBU d'exécuter des opérations de traduction de données sur des 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
Le nombre maximal de travaux simultanés autorisés pour cette unité de stockage. max_jobs est un entier non négatif. La valeur appropriée dépend de la capacité de votre serveur à exécuter des processus de sauvegarde multiples aisément et de l'espace disponible sur les médias de stockage.
Pour plus d'informations sur le nombre maximal de travaux par politique, consultez le Guide de l'administrateur NetBackup, Volume I.
Zéro (0) signifie que cette unité de stockage n'est jamais sélectionnée quand un travail est planifié. La valeur par défaut est 1.
- -density type_densité
Si cette option est activée, le type d'unité de stockage correspond au composant Media Manager. Ceci n'est pas une option par défaut. Si la ligne de commande inclut un type de robot, la valeur pour la densité devrait être compatible avec le type de robot. Vous ne pouvez associer les options -density, -path et -dp.
Les types de densité valides sont :
dlt - cartouche DLT
dlt2 - remplacement de cartouche de DLT
8mm - cartouche 8mm
4mm - cartouche 4mm
QSCSI - Cartouche de quart de pouce
Remarque :
Les densités suivantes s'appliquent uniquement aux serveurs Enterprise NetBackup.
hcart - cartouche demi-pouce
hcart2 - remplaçant de cartouche de pouce de 1/2
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. Cette option peut être utilisée seulement quand le type de disque est 6 (DiskPool). 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
Le nom d'un groupe d'unités de stockage. Ce groupe est l'unité de stockage dont les membres sont ajoutés ou supprimés par bpsturep. Utilisez -addstu storage_unit pour ajouter des unités de stockage au groupe. Utilisez -delstu storage_unit pour supprimer des unités de stockage du groupe.
- -host host_name
Remarque :
Le serveur NetBackup ne prend pas en charge les serveurs de médias distants.
L'hôte NetBackup auquel le média d'emplacement est fixé. Le paramètre par défaut correspond au nom d'hôte du système local.
L'hôte que vous sélectionnez doit être votre serveur maître NetBackup ou un serveur de médias (si vous configurez des serveurs de médias). 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 host_name est un nom réseau valide et n'est pas encore configuré, la valeur host_name est ajoutée à la configuration de NetBackup en tant que serveur de médias. Sous UNIX, cette valeur s'affiche dans bp.conf ; sous Windows, cette valeur s'affiche dans la fenêtre Configuration pour les serveurs. Si la variable host_name ne correspond pas à un nom de réseau valide, vous devez le configurer manuellement.
- -hwm borne_haute
Cette option est un seuil configurable par utilisateur. Le paramètre par défaut pour la borne haute est 98%. Quand la borne haute est atteinte, NetBackup devient proactif, dans deux circonstances différentes :
- Quand il lance un travail et toute la capacité est utilisée, le DSU est considéré plein. S'il sélectionne à partir des unités multiples de stockage dans un groupe d'unités de stockage, ce qui suit se produit : La sélection de médias et de périphérique (MDS) n'attribue pas de nouveaux travaux aux unités qui atteignent la borne haute ou sont au-dessus. Elle recherche une autre unité de stockage dans le groupe, pour l'attribuer au travail.
- Pendant un travail, si l'attribut Staging est défini et toute la capacité est utilisée, la présentation expire les images pour libérer de l'espace sur le DSU. Cette action se produit pour permettre davantage de données de sauvegarde.
- -label label_unité_stockage
Le nom d'une unité de stockage. Cette unité est l'unité de stockage dont les attributs sont remplacés par bpsturep. Cette option est obligatoire. 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, que les unités de stockage sur disque qui font la sauvegarde intermédiaire utilisent. Le paramètre par défaut pour la borne basse est 80 %.
Quand la borne haute est atteinte, vous devriez effectuer 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 du disque pour les images intermédiaires les plus anciennes jusqu'à ce que la borne basse soit atteinte.
Remarque :
Si vous voulez enregistrer la majeure partie de vos données disponibles, configurez le paramètre Borne basse près de la borne haute. En outre, la borne basse doit être inférieure à la borne haute. Ces paramètres ne peuvent être identiques.
- -mfs taille_max_fragment
Taille maximum de fragment spécifiée, en Mo (taille maximale d'un fragment pour une image NetBackup). NetBackup prend en charge une taille maximale de fragment de 1 000 000 méga-octets (soit un téraoctet).
Pour une unité de stockage de Media Manager, cette valeur est de zéro. Ou elle peut être n'importe quel entier supérieur ou égal à 50 méga-octets (Mo) et inférieur ou égal à 1 048 576 méga-octets (Mo) ou (1024 Go). La valeur par défaut est 0, qui est équivalente à la plus grande valeur qui est permise, 1024 Go.
Pour une unité de stockage sur disque, cette valeur va de 20 méga-octets à 2000 méga-octets (2 gigaoctets). La valeur par défaut est 524288 (512 Go).
- -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.
Le facteur de multiplexage peut s'étendre de 1 à 32, où un (1) signifie aucun multiplexage. Une valeur supérieure à un (1), cela signifie que NetBackup peut créer des images multiplexées sur le média cible. Selon la licence attribuée à l'installation locale de Netbackup, vous pouvez ne pas être en mesure d'assigner des facteurs de multiplexage dans la plage entière de 1 à 32. La valeur par défaut est 1.
- -M serveur_maître [,...]
Liste les 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 maîtres doivent autoriser l'accès par le système ayant émis la commande. En cas d'erreur sur un serveur maître quelconque, le processus s'interrompt à l'entrée de ce serveur dans la liste. Par défaut, il s'agit du serveur maître du système sur lequel la commande est entrée.
- -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
Indique qu'aucun serveur de médias ne doit être associé à cette unité de stockage.
- -odo indicateur_demande_uniquement
L'indicateur on-demand-only contrôle si l'unité de stockage est utilisée seulement pour les sauvegardes qui demandent explicitement (demande) 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 le type d'unité de stockage est disque, le paramètre par défaut est 1 ; NetBackup utilise l'unité de stockage seulement une fois explicitement demandé. Dans le cas contraire, la valeur par défaut est de 0 (zéro).
- -okrt ok_racine
Si cet indicateur n'est pas défini, ni les sauvegardes ni la création de répertoire ne se produisent sur le système de fichiers racine. Si l'indicateur ok_on_root est défini, alors les sauvegardes et les créations de répertoire se produisent normalement.
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).
Sous les systèmes UNIX, la racine est "/".
Sous Windows, la racine est le volume où se trouve le dossier windows\system.
- -path chemin_accès
Le chemin d'accès à un système de fichiers, exprimé comme un nom d'accès absolu, la zone de stockage de données pour cette unité de stockage. Quand cette option est présente, le type d'unité de stockage est Disk. Ceci n'est pas une option par défaut. Vous ne pouvez associer les options -density, -path et -dp.
En général quand cette option est utilisée, activez l'indicateur de on-demand-only (voir -odo). Autrement, si vous avez des politiques de NetBackup qui ne requièrent pas une unité de stockage spécifique, elles peuvent remplir le système de fichiers path_name. Cette action peut provoquer de graves problèmes de dysfonctionnement sur le système. Par exemple, si la zone de swap de système s'avère justement être sur le système de fichiers, les nouveaux processus peuvent échouer.
Si le nom du chemin d'accès est défini comme unité de stockage de sauvegarde intermédiaire (DSSU), utilisez cette option pour modifier le nom du chemin d'accès pour utiliser un DSSU différent. Il ne peut pas être utilisé pour modifier un DSSU en un type différent d'unité de stockage.
- -rn numéro_robot
Nombre de robots de cette unité de stockage. Le nombre de robots doit être supérieur ou égal à 0. Le nombre de robots peut être obtenu de la gestion des médias et des périphériques de la console d'administration. Cette option n'est pas prise en compte, à moins que l'option -rt ne soit spécifiée. Ceci n'est pas une option par défaut.
Pour plus d'informations sur les règles d'utilisation du nombre de robots, consultez, sur 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 pour la densité doit être compatible avec le type de robot
Si cette option est définie à n'importe quelle valeur autre que NONE, l'option -rn est requise.
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
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. Voici les valeurs possibles :
Prioritized = 1 (DEFAULT) Least Recently Selected = 2 Failover = 3
Equilibrage de la charge = 4 (apparaît si la licence de gestion des capacités est installée)
Option 1 : Prioritaire est la condition par défaut. Il sélectionne la première unité de stockage dans la liste jusqu'à ce que l'unité soit désactivée ou pleine ou son paramètre de nombre maximum de travaux concurrents 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. Pour que cette option soit visible, assurez-vous d'avoir installé la licence de gestion des capacités. Si l'utilisateur sélectionne cette option, le périphérique Sélection de médias (MDS) équilibre la charge de travail en considérant si un serveur de médias remplit ces conditions :
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 la licence expire, alors Equilibrage de la charge retourne au comportement de l'option 2. Il sélectionne l'unité de stockage sélectionnée le moins récemment.
- -tt limitation_transfert
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 verbose pour la consignation. Cette option est significative seulement lorsqu'elle s'exécute avec la fonction de débogage de journal (c'est-à-dire, quand le répertoire suivant est défini) :
Systèmes UNIX :
/usr/openv/netbackup/logs/admin
Systèmes Windows :
install_path\NetBackup\logs\admin
EXEMPLE
Systèmes UNIX :
Modifiez le chemin d'accès de mkbunit de l'unité de stockage sur disque. Le chemin d'accès est modifié de /tmp/mkbunit
à /tmp/mkbunit2
:
# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path /tmp/mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 /tmp/mkbunit2 1 1 2000 *NULL*
Windows systems:
Modifiez le chemin d'accès de mkbunit de l'unité de stockage sur disque. Le chemin d'accès est modifié de C:\tmp\mkbunit à C:\tmp\mkbunit2 :
# bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit 1 1 2000 *NULL* # bpsturep -label mkbunit -path C:\tmp\mkbunit2 # bpstulist mkbunit 0 beaver 0 -1 -1 1 0 C:\tmp\mkbunit2/ 1 1 2000 *NULL*
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/*
Systèmes Windows :
chemin_installation\NetBackup\logs\admin\*
Base de données EMM