Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
bpimport — importer les sauvegardes NetBackup qui ont expiré ou viennent d'un autre serveur NetBackup
Synopsis
-create_db_info -id media_id or path | -stype server_type [-dp disk_pool_name [-dv disk_volume]] [-server name] [-L output_file [-en]] [-local] [-nh ndmp_host [-mst media_subtype]]
-drfile -id media_id or path | -stype server_type [-dp disk_pool_name [-dv disk_volume]] -drfile_dest dir_name_on_master [-client name] [-server name] [-L output_file [-en]] [-priority number]
[-l] [-p] [-pb] [-PD] [-PM] [-v] [-local] [-client nom] [-M serveur_maître] [-Bidfile nom_fichier] [-st type_planification] [-sl étiquette_planification] [-L fichier_sortie [-en]] [-policy name] [-s date_début] [-e date_fin] [-pt type_politique] [-hoursago heures] [-cn nombre_copies] [-backupid id_sauvegarde] [[-id id_média | chemin] | -stype server_type]] [-dp nom_pool_disques [-dv volume_disque]] [-priority nombre] [-from_replica]
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 bpimport permet d'importer des sauvegardes. Cette commande est utile pour importer les sauvegardes qui ont expirée ou les sauvegardes d'un autre serveur NetBackup.
L'opération d'importation comporte les deux phases suivantes :
La phase 1 est effectuée avec le premier formulaire de la commande apparaissant dans la synthèse (option -create_db_info). Cette étape recrée des rubriques de catalogue pour les sauvegardes des médias spécifiés.
La phase 2 est exécutée avec le deuxième formulaire de la commande apparaissant dans la synthèse. Cette étape importe les sauvegardes des médias.
La date d'échéance pour les sauvegardes importées est la date courante à laquelle s'ajoute la période de conservation. Par exemple, si une sauvegarde est importée le 14 novembre 2012 et son niveau de conservation est d'une semaine, sa nouvelle date d'échéance est le 21 novembre 2012.
Vous pouvez importer une sauvegarde uniquement si toutes les copies ont expiré.
Pour plus d'informations sur l'importation des sauvegardes, consultez le Guide de l'administrateur NetBackup, volume I.
OPTIONS
- -backupid id_sauvegarde
Spécifie l'ID de sauvegarde d'une sauvegarde à importer.
- -Bidfile nom_fichier
file_name spécifie un fichier qui contient une liste d'ID de sauvegarde à importer. Entrez un ID de sauvegarde par ligne dans le fichier. Si cette option est incluse, d'autres critères de sélection sont ignorés.
En outre, NetBackup supprime le fichier qui est spécifié avec le paramètre -Bidfile pendant l'activation de cette interface de ligne de commande. Il est supprimé, car les interfaces graphiques utilisateur NetBackup utilisent généralement ce paramètre. Les interfaces graphiques utilisateur laissent l'interface de la ligne de commande supprimer le fichier temporaire utilisé pour l'option -Bidfile lorsque l'opération est terminée. Les utilisateurs faisant directement appel à l'interface de la ligne de commande peuvent également utiliser cette option. Toutefois, cette dernière supprime le fichier.
- -client name
Le nom d'hôte du client pour lequel les sauvegardes ont été effectuées. La valeur par défaut représente tous les clients.
- -cn nombre_copies
Spécifie le nombre de copie source de sauvegardes à importer. Les valeurs valides sont comprises entre 1 et 10. Le paramètre par défaut est toutes les copies.
- -create_db_info
Cette option recrée des entrées de catalogue pour les sauvegardes des médias spécifiés. Elle ignore les sauvegardes qui sont déjà dans le catalogue. Cette option crée uniquement les informations relatives aux sauvegardes qui sont des candidates pour l'importation et n'exécute pas l'opération d'importation. La commande bpimport doit être exécutée avec cette option avant d'importer toute sauvegarde.
- -dp nom_pool_disques [-dv volume_disque]
Importe des images uniquement sur le pool de disques spécifié. L'importation peut éventuellement être restreinte aux images qui résident sur le volume de disque spécifié. L'argument disk_volume est le chemin d'accès pour BasicDisk.
L'option -stype est requise avec cette option.
- -e date_fin, -s date_début
Spécifie les dates de début et de fin de la plage de dates pour toutes les sauvegardes à importer.
-s spécifie une date et une heure de début pour les listes. La liste de sortie affiche uniquement les images des sauvegardes ou des archives survenues à la date et à l'heure spécifiées, ou ultérieurement.
La commande -e spécifie une date et une heure de fin pour la création de listes. La liste de sortie affiche uniquement les fichiers provenant des sauvegardes ou des archivages survenues aux date et heure spécifiées ou précédemment. Utilisez le même format que celui de la date de début. Par défaut, il s'agit de la date et de l'heure en cours.
La plage de dates autorisées s'étale du 01/01/1970 à 00:00:00 au 19/01/2038 à 03:14:07. Le paramètre par défaut est la veille à minuit.
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.Pour plus d'informations sur les paramètres régionaux de votre système, consultez la rubrique "A propos de la spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
Voici une partie de l'instruction -help USAGE concernant la commande -bpimport et affichant les options -s et -e :
-s mm/dd/yy [hh[:mm[:ss]]] -e mm/dd/yy [hh[:mm[:ss]]]
- -from_replica
Analyse uniquement pour les images qui sont capables de l'importation automatique et les place dans la liste des travaux d'importation automatique de politique de cycle de vie du stockage. Cette option fait partie de la phase 1 de l'importation.
- -hoursago heures
Spécifie le nombre d'heures de recherche avant l'heure des sauvegardes. N'utilisez pas cet élément avec l'option -s. Le paramètre par défaut est la veille à minuit.
- -id id_média | chemin
Support de disque : spécifie le chemin d'accès au répertoire de stockage qui contient la sauvegarde à importer.
Média de bande : pour l'étape 1 (-create_db_info), cette option spécifie l'ID du média qui contient les sauvegardes que vous prévoyez d'importer. Cette option est requise avec -create_db_info.
Pour l'étape 2, cette option indique un ID de média spécifique depuis lequel importer des sauvegardes. Le paramètre par défaut est tous les ID de média qui ont été traités dans l'étape 1 de l'opération d'importation.
Un ID de sauvegarde qui commence sur un ID de média non traité à l'étape 1, n'est pas importé (la sauvegarde est inachevée).
- -L fichier_sortie [-en]
Spécifie le nom du fichier dans lequel les informations de progression sont enregistrées. L'opération par défaut consiste à n'utiliser aucun fichier de progression.
Exemple de chemin pour systèmes UNIX
/usr/openv/netbackup/logs/user_ops
Exemple de chemin pour systèmes Windows,
c:\Program Files\Veritas\NetBackup\logs\user_ops
Ajoutez l'option -en pour générer un journal en anglais. Le nom du journal contient la chaîne _en. Cette option sert à l'équipe d'assistance support en environnement distribué où des journaux en plusieurs langues peuvent être créés sur les divers 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, 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.
- -l
Produit la sortie dans le journal de progression qui liste chaque fichier importé.
- -local
Quand un hôte autre que le serveur maître lance la commande bpimport et que -local n'est pas utilisé (paramètre par défaut), ce qui suit se produit : bpimport démarre une copie distante de la commande sur le serveur maître. La copie distante permet d'arrêter la commande à partir du moniteur d'activité.
Utilisez la commande -local pour empêcher la création d'une copie distante sur le serveur maître. Vous pouvez également l'utiliser pour exécuter bpimport uniquement depuis l'hôte où il a été lancé. Si l'option -local est utilisée, la commande bpimport ne peut pas être annulée du moniteur d'activité.
- -M serveur_maître
Remarque :
Cette option n'est pas requise pour le serveur NetBackup, car elle contient un seul serveur, le maître. Si vous utilisez cette option dans ce cas, spécifiez le serveur maître de NetBackup où vous exécutez la commande.
Indique que le serveur maître gérant le catalogue de médias est propriétaire de l'ID de média. Si vous n'avez pas spécifié cette option, le paramètre par défaut est l'un des suivants :
Si la commande est exécutée sur un serveur maître, ce serveur représente alors le serveur par défaut.
Si la commande est exécutée sur un serveur de médias qui n'est pas le serveur maître, le serveur maître de ce serveur de médias représente alors le serveur par défaut.
- -p
Affiche l'aperçu des sauvegardes à importer selon les paramètres d'option, mais n'effectue pas préalablement l'importation. Affiche les ID de média, le nom du serveur et les informations relatives aux sauvegardes à importer.
- -pb
Affiche l'aperçu des sauvegardes à importer, mais n'effectue pas l'importation. Semblable à l'option -p, mais n'affiche pas les sauvegardes.
- -PD
Identique à l'option -PM, excepté que les sauvegardes sont triées date et heure (de la plus récente à la plus ancienne).
- -PM
Affiche les informations sur les sauvegardes à importer selon les paramètres d'option, mais n'effectue pas l'importation. Il affiche la date et l'heure de la sauvegarde ainsi que la politique, la planification, l'ID de sauvegarde, l'hôte et l'ID de média.
- -policy nom
Recherche des sauvegardes à importer dans la politique spécifiée. La valeur par défaut représente toutes les politiques.
- -priority nombre
Spécifie une nouvelle priorité de travail d'importation remplaçant la priorité de travail par défaut.
- -pt type_politique
Recherche les sauvegardes créées selon le type de politique spécifié. La valeur par défaut représente un type de politique quelconque.
La variable type_politique correspond à l'une des chaînes de caractères suivantes :
Auspex-FastBackup DataStore DataTools-SQL-BackTrack DB2 Enterprise-Vault FlashBackup FlashBackup-Windows Informix-On-BAR LotusNotes MS-Exchange-Server MS-Hyper-V MS-SharePoint MS-SQL-Server MS-Windows NDMP Oracle PureDisk-Export SAP Split-Mirror Standard Sybase Vault VMware
- -server nom
Spécifie le nom du serveur de médias. La base de données de volume pour ce serveur doit avoir un enregistrement de l'ID du média qui contient les sauvegardes à importer. Le paramètre par défaut est le serveur de médias où la commande est exécutée.
Remarque :
Le serveur NetBackup a un seul serveur (le maître). Lorsque vous utilisez le serveur NetBackup, spécifiez le nom de ce serveur.
- -sl étiquette_planification
Recherche les sauvegardes à importer que la planification spécifiée a créées. La valeur par défaut représente toutes les planifications.
- -st type_planification
Recherche les sauvegardes à importer que le type de planification spécifié a créées. La valeur par défaut représente un type de planification.
Les valeurs valides sont les suivantes :
FULL (sauvegarde complète)
INCR (sauvegarde différentielle incrémentielle)
CINC (sauvegarde cumulative incrémentielle)
UBAK (sauvegarde utilisateur)
UARC (archive utilisateur)
NOT_ARCHIVE (toutes les sauvegardes à l'exception de l'archive utilisateur)
- -stype type_serveur
Spécifie une chaîne identifiant le type de serveur de stockage. La valeur server_type peut provenir d'une des sources suivantes :
Stockage fourni par Veritas. Les valeurs possibles sont AdvancedDisk et PureDisk.
Appliances disque tiers. Le fournisseur fournit la chaîne server_type.
Stockage en cloud. Les valeurs possibles sont
amazon
,att
, azure etrackspace
. Les valeurs stype de cloud reflètent le fournisseur du stockage en cloud. Les valeurs stype du stockage en cloud peuvent également intégrer un suffixe (par exemple,amazon_crypt
). Les suffixes possibles sont :_Raw : l'image de sauvegarde de NetBackup est envoyée au cloud, au format brut. Utilisez cette option si vous ne voulez pas compresser ou chiffrer de données avant de les envoyer au stockage en cloud.
_rawc : compresse les données avant leur écriture sur le stockage en cloud.
_crypt
: permet de chiffrer les données à l'aide d'AES 256 bits avant leur écriture sur le stockage cloud. Vous devez avoir configuré KMS dans NetBackup pour pouvoir utiliser cette option._cryptc : compresse et chiffre les données avant leur enregistrement sur le stockage en cloud.
Le type de serveur de stockage est sensible à la casse.
- -v
Affiche des informations plus détaillées dans les journaux de débogage et les journaux de progression.
EXEMPLES
Exemple 1 - Création de toutes les informations de catalogue sur une ligne pour les sauvegardes sur l'ID de média A0000. Le nom de l'hôte du média est cat
. Le fichier de progression est bpimport.ls, et se trouve dans le répertoire tmp.
Systèmes UNIX : # bpimport -create_db_info -id A0000 -server cat -L /usr/openv/netbackup/logs/user_ops/bpimport.ls
Systèmes Windows : # bpimport -create_db_info -id A0000 -server cat -L \tmp\bpimport.ls
Exemple 2 - Affichage sur une ligne de toutes les informations à propos des sauvegardes candidates à l'importation. Les sauvegardes qui apparaissent ont été créées entre le 11/01/2012 et le 11/10/2012. La commande bpimport avec l'option -create_db_info doit être exécutée avant cette commande.
# bpimport -PM -s 11/01/2012 -e 11/10/2012
Exemple 3 - Importation des sauvegardes qui ont été spécifiées dans le fichier images
. L'avancement est enregistré dans le fichier bpimport.ls
.
Systèmes UNIX : # bpimport -Bidfile /tmp/import/image -L /usr/openv/netbackup/logs/user_ops/bpimport.ls
Systèmes Windows : # bpimport -Bidfile \tmp\import\image -L \tmp\bpimport.ls
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/logs/admin/* /usr/openv/netbackup/db/images/*
Systèmes Windows :
install_path\NetBackup\logs\admin\* install_path\NetBackup\db\images\*