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

bpbackup — sauvegarde des fichiers sur le serveur NetBackup

Synopsis

bpbackup -f listfile | filenames [-p policy] [-s schedule] [-S master_server...] [-t policy_type] [-L progress_log [-en]] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8]

bpbackup -i [-p policy] [-h hostname {[-instance instance_name [-database database_name]]] | [-database_unique_name name -database_id id]} [-s schedule] [-S master_server...] [-t policy_type] [-L progress_log [-en]] [-w [hh:mm:ss]] [-k "keyword_phrase"] [-utf8]

bpbackup -dssu DSSUname [-S master_server]

 

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 bpbackup peut démarrer un processus de sauvegarde sur des clients et serveurs maîtres. Si vous utilisez une politique Oracle, la commande bpbackup permet de sauvegarder une instance ou une base de données RAC. Si vous utilisez une politique SQL Server, la commande bpbackup permet de sauvegarder une instance ou une base de données dans une instance.

Pour les clients :

L'option -f de la commande bpbackup démarre une sauvegarde utilisateur équivalente à celle effectuée avec l'interface sur le client. Ce type de sauvegarde peut être démarré à partir d'un client NetBackup quelconque pour sauvegarder les fichiers de ce client.

La commande bpbackup traite les fichiers répertoriés sur la ligne de commande ou dans le fichier spécifié avec l'option -f listfile. Le chemin d'accès peut être soit un nom de fichier, soit un nom de répertoire. Si les fichiers nommés comprennent un répertoire, la commande bpbackup sauvegarde tous les fichiers et les sous-répertoires de ce répertoire, à commencer par le répertoire lui-même.

Remarque :

En plus de répertorier les fichiers ou les répertoires, la commande bpbackup peut également utiliser des directives pour indiquer les fichiers à sauvegarder. Par exemple : bpbackup "/Shadow Copy Components/" ou bpbackup "/System State/". Les clients peuvent entrer la directive dans la liste des fichiers avec l'optionbpbackup -f listfile.

Pour les serveurs maîtres :

L'option -i de la commande bpbackup démarre une sauvegarde manuelle immédiate d'un client. Seul l'administrateur du serveur maître a accès à cette option de commande bpbackup. Elle correspond au démarrage d'une sauvegarde manuelle à partir de la console d'administration NetBackup. Utilisez l'option -h pour spécifier l'hôte.

Étant donné que les journaux de progression sont enregistrés uniquement sur les clients et que ce format de commande bpbackup est exécuté à partir du serveur maître uniquement, l'option -L n'est pas définie.

Les restrictions suivantes s'appliquent à cette commande :

  • Vous devez être le propriétaire du fichier ou un administrateur pour pouvoir sauvegarder un fichier avec la commande bpbackup.

  • Si vous disposez des autorisations nécessaires, vous pouvez sauvegarder les fichiers et les répertoires appartenant à d'autres utilisateurs.

  • Pour les systèmes UNIX : si vous spécifiez un fichier correspondant à un lien, la commande bpbackup sauvegarde uniquement le lien, non le fichier auquel il est associé.

  • La commande bpbackup ne sauvegarde pas les entrées de répertoire contenant les caractères suivants : "." ou "..".

Par défaut, vous revenez à l'invite système après avoir exécuté la commande bpbackup. La commande fonctionne en arrière-plan et ne renvoie pas directement l'état d'achèvement. L'option -w permet de modifier ce fonctionnement pour que la commande fonctionne au premier plan. Elle renvoie l'état d'achèvement après une période spécifiée.

Si vous créez le fichier avant d'exécuter la commande bpbackup et si vous spécifiez le fichier avec l'option -L progress_log, les événements suivants se produisent : La commande bpbackup enregistre des messages d'informations et des messages d'erreur dans un fichier journal de progression. Si la commande bpbackup ne peut pas archiver les fichiers ou les répertoires demandés, utilisez le journal de progression pour établir la raison de cet échec.

Remarque :

Les clients NDMP ne prennent pas en charge l'option - L.

Si vous créez le répertoire suivant avec un accès public en écriture, la commande bpbackup crée un fichier journal de débogage dans le répertoire pouvant être utilisé pour les opérations de dépannage :

On Windows systems: install_path\NetBackup\logs\bpbackup\
On UNIX systems: usr/openv/netbackup/logs/bpbackup/

NetBackup envoie un courrier électronique concernant l'état d'achèvement de la sauvegarde lorsque le processus de sauvegarde est terminé à l'adresse électronique (mail_address) lorsque les utilisateurs spécifient les éléments suivants :

  • Un utilisateur non racine spécifie la directive USEMAIL = mail_address dans le fichier $HOME/bp.conf

  • Un utilisateur racine spécifie la directive USEMAIL = mail_address dans le fichier /usr/openv/netbackup/bp.conf

OPTIONS

-database_id

ID de la base de données Oracle RAC spécifiée dans la politique.

-database_unique_name

Nom unique de la base de données Oracle RAC spécifiée dans la politique.

-dssu DSSUname

NetBackup exécute immédiatement la planification associée à l'unité de stockage de sauvegarde intermédiaire. L'option -i correspond au fonctionnement standard. Il s'agit d'une option facultative.

-f fichier_liste

Spécifie un fichier (listfile) contenant la liste des fichiers à sauvegarder. Vous pouvez utiliser cette option à la place de l'option de nom de fichier filenames. Cependant, vous ne pouvez pas l'associer à l'option -i. Ajoutez chaque fichier sur une ligne distincte.

Si le nom des fichiers comporte des espaces, des sauts de ligne ou des retours chariot, cela peut affecter le format de la liste des fichiers.

Pour sauvegarder les fichiers dont le nom ne contient aucun espace, aucun saut ligne ou aucun retour chariot, utilisez le format suivant :

            filepath
          

La variable filepath correspond au chemin d'accès du fichier à sauvegarder.

Par exemple, pour les systèmes UNIX :/home, /etc et /var..

Par exemple, pour les systèmes d'exploitation Windows : c:\Programs, c:\winnt et c:\documents\old_memos

Pour sauvegarder les fichiers dont le nom ne contient aucun espace, aucun saut ligne ou aucun retour chariot, utilisez le format suivant :

            filepathlen filepath
          

La variable filepath correspond au chemin d'accès du fichier à sauvegarder et la variable filepathlen correspond au nombre de caractères du chemin d'accès du fichier.

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

Assigne un nom à un ou plusieurs fichiers à sauvegarder. Vous pouvez utiliser cette option à la place de l'option -f. Cependant, vous ne pouvez pas l'associer à l'option -i. Vous devez afficher tous les fichiers spécifiés à la fin et à la suite des autres options.

-h nom_hôte

Assigne un nom à l'hôte client sur lequel vous pouvez exécuter la sauvegarde. Si cette option n'est pas spécifiée, NetBackup exécute la sauvegarde sur tous les clients de la politique.

-i

Démarre une sauvegarde manuelle immédiate. Cette opération revient à démarrer une sauvegarde manuelle à partir de l'interface de l'administrateur NetBackup. Vous devez avoir ouvert une session en tant qu'administrateur du serveur maître pour utiliser l'option -i.

-instance instance_name [-database database_name]

Spécifie le nom d'une instance d'Oracle ou de SQL Server que vous voulez sauvegarder. Le type de politique (-t) doit être défini sur 4 (Oracle) ou sur 15 (SQL Server). Vous devez utiliser cette option avec l'option -h et vous devez être l'administrateur sur le serveur maître.

[-database database_name] spécifie le nom d'une base de données SQL Server dans une instance que vous voulez sauvegarder.

-k keyword_phrase

Spécifie une expression de mot-clé associée par NetBackup à l'image créée par cette opération de sauvegarde. Vous pouvez ensuite restaurer l'image en spécifiant l'expression de mot-clé à l'aide de l'option -k de la commande bprestore.

Si vous associez les options -i et -k, NetBackup associe l'expression de mot-clé à la politique et l'image de sauvegarde.

L'expression de mot-clé est un texte décrivant la sauvegarde d'une longueur maximale de 128 caractères.

Pour les systèmes UNIX, vous pouvez utiliser tous les caractères imprimables, y compris les espaces (" ") et les points ("."). Entourez l'expression de guillemets doubles ("...") ou d'apostrophes ('...') pour éviter un conflit avec le shell UNIX.

Pour les systèmes d'exploitation Windows, vous pouvez utiliser tous les caractères affichables, y compris les espaces (" ") et les points ("."). 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. NetBackup crée le fichier si nécessaire.

Sur les systèmes Windows, par exemple : NetBackup\logs\user_ops\proglog

Sur les systèmes UNIX, par exemple : netbackup/logs/user_ops/proglog

L'opération par défaut consiste à ne pas utiliser de journal de progression.

Les clients NDMP ne prennent pas en charge l'option - L.

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 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

Nomme la politique à utiliser pour la sauvegarde.

Si cette option n'est pas spécifiée, NetBackup utilise la première politique trouvée comprenant le client et une planification de sauvegarde utilisateur.

Vous devez spécifier cette option pour effectuer une sauvegarde manuelle immédiate (option -i).

-s planification

Nomme la planification à utiliser pour la sauvegarde. Si cette option n'est pas spécifiée, le serveur NetBackup utilise la première planification de sauvegarde utilisateur trouvée pour le client de la politique en cours.

Pour plus d'informations, reportez-vous à l'option -p.

-S serveur_maître [,serveur_maître,...]

Pour les systèmes d'exploitation UNIX, l'option -S spécifie le ou les noms des serveurs maître NetBackup. Le paramètre par défaut est la première entrée de serveur (SERVER) trouvée dans le fichier /usr/openv/netbackup/bp.conf.

Pour les systèmes d'exploitation Windows, l'option -S spécifie le ou les noms des serveurs maître NetBackup. La valeur par défaut correspond au serveur spécifié en tant que serveur actuel 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. Ensuite, cliquez 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. La valeur par défaut pour les clients Windows est 13 et 0 pour tous les autres clients :

0 = Standard

4 = Oracle

6 = Informix ON-BAR

7 = Sybase

8 = Microsoft SharePoint

13 = MS-Windows

15 = Microsoft SQL Server

16 = MS-Exchange-Server

19 = NDMP

Les options suivantes s'appliquent uniquement au serveur Enterprise NetBackup.

11 = DataTools-SQL-BackTrack

17 = SAP

18 = DB2

20 = FlashBackup

21 = Split-Mirror

39 = Enterprise-Vault

44 = BigData

48 = Universal-share

-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]

NetBackup attend la fin des opérations du serveur avant de vous renvoyer à l'invite système.

Vous pouvez éventuellement spécifier un temps d'attente en heures, minutes et secondes. Le temps d'attente maximal est de 23:59:59. Si ce temps d'attente expire avant la fin de la sauvegarde, l'exécution de la commande se termine en indiquant un délai. Cependant, la sauvegarde se poursuit sur le serveur.

L'option bpbackup -w oblige le shell à attendre le renvoi d'un code d'état. Le shell du système d'exploitation ne peut renvoyer qu'un seul code d'état. Par conséquent, si vous utilisez l'option -w sans spécifier un délai ou si vous spécifiez la valeur 0 (zéro), NetBackup attend indéfiniment que l'opération se termine.

Vous pouvez démarrer une sauvegarde manuelle ou administrative en associant les options bpbackup -i et -w. Ce type de sauvegarde permet de démarrer plusieurs travaux car il est basé sur des attributs de politique. Si la sauvegarde manuelle démarre plusieurs travaux, l'option -w ne renvoie qu'un seul code d'état au shell.

Si vous utilisez les options -i et -w et si plusieurs travaux démarrent en même temps, NetBackup attend la fin de tous les travaux avant de renvoyer un code d'état d'achèvement. Cependant, étant donné que NetBackup renvoie uniquement un code d'état au shell, l'ID de travail appartenant au code d'état n'est pas reconnu.

Si plusieurs travaux appartiennent à plusieurs clients et si l'option Autoriser les flux de données multiples n'est pas sélectionnée, utilisez l'option -h pour limiter l'opération à un seul client. Cependant, si l'option Autoriser les flux de données multiples est sélectionnée dans la politique et que le client sélectionné contient plusieurs travaux, le code d'état renvoyé ne sera pas non plus reconnu.

EXEMPLES

Exemple 1 - Réalisation d'une sauvegarde utilisateur d'un fichier unique.

Sur les systèmes UNIX : # bpbackup /usr/user1/file1

Sur les systèmes Windows : # bpbackup c:\users\user1\file1

Exemple 2 - Démarrage d'une sauvegarde utilisateur des fichiers répertoriés dans un fichier nommé backup_list

# bpbackup -f backup_list

Exemple 3 - Démarrage d'une sauvegarde manuelle immédiate (sur une seule ligne) de l'hôte client nommé diablo dans la politique nommée cis_co. Le type de politique est Politique standard et se trouve dans la configuration du serveur maître nommé hoss.

UNIX : # bpbackup -p cis_co -i -h diablo -S hoss -t 0

Windows : # bpbackup -p cis_co -i -h diablo -S hoss -t 0

Exemple 4 - Sur les systèmes Windows : Association de l'expression de mots clés "Backup My Home Directory 01/01/01" à la sauvegarde utilisateur du répertoire C:\home\kwc. (Saisissez la commande sur une seule ligne.)

# bpbackup -k "Backup My Home Directory 01/01/01" 
-L c:\Program Files\Veritas\NetBackup\logs\user_ops\bkup.log \
C:\home\kwc

Systèmes UNIX : la commande suivante associe l'expression de mots clés "Backup Home Dir 01/01/01" à la sauvegarde utilisateur du répertoire /home/kwc (saisissez la commande sur une seule ligne ou utilisez le caractère "\").

# bpbackup -k "Backup Home Dir 01/01/01" 
-L /usr/openv/netbackup/logs/user_ops/bkup.log  \
 /home/kwc

Exemple 5 - Association de l'expression de mots clés "Policy Win 01/01/01" à la sauvegarde manuelle immédiate de l'hôte client nommé slater dans la politique nommée win_nt_policy (saisissez toute la commande sur une seule ligne).

UNIX :

# bpbackup -k "Policy Win 01/01/01" -i -h slater \
-p win_nt_policy -t 13

Windows :

# bpbackup -k "Policy Win 01/01/01" -i -h slater 
-p win_nt_policy -t 13

Exemple 6 - Réalisation d'une sauvegarde manuelle de l'instance Oracle orac11g sur l'hôte client hookvm2 à l'aide de la politique ora.

# bpbackup -i -p ora -h hookvm2 -t 4 -instance orac11g

Exemple 7 - Réalisation d'une sauvegarde manuelle de la base de données SQL Server HRDB1 dans l'instance HR sur l'hôte client winvm2 à l'aide de la politique sql.

# bpbackup -i -p sql -h winvm2 -t 15 -instance HR -database HRDB1

FICHIERS

Systèmes UNIX : $HOME/bp.conf

/usr/openv/netbackup/logs/bpbackup/log.mmddyy

Systèmes Windows : chemin_installation\NetBackup\logs\bpbackup\*.log

VOIR AUSSI

Se reporter à bp.

Se reporter à bparchive.

Se reporter à bplist.

Se reporter à bprestore.