Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
vlteject — éjection du média et génération de rapports pour les sessions exécutées précédemment
Synopsis
-eject [-profile nom_profil] [-robot nom_robot] [-vault nom_centre_sauvegarde [-sessionid id]] [-auto y|n] [-eject_delay secondes]
-report [-profile nom_profil] [-robot nom_robot] [-vault nom_centre_sauvegarde [-sessionid id]] [-legacy]
-eject -report [-profile nom_profil] [-robot nom_robot] [-vault nom_centre_sauvegarde [-sessionid id]] [-auto y|n] [-eject_delay secondes] [-version] [-legacy]
-preview [-vault nom_centre_sauvegarde [-profile nom_profil]] [-profile numéro_robot / nom_centre_sauvegarde / nom_profil] [-robot nom_robot][-sessionid id]
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 vlteject éjecte le média et génère les rapports correspondants (comme configurés dans les profils) pour les sessions de centre de sauvegarde pour lesquelles les médias n'ont pas été encore éjectés. vlteject peut traiter les éjections et les rapports en attente de toutes les sessions d'un robot, d'un centre de sauvegarde ou d'un profil spécifique. Pour traiter l'ensemble des éjections et des rapports en attente, n'utilisez pas les options -profile, -robot ou -vault.
La commande vlteject agit uniquement sur les sessions pour lesquelles le répertoire existe encore. Après avoir nettoyé le répertoire (supprimé par NetBackup), la commande vlteject ne peut ni éjecter, ni générer de rapport pour cette session.
L'exécution interactive de la commande vlteject dépend de la méthode d'appel. Exécutez cette commande de manière interactive lorsque vous prévoyez d'éjecter plus de médias que le nombre de médias spécifiés dans le port d'accès aux médias.
Ne modifiez pas la configuration de votre centre de sauvegarde si la commande vlteject est en cours d'exécution.
Vous pouvez exécuter la commande vlteject comme suit :
En exécutant la commande directement à partir de la ligne de commande
En exécutant la commande à partir de la planification de politique NetBackup. La politique doit être de type Centre de sauvegarde et la liste de fichiers de la politique doit contenir une commande vlteject.
En exécutant la commande vltopmenu pour effectuer une opération d'éjection, une opération d'éjection consolidée ou de rapport consolidé.
Si le répertoire suivant existe et dispose d'un accès public en écriture, la commande vlteject enregistre les informations dans le fichier du journal de débogage quotidien :
Systèmes d'exploitation UNIX : usr/openv/netbackup/logs/vault
Systèmes Windows : chemin_installation\netbackup\logs\vault
Le format du nom du fichier journal de débogage quotidien est le suivant : log.DDMMYY. La variable DDMMYY correspondant à la date en cours.
Vous devez disposer d'un accès public en écriture car certains fichiers exécutables écrivant des données dans ce fichier ne peuvent pas être exécutés que par un administrateur ou un utilisateur racine. La propriété d'hôte "Conserver les journaux du centre de sauvegarde pendant n jours" établit la durée de conservation des répertoires de centre de sauvegarde.
Tout utilisateur disposant des autorisations nécessaires peut exécuter cette commande.
Pour plus d'informations sur les autorisations NetBackup, reportez-vous au Guide de sécurité et de chiffrement NetBackup.
OPTIONS
- -auto y|n
Spécifie le mode automatique (y) ou le mode interactif (n). En mode automatique (y), la commande vlteject est exécutée sans que l'utilisateur entre des données et n'affiche pas la sortie. En mode interactif (paramètre par défaut), la commande vlteject est exécutée en mode interactif. Elle accepte les entrées de l'utilisateur et affiche la sortie.
- -eject
Ejecte le média pour les sessions spécifiées. L'option -eject est facultative si vous avez déjà effectué l'opération d'éjection et que vous voulez uniquement générer des rapports.
- -eject_delay secondes
Nombre de secondes avant l'éjection des médias. Cette option est particulièrement utile si vous avez effectué récemment une opération de sauvegarde ou de duplication sur les médias affectés. La valeur par défaut est 0. La valeur maximale est 3600 (1 heure).
- -legacy
Génère des rapports à l'aide de la fonction de consolidation héritée. Cette option fonctionne uniquement avec l'option -report.
- -preview
Affiche les sessions et les médias éjectés pour les sessions. N'éjecte pas les médias.
- -profile numéro_robot / nom_centre_sauvegarde / nom_profil
Permet d'identifier le numéro de robot, le nom du centre de sauvegarde, le nom du profil à partir duquel vous pouvez éjecter les médias et générer des rapports. Vous devez utiliser ces trois options avec l'option -profile. Pour traiter toutes les éjections et les rapports en attente, utilisez l'option -profile uniquement avec l'option profile_name.
- -report
Génère les rapports pour les sessions spécifiées. Si le processus d'éjection correspondant est terminé, il génère et diffuse tous les rapports en attente des sessions sélectionnées. Si vous exécutez à nouveau la commande vlteject, les rapports ne sont pas regénérés. Si le processus d'éjection n'est pas terminé, le sous-ensemble de rapports ne dépendant pas de l'achèvement de ce processus est généré. Ces rapports sont générés à nouveau si la commande vlteject -report est réexécutée après l'éjection.
- -robot numéro_robot
Spécifie le numéro de robot permettant d'identifier le robot que vous voulez éjecter des médias et sur lequel vous voulez générer des rapports. Tous les centres de sauvegarde du robot doivent utiliser le même groupe de volumes hors site. Pour traiter l'ensemble des éjections et des rapports en attente, n'utilisez pas les options -profile, -robot ou -vault.
- -sessionid id
ID de session au format numérique. Si les options -profile, -robot ou -vault sont spécifiées et si l'option -session id n'est pas spécifiée, la commande vlteject traite toutes les sessions du profil, du robot ou du centre de sauvegarde spécifié.
- -vault nom_centre_sauvegarde
Centre de sauvegarde éjectant les médias et génèrant les rapports. Pour traiter toutes les opérations d'éjection et de rapports en attente, n'utilisez pas les options -profile, -robot ou -vault.
- -version
Affiche la version et la sortie de la commande vlteject.
EXEMPLES
Exemple 1 - Ejection des médias et génération de rapports pour tous les robots qui ont des sessions pour lesquelles des médias n'ont pas encore été éjectés :
# vlteject -eject -report
Exemple 2 - Ejecter tous les médias qui n'ont pas encore été éjectés pour toutes les sessions pour le centre de sauvegarde CustomerDB et générer les rapports correspondants :
# vlteject -vault CustomerDB -eject -report
VALEURS DE RETOUR
Lors de la fermeture du centre de sauvegarde, il peut renvoyer un code d'état supérieur à 255. Les codes d'état de ce type sont appelés "codes d'état de sortie étendue". Dans ce cas, l'état de sortie renvoyé au système est 252. L'état de sortie en cours est enregistré dans stderr au format suivant : EXIT status = exit status
Pour plus d'informations sur les valeurs étendues des états de sortie, reportez-vous au Guide de dépannage NetBackup et à l'Assistant de dépannage NetBackup.
FICHIERS
Systèmes UNIX :
/usr/openv/netbackup/db/vault/vault.xml /usr/openv/netbackup/logs/vault/log.mmddyy /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/detail.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/summary.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/vlteject_status /usr/openv/netbackup/vault/sessions/vlteject.mstr /usr/openv/netbackup/bp.conf
Systèmes Windows :
install_path\NetBackup\db\vault\vault.xml install_path\NetBackup\logs\bpbrmvlt\mmddyy.log install_path\NetBackup\logs\vault\mmddyy.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\detail.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\summary.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\vlteject.status install_path\NetBackup\vault\sessions\vlteject.mstr install_path\NetBackup\bp.conf
VOIR AUSSI
Se reporter à vltopmenu.