Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
Nom
cat_convert — exécute l'utilitaire de conversion de format de catalogue NetBackup
Synopsis
-a2b [-o] [-s] [-v] répertoire_fichier_source [répertoire_fichier_cible]
-dump [-short] [-noheader] [-nopath] [-nodata] [-srec num] [-erec num] [-sep char] fichier_source
-check fichier_source
-decompress fichier_compressérépertoire_fichier_cible
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
cat_convert convertit les fichiers de catalogue .f
NetBackup du format ASCII version 3.4, 4.0v ou 4.5 au format binaire version 4.5 ou ultérieure. Il détecte automatiquement le format de fichier catalogue source et le convertit en l'autre format.
L'option -dump permet à des utilisateurs d'afficher le contenu des fichiers images binaires de catalogue .f (point-f). Elle fait écho au contenu du fichier .f
à stdout dans un format accessible en lecture. Elle contient également des options d'aide pour limiter la sortie à certains enregistrements dans le fichier ou à un ensemble de colonnes de sortie uniquement.
L'option -check permet de vérifier la cohérence sur les fichiers .f
binaires spécifiés.
L'option -decompress vous permet de décompresser les fichiers .f
binaires spécifiés qui ont été compressés au format .Zl. Elle prend également en charge la décompression au format .Z
sur les plates-formes UNIX.
Si cat_convert détecte des incohérences, l'utilitaire génère jusqu'à quatre rapports parmi les suivants qui dépendent des types d'incohérences signalées :
Rapport non valide d'inode
Ce rapport liste les inodes non valides. Voici un exemple :
Type Problem Additional Information Dir No Data Path element name: SUNWmlib Dir No Name Filenum: 7 File No Data Path element name: vmd.uds File No Data Path element name: bpcompatd.uds File No Name Filenum: 8356 Dir No Name Filenum: 8374
Les éléments ci-dessous passent en revue les informations contenues dans les colonnes de ce rapport :
Type - s'affiche si l'élément est un fichier ou un répertoire.
Problème - s'affiche si aucune données ou aucun nom n'est la cause de l'inode non valide.
Informations supplémentaires - le nom d'élément de chemin d'accès qui est associé à l'inode, au champ filenum que le catalogue a reçu pour l'inode ou à un message d'erreur.
Rapport de répertoire non valide
Ce rapport liste les répertoires incohérents. Voici un exemple :
Index InodeIndex 1stChild 1stDir LastChild NextIndex NextDir Name 2539 2230 5605F -1 5605F 788763F -1 JSP.cla 21281 2229 43380F -1 1122108F 257809F 56110 fr.tmp 24157 3330 53103F -1 2688747F -1F -1 UNKNOWN 36766 4406 98367F -1 98367F -1F -1 Root 97393 5134 471040F -1 3136322F -1F -1 udst.js Total Directories: 150307 Total Files: 1137006
Les éléments ci-dessous passent en revue les informations contenues dans les colonnes de ce rapport :
Index : emplacement relatif du fichier tel que répertorié dans le catalogue.
Index de nœud d'index : index d'un fichier temporaire contenant les informations du nœud d'index lors de la sauvegarde.
1er enfant - l'index sur le premier enfant (fichier ou répertoire) sous le répertoire énuméré. Cette valeur est -1 s'il n'y a aucun enfant. Le caractère F suit l'index si le premier enfant est un fichier ou le caractère D suit l'index si c'est un répertoire.
1er Dir - l'incrément sur le répertoire sous le répertoire énuméré. Cette valeur est -1 s'il n'y a aucun sous-répertoire.
1er enfant - l'incrément sur le premier enfant (fichier ou répertoire) sous le répertoire énuméré. Cette valeur est -1 s'il n'y a aucun enfant. Le caractère F suit l'incrément si le premier enfant est un fichier ou le caractère D suit l'incrément si c'est un répertoire.
Index suivant - l'incrément sur l'enfant de mêmes parents suivant (fichier ou répertoire) du fichier énuméré. Cette valeur est -1 s'il n'y a aucun enfant de mêmes parents. Le caractère F suit l'incrément si le premier enfant est un fichier ou le caractère D suit l'incrément si c'est un répertoire.
Dir suivant - l'incrément sur le répertoire suivant d'enfant de mêmes parents du répertoire énuméré. Cette valeur est -1 si aucun répertoire d'enfant de mêmes parents n'existe.
Nom : nom abrégé du répertoire si disponible ou INCONNU si non disponible.
Rapport de fichier non valide
Ce rapport liste les fichiers incohérents. Le format du rapport est le suivant :
Index Inode Index Next Index Name 2364 12180 2368F Report.doc 39774 16642 39776D UNKNOWN
Les éléments ci-dessous passent en revue les informations contenues dans les colonnes de ce rapport :
Index : emplacement du fichier tel que répertorié dans le catalogue.
Index de nœud d'index : index d'un fichier temporaire contenant les informations du nœud d'index lors de la sauvegarde.
Index suivant - l'incrément sur l'enfant de mêmes parents suivant (fichier ou répertoire) du fichier énuméré. Cette valeur est -1 s'il n'y a aucun enfant de mêmes parents. Le caractère F suit l'incrément si le premier enfant est un fichier ou le caractère D suit l'incrément si c'est un répertoire.
Nom : nom abrégé du répertoire si disponible ou INCONNU si non disponible.
Rapport de répertoire et fichier non valide
Ce rapport liste les fichiers et répertoires incohérents. Le format du rapport est le suivant :
Index Inode Type Name 2363 11134 Directory /Documents/Directory 1 13679 10077 Directory /Documents/Directory 2 Total Directories: 460724 Total Files: 3426572
Les éléments ci-dessous passent en revue les informations contenues dans les colonnes de ce rapport :
Index : emplacement du fichier tel que répertorié dans le catalogue.
Inode - le nombre d'inode du fichier ou du répertoire qui est signalé au catalogue.
Type - s'affiche si l'élément est un fichier ou un répertoire.
Nom : nom abrégé du répertoire si disponible ou INCONNU si non disponible.
Puisque ce rapport traverse l'arborescence des répertoires, il peut ne pas lister tous les fichiers ou répertoires qui sont signalés dans les deux premiers rapports. Puisqu'il fournit le nom entièrement qualifié du fichier ou du répertoire, il peut être utile dans la résolution du problème. Il fournit également le nombre total de fichiers et de répertoires.
Ces rapports ne sont pas localisés.
Vous devez être connecté en tant qu'administrateur pour exécuter cette commande.
OPTIONS
- -a2b
Convertit les fichiers de catalogue
.f
NetBackup au format ASCII 3.4, 4.0V et 4.5 en fichiers.f
NetBackup au format binaire 4.5.- -check fichier_source
Vérifie la cohérence d'un fichier .f binaire. source_file doit correspondre au chemin d'accès entièrement qualifié. Les incohérences peuvent être dues à des sauvegardes défectueuses de type FlashBackup ou NDMP. Si cet utilitaire ne détecte aucune incohérence, il se termine silencieusement et renvoie un code de retour zéro. Si l'utilitaire détecte des incohérences, il renvoie le nombre d'incohérences et imprime jusqu'à trois rapports selon les types d'incohérences signalés.
- -decompress fichier_compressé répertoire_fichier_cible
Décompresse le fichier .f binaire compressé spécifié. fichier_compressé doit correspondre au chemin d'accès complet. -decompress décompresse les fichiers de catalogue qui ont été compressés au format
.Zl
. Sous UNIX, elle prend également en charge la décompression au format.Z
. répertoire_cible correspond au répertoire où le fichier est placé suite à l'opération de décompression.- -dump
Vous permet d'afficher le contenu des fichiers images de catalogue
.f
.- -erec num
Modifie la sortie à partir de l'option -dump de cat_convert. Interrompt l'affichage des enregistrements à partir de ce numéro d'enregistrement.
Remarque :
Le numéro d'enregistrement n'est pas forcément identique au numéro de fichier indiqué dans la première colonne de la sortie.
- -nodata
Elimine la colonne de données à partir de la sortie de l'option -dump de cat_convert. La colonne de données peut entraîner des sorties excessivement grandes.
- -noheader
Modifie la sortie à partir de l'option -dump de cat_convert. Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Elimine les en-têtes de colonnes.
- -nopath
Modifie la sortie à partir de l'option -dump de cat_convert. Elimine la colonne de chemin d'accès. La colonne de chemin d'accès peut entraîner des sorties excessivement grandes.
- -o
Remplacez le contenu de fichier de catalogue initial par le nouveau format converti. L'option -o ne peut pas être utilisée avec répertoire_fichier_cible.
- -s
Affiche les informations de statistiques dans la fenêtre de la console.
- -sep char
Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Utiliser des caractères char pour séparer les colonne au lieu des espaces (paramètres de séparation par défaut). Par exemple, vous pouvez utiliser cette commande pour générer une sortie séparée par des virgules.
- -short
Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Limite la sortie à un sous-ensemble des colonnes habituelles.
- -srec num
Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Une option qui modifie la sortie à partir de l'option -dump de cat_convert. Démarre l'affichage des enregistrements à partir de ce numéro d'enregistrement.
Remarque :
Le numéro d'enregistrement n'est pas forcément identique au numéro de fichier indiqué dans la première colonne de la sortie.
- répertoire_fichier_cible
- -v
Affiche les informations de progression en cours.
Spécifiez l'une des options suivantes à convertir :
Pour spécifier un fichier cible, la source doit être un fichier.
Pour spécifier un répertoire, la source doit être un répertoire.
Si la source est un répertoire, vous devez utiliser -a2b.
Les fichiers que la conversion crée sont convertis au format spécifié et les noms de fichier sont utilisés dans le répertoire.
Si vous ne spécifiez pas le fichier ou le répertoire cible quand vous convertissez des fichiers source, les fichiers que le processus de conversion crée ont un suffixe ajouté. (_bin.f ou _ascii.f).
Si la taille du fichier de catalogue .f
est supérieure à 4 Mo, le catalogue binaire laisse les fichiers de sortie à part. Il les met dans le répertoire catstore.
EXEMPLES
Exemple 1
# cat_convert -a2b abc.f
Si abc.f est dans le format ASCII, target_file_path est abc_bin.f.
Exemple 2
# cat_convert -a2b abc.f
Le contenu de abc.f est converti au format binaire.
Exemple 3
# cat_convert -dump -short abc.f
Le contenu de abc.f apparaît dans stdout dans un format accessible en lecture par l'utilisateur.