Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bptpcinfo
- bpup
- bpverify
- cat_convert
- Utilitaire cat_export
- Utilitaire cat_import
- configurePorts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcomponentupdate
- Commande nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbexecute
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- Commande nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbjm
- nbkmsutil
- Commande nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- Commande nbrbutil
- nbregopsc
- nbreplicate
- nbrestorevm
- nbseccmd
- nbsetconfig
- Commande nbsnapimport
- Commande nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- Commande stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
Nom
vxlogview — affichage des journaux générés par le composant de consignation unifiée
Synopsis
[-A] [-b date_début] [-e date_fin] [-D] [-G répertoire] [-g lot_journaux] [-I] [-i id_fichier] [-K nom_hôte] [-L niveau_gravité] [-m entité] [-N niveautypes_message] [-n nombre_jours] [-o id_créateur] [-P id_processus] [-p id_produit] [-r résultat] [-s sujet] [-T id_thread] [-t hh:mm:ss] [-X jeton_contexte] [-y]
-a [-p id_produit] {[-d option_affichage,...] [-R répertoire_ressources] [-z fuseau_horaire] [-l paramètres_régionaux]}
-q nom_recherche -f nom_fichier {[-d option_affichage,...][-R répertoire_ressources] [-z fuseau_horaire] [-l paramètres_régionaux]}
-p id_produit -g lot_journaux | -i id_fichier {[-d option_affichage,...] [-R répertoire_ressources] [-z fuseau_horaire] [-l paramètres_régionaux]}
-p id_produit -w chaîne_recherche {[-d option_affichage,...] [-R répertoire_ressources] [-z fuseau_horaire] [-l paramètres_régionaux]}
-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 vxlogview vous permet d'afficher les journaux générés par la fonction de consignation unifiée. Vous pouvez spécifier des critères de recherche à l'aide des options de ligne de commande pour afficher des journaux spécifiques.
La fonction de consignation unifiée utilise le format d'identification standard de fichiers journaux suivant :
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écifiez les journaux à afficher.
- -A, --audit
Affiche les messages d'audit.
- -a, --all
Affiche tous les messages des fichiers journaux générés par plusieurs produits Veritas.
- -b, --stdate date_début
Affiche les messages consignés à la date et l'heure de début données.
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.
Entourez la date par des apostrophes sous UNIX et des guillemets doubles sous Windows. Par exemple :
-b '1/1/2013 12:00:00 AM'
Si l'option -b n'est pas spécifiée, les messages s'affichent depuis le début du fichier journal jusqu'à l'heure de fin spécifiée (voir l'option -e).
- -D, --debug
Affiche les messages de débogage du journal.
- -d, --display option_affichage,...
Affiche les champs de message spécifiés. Si vous spécifiez plusieurs options d'affichage (DisplayOptions), séparez-les par des virgules.
Vous pouvez spécifier une ou plusieurs options d'affichage (DisplayOption) parmi les suivantes :
D - Option d'affichage de la date
T - Horodatage d'affichage
m - Option d'affichage de type de message
p - Option d'affichage de l'ID de processus
t - Option d'affichage de l'ID de thread
P - Option d'affichage de l'ID de produit
O - Option d'affichage de l'ID de créateur
c - Option d'affichage de jeton de contexte
s - Affiche la gravité de l'entrée de journal de l'application
u - Option d'affichage du texte des messages des journaux
X - Option d'affichage du message du journal en cours
w - Affichage de l'utilisateur ayant consigné le diagnostic ou le message de débogage.
i - Option d'affichage du nom abrégé du produit
o - Option d'affichage du nom abrégé du créateur
all - Option d'affichage de tous les champs de l'enregistrement du journal
Si l'option -d n'est pas spécifiée, les champs suivants s'affichent par défaut :
- Date
- Time
- Who (pour les messages de diagnostic et de débogage uniquement)
- Severity (messages des applications uniquement)
- UMI (messages de diagnostic et des applications uniquement)
- message text
- -e, --endate date_fin
Affiche les messages consignés jusqu'à une certaine date et une certaine heure.
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.
Entourez la date par des apostrophes sous UNIX et des guillemets doubles sous Windows. Par exemple :
--endate '1/1/2013 12:00:00 PM'
Si l'option -e n'est pas spécifiée, vxlogview affiche des messages à partir de l'heure et la date données (reportez-vous à l'option -b) jusqu'à la fin du fichier journal.
- -f, --filename nom_fichier
Spécifie le chemin d'accès et le nom d'un fichier contenant une ou plusieurs requêtes. Utilisez cette option avec l'option -q.
- -G, --logdir répertoire
Affiche des journaux à partir du répertoire spécifié à la place du répertoire configuré. Vous devez spécifier un chemin absolu pour le répertoire.
- -g, --logset lot_journaux
Affiche les paramètres de configuration des journaux du lot de journaux spécifié (LogSet).
- -I, --diag
Affiche les messages de diagnostic du journal.
- -i, --fileid id_fichier
Affiche les messages consignés par un ID de fichier ou un ID de créateur partagé. La recherche porte uniquement sur les fichiers journaux créés par le processus spécifié. En limitant la recherche à certains fichiers journaux, la commande vxlogview renvoie un résultat plus rapidement. En comparaison, l'option vxlogview -o recherche dans tous les fichiers journaux unifiés les messages consignés par le processus spécifié.
- -K, --hostname nom_hôte
Affiche les messages consignés par le nom d'hôte spécifié.
- -L, --app -C | -E | -F | -M | -W
Affiche les messages du journal d'application. Vous pouvez utiliser les paramètres suivants avec l'option -L pour spécifier le niveau de gravité :
-C, --crit : une erreur critique s'est produite qui peut affecter la disponibilité de l'application.
-E, --err : une erreur s'est produite qui n'affecte pas l'application entière.
-F, --info : un message d'information.
-M, --emerg : un état d'urgence existe qui peut avoir comme conséquence une défaillance ou un arrêt du système d'exploitation.
-W, --warning : un avertissement est émis pour un problème qui a été détecté.
- -l, --locale paramètres_régionaux
Affiche les messages selon les paramètres régionaux spécifiés. Par défaut, il s'agit de l'anglais. Si cette option n'est pas spécifiée, les messages s'affichent selon les paramètres régionaux en cours.
- -m, --who entité
Affiche les messages consignés par le nom de fonction ou le nom de méthode d'entité donnés.
- -N, --level niveau -D | -I
Affiche les messages de débogage (-D) ou les messages de journal de diagnostic (-I) pour un niveau donné (niveau).
- -n, --days nombre_jours
Affiche les messages consignés depuis le nombre de jours spécifiés dans la variable nombre_jours.
- -o, --orgid id_créateur
Affiche les messages consignés par l'ID de créateur spécifié. Vous pouvez spécifier le numéro d'ID ou le nom abrégé du créateur. Par exemple, le composant Policy Execution Manager peut être spécifié par nbpem ou par son numéro d'ID de créateur : 116.
- -P, --pid ID_processus
Affiche les messages consignés par l'ID de processus spécifié.
- -p, --prodid id_produit
Affiche les messages consignés par le produit (identifié par un ID de produit). L'utilisateur peut spécifier le nom abrégé du produit à la place de l'identifiant. L'ID du produit NetBackup est égal à 51216 et l'ID du produit PBX est égal à 50936.
- -R, --resdir répertoire_ressources
Cette option utilise les ressources du répertoire spécifié plutôt que celles d'un répertoire de ressources de localisation configuré.
- -r, --result résultat
Affiche les messages d'audit contenant le résultat spécifié. Result peut être 0 ou 1.
- -S, --tailloop
Affiche continuellement les nouveaux messages consignés par une paire ID de produit/ID de fichier. Vous devez associer l'ID de produit (-p ProductID) et l'ID de fichier (-i FileID) à l'option tailloop (-S) sur la ligne de commande. L'ID de fichier correspond soit à un ID de créateur partagé ou non. L'option tailloop commence par afficher les 10 derniers messages consignés dans la console. Elle affiche ensuite tous les nouveaux messages des journaux. Utilisez la combinaison de touches Ctrl-C à tout moment pour arrêter la boucle.
- -s, --subject sujet
Affiche les messages d'audit avec le sujet spécifié.
- -T, --tid id_thread
Affiche les messages consignés par l'ID de thread spécifié.
- -t, --tail hh:mm:ss
Affiche les messages des dernières heures, minutes et secondes de la variable hh:mm:ss.
- -v, --version
Affiche les informations de version de cette commande.
- -w, --where chaîne_recherche
Spécifie une clause WHERE à utiliser lorsque vous interrogez les messages des journaux afin d'afficher un sous-ensemble de messages. Pour plus de détails sur QueryString, consultez le Guide de référence de consignation NetBackup.
- -X, --ctx jeton_contexte
Affiche les messages appartenant à une instance de contexte donnée. Les jetons de contexte permettent d'identifier les instances de contexte. Si le jeton de contexte est spécifié sur le paramètre "All", il affiche tous les noms de contexte et les jetons associés.
- -y, --displayhost
Affiche le nom d'hôte avec chaque message de journal affiché. Si les fichiers journaux proviennent de plusieurs hôtes, cette option permet d'afficher les messages selon l'hôte de provenance.
- -z, --timezone GMT+hh:ss | GMT-hh:ss
Affiche les messages selon un fuseau horaire spécifique.
ETAT DE SORTIE
Les valeurs de sortie suivantes sont renvoyées :
0 -- Achèvement réussi.
-1 -- Une erreur s'est produite.
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 ces expressions.
Les opérateurs de relation pris en charge incluent : < (inférieur à), > (supérieur à), <= (inférieur ou égal à), >= (plus grand que et égal à), = (égal à), et ! = (pas égal à).
Les opérateurs logiques pris en charge sont && (AND logique) et || (OR logique).
Les champs pré-définis peuvent être tout en majuscules ou tout en minuscules (par exemple : PID | pid). Ces champs contiennent les éléments suivants :
CTXTOK -- jeton de contexte (chaîne)
ENDATE -- date de fin de localisation spécifique (nombre entier ou chaîne de type long)
FILEID -- ID de créateur partagé (nombre entier)
HOSTNAME -- Nom de l'hôte source (chaîne avec apostrophes)
LEVEL -- Niveau de débogage et diagnostic. Le paramètre par défaut affiche toutes les informations (nombre entier entre 0 et 6)
MSGTYPE -- Les types de message suivants sont pris en charge :
DEBUG | debug DIAG | diag APP | app AUDIT | audit
ORGID -- ID de créateur (nombre entier ou chaîne)
PID -- ID de processus (nombre entier)
PREVTIME -- Heure précédente (chaîne hh:mm:ss)
PRODID -- ID de produit (nombre entier ou chaîne)
RETURNVAL -- Le champ de résultats de message d'audit (0 ou 1)
SEV -- Niveau de gravité. Le système prend en charge les types de gravité suivants :
INFO | info WARNING | warning ERR | err CRIT | crit EMERG | emerg
STDATE -- date de début de localisation spécifique (nombre entier ou chaîne de type long)
OBJET -- Champ de l'objet du message d'audit (chaîne)
TID -- ID de thread (nombre entier)
WHO -- La personne qui a consigné le message (chaîne)
EXEMPLES
Les exemples suivants fonctionnent sous UNIX et entourent les arguments avec des apostrophes pour fermer les arguments des options. Sous Windows, vous devez utiliser des guillemets doubles.
Exemple 1 - Afficher les messages de journal pour tous les produits installés :
# vxlogview -a
Exemple 2 - Afficher les messages de journal pour PBX (ID de produit 50936). Pour pouvoir exécuter cette commande, vous devez être un utilisateur autorisé avec des privilèges administrateur (root) Elle affiche uniquement la date, l'heure, le type de message et le texte du message :
# vxlogview --prodid 50936 --display D,T,m,x
Exemple 3 - Afficher les messages de journal NetBackup consignés entre le 11/18/10 et le 11/21/10 :
# vxlogview --where "(prodid = 'NB') && (stdate >= '11/18/10 0:0:0 AM' && endate <= '11/21/10 10:12:00 AM')"
Exemple 4 - Afficher les messages de journal créés à partir ou après les date et heure spécifiées (01/03/13, 11:00:00 AM) :
# vxlogview -b '1/03/13 11:00:00 AM'
Exemple 5 - Afficher les messages de journal qui ont été consignés dans la dernière heure :
# vxlogview --tail 1:00:00
Exemple 6 - Afficher les messages de journal d'audit qui ont un résultat de 0 :
# vxlogview --audit -r 0
Exemple 7 - Afficher les messages de journal de contexte pour l'instance de "job_context" :
# vxlogview --ctx 'jobid=4'