Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bparchive — archivage de fichiers sur le serveur NetBackup
Synopsis
[-p politique] [-s planification][-L journal_progression [-en]] [-S serveur_maître [,serveur_maître,...]] [-t type_politique] [-w [hh:mm:ss]] [-k "expression_mot_clé"] -f fichier_liste | noms_fichiers
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/netbackup/bin/.
Sur les systèmes Windows, le chemin de répertoire vers cette commande est install_path\NetBackup\bin\
DESCRIPTION
La commande bparchive traite les fichiers répertoriés sur la ligne de commande ou dans le fichier spécifié par l'option -f listfile. Les chemin d'accès des fichiers entrés peuvent correspondre à un nom de fichier ou un nom de répertoire. Si la liste de fichiers comprend un répertoire, elle archive tous les fichiers et sous-répertoires de ce répertoire et commence au niveau du répertoire lui-même.
Par défaut, vous revenez à l'invite système après avoir exécuté la commande bparchive. La commande fonctionne en arrière-plan et ne renvoie pas directement l'état d'achèvement. Utilisez l'option -w pour modifier la commande bparchive afin qu'elle fonctionne en premier plan et pour renvoyer l'état d'achèvement après une période spécifiée.
La commande bparchive enregistre des messages d'informations et des messages d'erreur dans un fichier journal de progression si le fichier est créé. Créez le fichier avant d'exécuter la commande bparchive et spécifiez l'option -L progress_log. Si la commande bparchive ne peut pas archiver certains des fichiers ou répertoires nécessaires, utilisez le journal de progression pour déterminer la raison de cet échec.
Si vous créez un répertoire avec un accès en écriture, la commande bparchive crée un fichier journal de débogage dans ce répertoire à utiliser pour le dépannage.
Pour les systèmes d'exploitation Windows, la variable nbu_dir_path est la suivante : install_path\NetBackup\logs\bparchive\.
Pour les systèmes UNIX, le répertoire est /usr/openv/netbackup/logs/bparchive/
.
NetBackup envoie un courrier électronique concernant l'état d'achèvement de l'archive vers la variable mail_address, si la variable USEMAIL = mail_address est spécifiée. La commande est entrée comme suit : les utilisateurs non-administrateurs l'indiquent dans le fichier $HOME/bp.conf
; les administrateurs l'indiquent dans le fichier /usr/openv/netbackup/bp.conf
. Ce message est envoyé lorsque le processus d'archive est terminé.
Les restrictions suivantes s'appliquent à cette commande :
Sur les systèmes UNIX : pour archiver un fichier à l'aide de la commande bparchive, vous devez être utilisateur root ou propriétaire et membre du groupe principal (en tant que propriétaire) afin d'effectuer une suppression. De plus, le fichier ne doit pas se trouver en lecture seule. Dans le cas contraire, NetBackup enregistre les fichiers mais ne peut pas réinitialiser les heures d'accès (
utime
) et ne les supprime pas du disque.Sur les systèmes d'exploitation Windows, pour archiver un fichier à l'aide de la commande bparchive, vous devez être autorisé à supprimer le fichier et celui-ci ne doit pas être en lecture seule. Dans le cas contraire, NetBackup enregistre les fichiers mais ne les supprime pas du disque.
Sur les systèmes UNIX : si vous spécifiez un fichier UNIX en tant que lien, la commande bparchive archive uniquement le lien, et non le fichier auquel il est associé.
la commande bparchive n'archive ni les entrées de répertoire contenant des caractères "." ou "..", ni les sauvegardes d'image de disque.
OPTIONS
- -p politique
Assigne un nom à la politique à utiliser pour l'archive utilisateur. Si cette option n'est pas spécifiée, le serveur NetBackup utilise la première politique trouvée comprenant le client et une planification de l'archive utilisateur.
- -s planification
Assigne un nom à la planification à utiliser pour l'archive utilisateur. Si cette option n'est pas spécifiée, le serveur NetBackup utilise la première planification d'archive utilisateur trouvée dans la politique en cours d'utilisation. (voir l'option -p.)
- -S serveur_maître
Pour les systèmes UNIX, cette option spécifie le nom du serveur maître NetBackup. Le paramètre par défaut correspond à la première entrée SERVER du fichier
/usr/openv/netbackup/bp.conf
.Pour les systèmes d'exploitation Windows, cette option spécifie le nom du serveur maître NetBackup. La valeur par défaut correspond au serveur spécifié en tant que serveur en cours dans l'onglet Serveurs de la boîte de dialogue Spécifier les ordinateurs NetBackup. Pour afficher cette boîte de dialogue, démarrez l'interface Sauvegarde, archivage et restauration sur le client. Cliquez ensuite sur Spécifier les ordinateurs NetBackup dans le menu Fichier.
- -t type_politique
Spécifie l'un des numéros suivants selon le type de politique. Le paramètre par défaut pour les clients Windows est égal à 13. Le paramètre par défaut pour tous les autres clients est égal à 0 :
0 = Standard
4 = Oracle
6 = Informix ON-BAR
7 = Sybase
13 = MS-Windows
15 = Microsoft SQL Server
16 = MS-Exchange-Server
19 = NDMP
Les types de politique suivants s'appliquent uniquement au serveur Enterprise NetBackup :
11 = DataTools-SQL-BackTrack
17 = SAP
18 = DB2
20 = FlashBackup
21 = Split-Mirror
39 = Enterprise-Vault
- -L journal_progression [-en]
Spécifie le nom du fichier dans lequel les informations de progression sont enregistrées.
Sur les systèmes d'exploitation UNIX, le nom de fichier doit commencer par /.
Par exemple :
netbackup/logs/user_ops/proglog
Voici un exemple pour les systèmes d'exploitation Windows :
NetBackup\logs\user_ops\proglog
.Par défaut, aucun journal de progression n'est utilisé.
Ajoutez l'option -en pour générer un journal de progression en anglais. Le nom du journal contient la chaîne _en. Cette option permet au personnel d'intervenir dans un environnement distribué sur lequel des journaux en plusieurs langues peuvent être crées sur plusieurs sites.
Seuls les chemins d'accès par défaut sont autorisés pour cette option et Veritas vous recommande d'utiliser les chemins d'accès par défaut. Si vous ne pouvez pas utiliser le chemin d'accès par défaut de NetBackup dans votre configuration, vous devez ajouter des chemins d'accès personnalisés à la configuration de NetBackup.
Pour plus d'informations sur l'ajout d'un chemin d'accès personnalisé, consultez la section "Option BPCD_WHITELIST_PATH pour les serveurs et clients NetBackup" du Guide de l'administrateur NetBackup, volume I.
- -w [hh:mm:ss]
NetBackup attend la fin des opérations du serveur avant de vous renvoyer à l'invite système.
Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Le fichier
/user/openv/msg/.conf
(UNIX) et le fichierinstall_path\VERITAS\msg\LC.CONF
(Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.Consultez la section "Spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
Vous pouvez éventuellement spécifier un temps d'attente en heures, minutes et secondes. Le temps d'attente maximum pouvant être spécifié est de 23:59:59. Si le temps d'attente arrive à expiration avant que l'archive ne soit terminée, l'exécution de la commande se termine et renvoie un code d'état mentionnant un délai. Cependant, la création de l'archive se poursuit sur le serveur.
Si vous utilisez l'option -w sans spécifier le temps d'attente ou si vous spécifiez la valeur 0 (zéro), NetBackup attend indéfiniment que l'opération se termine.
- -k expression_mot_clé
Spécifie une expression de mot-clé associé par NetBackup à l'image créée par cette opération d'archivage. Vous pouvez ensuite restaurer l'image en spécifiant l'expression de mot-clé à l'aide de l'option -k de la commande bprestore.
L'expression de mot-clé est une description textuelle de l'archive d'une longueur maximale de128 caractères. Tous les caractères imprimables sont acceptés, y compris l'espace (" ") et le point (".").
Entourez l'expression de guillemets doubles ("...") ou d'apostrophes ('...').
La chaîne NULL (vide) représente l'expression de mot-clé par défaut.
- -f fichier_liste
Spécifie un fichier (listfile) contenant une liste de fichiers à archiver et peut être utilisé à la place de l'option de nom de fichier (filenames). Dans le fichier listfile, ajoutez chaque chemin d'accès des fichiers sur une ligne distincte.
Le format de la liste des fichiers dépend des caractères qu'elle contient : espaces, sauts de ligne ou retours chariot dans les noms. Pour archiver les fichier ne contenant aucun espace ou de retours chariot dans les noms, utilisez le format suivant :
filepath
Chemin d'accès du fichier à archiver. Quelques exemples sur des systèmes UNIX incluent
/home, /etc
et/var.
Exemples sur les systèmes d'exploitation Windows :c:\Programs et c:\documents\old_memos
Pour archiver les fichiers contenant des espaces, des sauts de ligne ou des retours chariot dans les noms :
filepathlen filepath
La variable filepath correspond au chemin d'accès du fichier à archiver et la variable filepathlen correspond au nombre de caractères du chemin d'accès du fichier.
Chemin d'accès du fichier à archiver. Quelques exemples sur des systèmes UNIX incluent
/home
,/etc
et/var.
Exemples sur les systèmes d'exploitation Windows :c:\Programs et c:\documents\old_memos
Exemples sur les systèmes UNIX :
5 /home 4 /etc 4 /var 19 /home/abc/test file
Exemples sur les systèmes d'exploitation Windows :
11 c:\Programs 8 c:\winnt 22 c:\documents\old memos
- filenames
Cette option assigne un nom à un ou plusieurs fichiers à archiver et peut être utilisée à la place de l'option -f. Tous les autres fichiers spécifiés doivent s'afficher à la fin et après toutes les autres options.
EXEMPLES
Exemple 1 - Archivage d'un fichier unique :
Systèmes UNIX : bparchive /usr/user1/file1
Systèmes Windows : bparchive c:\usr\user1\file1
Exemple 2 - Archivage des fichiers répertoriés dans un fichier nommé archive_list :
bparchive -f archive_list
Exemple 3 - Association de l'expression de mot-clé "Archive My Home Directory 02/02/10" à l'archive d'un répertoire nommé kwc
et utilisation d'un journal de progression nommé arch.log :
Systèmes UNIX : bparchive -k "Archive My Home Directory 02/02/10" \-L /usr/openv/netbackup/logs/user_ops/arch.log /home/kwc
Systèmes Windows : bparchive -k "Archive My Home Directory 02/02/10" \-L c:\Program Files\Veritas\NetBackup\logs\user_ops\arch.log c:\home\kwc