Guide de référence des commandes NetBackup™

Last Published:
Product(s): NetBackup (10.0)
  1. Introduction
    1.  
      A propos des commandes de NetBackup
    2.  
      Navigation dans les niveaux de menu
    3.  
      Conventions des commandes NetBackup
    4.  
      Remarques sur les commandes de NetBackup Media Manager
    5.  
      Mises à jour IPv6
  2. Annexe A. Commandes NetBackup
    1.  
      acsd
    2.  
      add_media_server_on_clients
    3.  
      backupdbtrace
    4.  
      backuptrace
    5.  
      bmrc
    6.  
      bmrconfig
    7.  
      bmrepadm
    8.  
      bmrprep
    9.  
      bmrs
    10.  
      bmrsrtadm
    11.  
      bp
    12.  
      bparchive
    13.  
      bpbackup
    14.  
      bpbackupdb
    15.  
      bpcatarc
    16.  
      bpcatlist
    17.  
      bpcatres
    18.  
      bpcatrm
    19.  
      bpcd
    20.  
      bpchangeprimary
    21.  
      bpcleanrestore
    22.  
      bpclient
    23.  
      bpclimagelist
    24.  
      bpclntcmd
    25.  
      bpclusterutil
    26.  
      bpcompatd
    27.  
      bpconfig
    28.  
      bpdbjobs
    29.  
      bpdbm
    30.  
      bpdgclone
    31.  
      bpdown
    32.  
      bpduplicate
    33.  
      bperror
    34.  
      bpexpdate
    35.  
      bpfis
    36.  
      bpflist
    37.  
      bpgetconfig
    38.  
      bpgetdebuglog
    39.  
      bpimage
    40.  
      bpimagelist
    41.  
      bpimmedia
    42.  
      bpimport
    43.  
      bpinst
    44.  
      bpkeyfile
    45.  
      bpkeyutil
    46.  
      bplabel
    47.  
      bplist
    48.  
      bpmedia
    49.  
      bpmedialist
    50.  
      bpminlicense
    51.  
      bpnbat
    52.  
      bpnbaz
    53.  
      bppficorr
    54.  
      bpplcatdrinfo
    55.  
      bpplclients
    56.  
      bppldelete
    57.  
      bpplinclude
    58.  
      bpplinfo
    59.  
      bppllist
    60.  
      bpplsched
    61.  
      bpplschedrep
    62.  
      bpplschedwin
    63.  
      bppolicynew
    64.  
      bpps
    65.  
      bprd
    66.  
      bprecover
    67.  
      bprestore
    68.  
      bpretlevel
    69.  
      bpschedule
    70.  
      bpschedulerep
    71.  
      bpsetconfig
    72.  
      bpstsinfo
    73.  
      bpstuadd
    74.  
      bpstudel
    75.  
      bpstulist
    76.  
      bpsturep
    77.  
      bptestbpcd
    78.  
      bptestnetconn
    79.  
      bptpcinfo
    80.  
      bpup
    81.  
      bpverify
    82.  
      cat_convert
    83.  
      cat_export
    84.  
      cat_import
    85.  
      configureCerts
    86.  
      configureMQ
    87.  
      configurePorts
    88.  
      configureWebServerCerts
    89.  
      create_nbdb
    90.  
      csconfig cldinstance
    91.  
      csconfig cldprovider
    92.  
      csconfig meter
    93.  
      csconfig reinitialize
    94.  
      csconfig throttle
    95.  
      duplicatetrace
    96.  
      importtrace
    97.  
      jbpSA
    98.  
      jnbSA
    99.  
      ltid
    100.  
      mklogdir
    101.  
      nbauditreport
    102.  
      nbcallhomeproxyconfig
    103.  
      nbcatsync
    104.  
      NBCC
    105.  
      NBCCR
    106.  
      nbcertcmd
    107.  
      nbcertupdater
    108.  
      nbcldutil
    109.  
      nbcloudrestore
    110.  
      nbcomponentupdate
    111.  
      nbcplogs
    112.  
      nbcredkeyutil
    113.  
      nbdb_admin
    114.  
      nbdb_backup
    115.  
      nbdb_move
    116.  
      nbdb_ping
    117.  
      nbdb_backup
    118.  
      nbdb_move
    119.  
      nbdb2adutl
    120.  
      nbdb_restore
    121.  
      nbdbms_start_stop
    122.  
      nbdc
    123.  
      nbdecommission
    124.  
      nbdelete
    125.  
      nbdeployutil
    126.  
      nbdevconfig
    127.  
      nbdevquery
    128.  
      nbdiscover
    129.  
      nbdna
    130.  
      nbemm
    131.  
      nbemmcmd
    132.  
      nbfindfile
    133.  
      nbfirescan
    134.  
      nbfp
    135.  
      nbftadm
    136.  
      nbftconfig
    137.  
      nbgetconfig
    138.  
      nbhba
    139.  
      nbholdutil
    140.  
      nbhostidentity
    141.  
      nbhostmgmt
    142.  
      nbhypervtool
    143.  
      nbidpcmd
    144.  
      nbimageshare
    145.  
      nbinstallcmd
    146.  
      nbjm
    147.  
      nbkmiputil
    148.  
      nbkmscmd
    149.  
      nbkmsutil
    150.  
      nboraadm
    151.  
      nborair
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmlb
    155.  
      nbperfchk
    156.  
      nbplupgrade
    157.  
      nbrb
    158.  
      nbrbutil
    159.  
      nbregopsc
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbsmartdiag
    167.  
      nbsnapimport
    168.  
      nbsnapreplicate
    169.  
      nbsqladm
    170.  
      nbstl
    171.  
      nbstlutil
    172.  
      nbstop
    173.  
      nbsu
    174.  
      nbsvrgrp
    175.  
      netbackup_deployment_insights
    176.  
      resilient_clients
    177.  
      restoretrace
    178.  
      stopltid
    179.  
      tldd
    180.  
      tldcd
    181.  
      tpautoconf
    182.  
      tpclean
    183.  
      tpconfig
    184.  
      tpext
    185.  
      tpreq
    186.  
      tpunmount
    187.  
      verifytrace
    188.  
      vltadm
    189.  
      vltcontainers
    190.  
      vlteject
    191.  
      vltinject
    192.  
      vltoffsitemedia
    193.  
      vltopmenu
    194.  
      vltrun
    195.  
      vmadd
    196.  
      vmchange
    197.  
      vmcheckxxx
    198.  
      vmd
    199.  
      vmdelete
    200.  
      vmoprcmd
    201.  
      vmphyinv
    202.  
      vmpool
    203.  
      vmquery
    204.  
      vmrule
    205.  
      vmupdate
    206.  
      vnetd
    207.  
      vssat
    208.  
      vwcp_manage
    209.  
      vxlogcfg
    210.  
      vxlogmgr
    211.  
      vxlogview
    212.  
      W2KOption
  3.  
    Index

Nom

bparchive — archivage de fichiers sur le serveur NetBackup

Synopsis

bparchive [-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 fichier install_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