Guide de référence des commandes NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bparchive — archivage de fichiers sur le serveur NetBackup
Synopsis
[-p policy] [-s schedule][-L progress_log [-en]] [-S master_server [,master_server,...]] [-t policy_type] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8] -f listfile | filenames
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/
On Windows systems, the directory path to this command is 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é à l'aide de l'option -f listfile.bparchive-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'erreurs 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 NetBackupmail_addressUSEMAIL = mail_address. 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
- -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 fichiers dont le nom ne contient aucun espace, aucun saut de ligne ou aucun retour chariot, utilisez le format suivant :
filepath
Chemin d'accès du fichier à archiver.
/home, /etc
et/var
sont des exemples sur des systèmes UNIX.c:\Programs et c:\documents\old_memos
comporte des exemples sur les systèmes d'exploitation Windows.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.
/home
,/etc
et/var
sont des exemples sur des systèmes UNIX.c:\Programs et c:\documents\old_memos
comporte des exemples sur les systèmes d'exploitation Windows.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.
- -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.
- -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
Sur les systèmes Windows, un exemple serait
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éés sur plusieurs sites.
Seuls les chemins d'accès par défaut sont autorisés pour cette option. 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, ajoutez 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 relative à l'option BPCD_ALLOWED_PATH pour les serveurs et clients NetBackup dans le Guide de l'administrateur NetBackup, Volume I.
- -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 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.
- -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. (Consultez l'option -p.)
- -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
- -utf8
Cette option indique à NetBackup que la liste de fichiers fournie est au format UTF-8. Avec cette option, NetBackup n'essaie pas de convertir les noms de chemin d'accès. L'option n'a aucun effet pour les plateformes autres que Windows ou pour les autres types de politique.
Sous Windows, pour certains types de politique, NetBackup suppose que la liste de fichiers d'entrée est dans le format de page de code active (ACP). Il convertit chaque spécification de chemin d'accès du format ACP au format UTF-8. L'option s'applique à toutes les sauvegardes lancées à partir de la ligne de commande sous Windows, pour les types de politique suivants :
DB2 MS-Exchange-Server Lotus-Notes Oracle SAP MS-SQL-Server Sybase MS-Windows
- -w [hh:mm:ss]
Force NetBackup à attendre 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 expire avant la fin de l'archivage, la commande se ferme. 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.
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