Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
vxlogmgr — gestion des fichiers journaux générés par les produits prenant en charge la consignation unifiée
Synopsis
{ -c | -m } -f répertoire_absolu [-a]
{ -d | -F } [-a]
{-c | -m | -A nom_fichier} -f répertoire_absolu [-p id_produit] [-o id_créateur] [-n jours] [-t temps] [-b date_début] [-g lot_journaux] [-e date_fin] [-q] [-z]
{-c | -m | -A nom_fichier} -f répertoire_absolu -w chaîne_recherche [-q] [-z]
{-d | -F | -s} [-p id_produit] [-o id_créateur] [-n jours] [-t temps] [-b date_début] [-g lot_journaux] [-e date_fin] [-q] [-z]
{-d | -F | -s} -w chaîne_recherche [-q] [-z]
-v
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
L'utilitaire vxlogmgr gère les fichiers journaux produits par les applications permettant la consignation unifiée. La gestion des fichiers journaux comprend des opérations telles que la suppression ou le déplacement des fichiers journaux en fonction des paramètres de configuration de gestion des journaux.
La consignation unifiée utilise un format d'identificaton standard pour les fichiers journaux comme suit :
productID-originatorID-hostID-date-rotation.log
Pour plus d'informations concernant la consignation unifiée, le format d'identification et les ID de connexion de l'émetteur, reportez-vous au Guide de référence de consignation NetBackup.
OPTIONS
Spécifier les opérations de gestion des journaux à effectuer.
- -A, --arch FileName
Crée une archive portant le nom FileName pour spécifier un jeu de conditions. Les fichiers compressés zip nécessite l'installation de l'application WinZip sous Windows pour pouvoir créer des fichiers zip. Pour UNIX, vous devez installer l'utilitaire tar et l'application GnuZip pour pouvoir créer des fichiers tar.gzip.
- -a, --auto
Extrait les fichiers journaux selon les différents paramètres de configuration de la variable NumberOfLogFiles. Les opérations effectuées dépendent du type d'opération à effectuer (déplacement, copie ou suppression). Lorsque l'option -a est spécifiée, les autres options ne peuvent pas être utilisées.
- -b, --stdate 'date_début'
Gère les fichiers journaux qui sont créés à la date de démarrage spécifiée.
Le format de la date 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, consultez la section "Spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
Elle est entourée par des apostrophes sous UNIX et par des guillemets sous Windows. Par exemple :
UNIX : --stdate '1/1/2013 12:00:00 AM'
Windows : --stdate "1/1/2013 12:00:00 AM"
- -c, --cp
Copie les fichiers journaux du dossier configuré par le produit vers le dossier spécifié.
- -d, --del
Supprime les fichiers journaux du dossier configuré par le produit.
- -e, --endate 'date_fin'
Gère les fichiers journaux qui sont créés jusqu'à la date_fin spécifiée.
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, consultez la section "Spécification des paramètres régionaux de l'installation NetBackup" du Guide de l'administrateur NetBackup, volume II.
Cette option doit être entourée par des apostrophes sous UNIX et par des guillemets sous Windows.
UNIX : --endate '1/1/2013 12:00:00 PM'
Windows : --stdate "1/1/2013 12:00:00 AM"
- -f, --dir répertoire_absolu
Spécifie le nom absolu du répertoire dans lequel les fichiers journaux doivent être copiés.
Sur les systèmes UNIX, ce répertoire doit être sur le même périphérique que le répertoire
opt/openv/netbackup/logs
, car les journaux sont liés physiquement plutôt que copiés.Vous pouvez utiliser cette option uniquement avec l'option -c.
- -F, --flush
Supprime tous les fichiers journaux de l'hôte qui lance cette commande, à l'exception du fichier journal le plus récent. Si l'hôte qui exécute cette commande utilise un répertoire partagé, tous les fichiers journaux de tous les hôtes qui utilisent le répertoire sont supprimés. Seul le fichier le plus récent est conservé pour l'hôte qui a lancé la commande de vidage.
- -m, --mv
Déplace les fichiers journaux du dossier configuré par le produit vers le dossier spécifié.
- -n --days nombre_jours
Gère les fichiers journaux créés au cours des derniers jours nombre_jours pour l'action spécifiée.
- -o, --origid id_créateur
Gère les fichiers journaux identifiés par un ID de créateur donné (id_créateur).
- -p, --prodid id_produit
Gère les fichiers journaux identifiés par un ID de produit (ProductID) pour l'action spécifiée. A la place d'un ID, l'utilisateur peut spécifier le nom du produit.
- -q, --quiet
Empêche l'affichage des messages (mode silencieux).
- -s, --vw
Affiche les fichiers journaux d'une demande.
- -t, --tail hh:mm:ss
Gère les fichiers journaux des dernières heures spécifiées dan la variable hh:mm:ss.
- -v, --version
Affiche les informations de version de cette commande.
- -w, --where chaîne_recherche
Extrait un sous-ensemble de journaux selon une chaîne de recherche ou d'une condition (QueryString).
- -z, --displaytimezone
Affiche les informations de fuseau horaire avec le fichier journal.
CODE D'ETAT DE SORTIE
Les valeurs de sortie suivantes sont renvoyées :
0 : processus terminé.
1 : une erreur système est survenue.
CHAîNES DE REQUÊTE
Une chaîne de recherche est une expression textuelle correspondant à une clause de base de données WHERE utilisée pour extraire les entrées des journaux du système de consignation unifiée. Cette expression est une combinaison d'opérateurs relationnels, d'entiers constants, de chaînes constantes et de noms de champs de journal constituant une valeur unique. Vous devez utiliser des opérateurs logiques (AND ou OR, par exemple) pour regrouper des expressions.
Les opérateurs de relation pris en charge sont les suivants :
< supérieur à
> inférieur à
<= Inférieur à et égal à
<= Supérieur à et égal à
= Egal à
!= Différent de
Les opérateurs logiques pris en charge sont && (AND logique) et || (OR logique).
Les champs pré-définis des journaux sont les suivants :
Identifiant de produit PRODID (nombre entier ou chaîne)
Identifiant de créateur ORGID (nombre entier ou chaîne)
Date de début de variable locale spécifique STDATE (nombre entier ou chaîne de type long [comme 'mm/dd/yy'])
Date de fin de variable locale spécifique ENDATE (nombre entier ou chaîne de type long [comme 'mm/dd/yy'])
Temps précédent PREVTIME (chaîne [hh:mm:ss])
EXEMPLES
Exemple 1 - Déplacement automatique des fichiers journaux les plus anciens que NetBackup a créés dans le dossier /tmp/nblogs
. L'option --auto dépend du paramètre de configuration de NumberOfLogFiles.
# vxlogmgr -m --auto --dir /tmp/nblogs
Exemple 2 - Suppression des 15 derniers jours de fichiers journaux de NetBackup :
# vxlogmgr -d --prodid NB -n 15
Exemple 3 - Copier les fichiers journaux créés à partir de la date 01/22/12 par NetBackup :
# vxlogmgr -c --where "(prodid = NB) && (stdate >= '01/22/12')"
Systèmes UNIX :
--dir /usr/openv/logs
Systèmes Windows :
--dir c:\temp\logfiles
Exemple 4 - Copie des fichiers journaux créés entre le 10/10/11 et le 28/10/11, y compris par l'ID de produit 100 :
# vxlogmgr -c --where "(PRODID == 100) && ((STDATE >= '10/10/11')
Systèmes UNIX :
&& (ENDATE <= '10/28/11'))" --dir /usr/openv/logs
Systèmes Windows :
&& (ENDATE <= '10/28/11'))" --dir c:\temp\logfiles