Utilitaire AFUtil.exe

Point de récupération non récupérable suite à l'échec de sa fusion › Utilitaire AFUtil.exe

Utilitaire AFUtil.exe

L'utilitaire AFUtil.exe permet d'analyser une session de sauvegarde CA ARCserve D2D pour confirmer l'intégrité des données sauvegardées. Cet utilitaire doit être placé dans le dossier Bin pour l'installation de CA ARCserve D2D avant son utilisation. Lorsque cet utilitaire est exécuté sans paramètres, par défaut, il détermine la destination de sauvegarde configurée et analyse la session de sauvegarde complète la plus ancienne pour tous les ordinateurs protégés par CA ARCserve D2D. Toutefois, nous vous recommandons fortement d'analyser toutes les images de sauvegarde pour vous assurer que les données de ces points de récupération peuvent être restaurées.

Utilisation

AFUtil [<-|/><switch> [parameters]]

Remarque : Pour garantir l'analyse de chaque image, utilisez le commutateur /sid en procédant comme décrit dans le deuxième exemple. Vous devez exécuter l'utilitaire une fois par session.

Exemples :

Exécutez la commande suivante pour analyser la session de base la plus ancienne.
```
AFUtil
```

Exécutez la commande suivante pour analyser la cinquième session de sauvegarde.

AFUtil.exe /AFStor /dest <chemin_destination> /un <nom_utilisateur> /upwd <mot_passe> /sid 5

Exécutez la commande suivante pour analyser les sauvegardes complètes les plus anciennes pour tous les ordinateurs virtuels connectés au système proxy de sauvegarde pour le serveur CA ARCserve Central Host-Based VM Backup :
```
AFUtil.exe /AFStor /vm
```

Les commandes suivantes sont prises en charge par l'utilitaire AFUtili.exe :

Commande	Description
/?	Affiche une liste de toutes les commandes prises en charge.
/help	Affiche une liste de toutes les commandes prises en charge.
/AFStor	Commandes liées à la session.

Les commutateurs suivants sont pris en charge par la commande AFStor :

Remarque : Pour afficher la liste de tous les commutateurs pris en charge, utilisez la commande "AFUtil.exe /? AFStor"

Commutateur	Description
/dest <chemin_destination>	Dossier de destination de sauvegarde à analyser. Par défaut, l'utilitaire tentera de déterminer le chemin d'accès de sauvegarde à partir des paramètres CA ARCserve D2D configurés. Si les paramètres ne sont pas configurés ou si vous voulez analyser un autre chemin d'accès, vous pouvez utiliser ce commutateur. Remarque : Les chemins d'accès contenant des espaces doivent être entourés d'apostrophes doubles.
/un <nom_utilisateur>	Utilisez ce nom d'utilisateur pour vous connecter à la destination distante. Par défaut, le nom d'utilisateur est récupéré à partir des paramètres de sauvegarde CA ARCserve D2D. Si d'autres informations d'identification doivent être utilisées pour la connexion à la destination distante, vous pouvez utiliser ce commutateur.
/upwd <mot de passe>	Utilisez ce mot de passe pour vous connecter à la destination distante. Par défaut, le mot de passe est récupéré à partir des paramètres de sauvegarde CA ARCserve D2D. Si d'autres informations d'identification doivent être utilisées pour la connexion à la destination distante, vous pouvez utiliser ce commutateur.
/vhd <fichier D2D>	Utilisez ce commutateur pour analyser un fichier CA ARCserve D2D spécifique. Ce commutateur requiert le chemin complet et le nom du fichier CA ARCserve D2D à analyser. Vous ne pouvez pas combiner ce commutateur avec le commutateur /dest. Remarque : Les chemins d'accès contenant des espaces doivent être entourés d'apostrophes doubles.
/pwd <mot de passe>	Utilisez le mot de passe fourni pour déchiffrer les sessions. Par défaut, l'utilitaire essayera de lire le mot de passe à partir des fichiers CA ARCserve D2D si l'utilitaire est exécuté sur l'ordinateur où les sauvegardes ont été effectuées. Si l'utilitaire ne parvient pas à lire le mot de passe de chiffrement automatiquement, alors vous pouvez utiliser ce commutateur pour spécifier un mot de passe.
/offset <décalage de début>	L'analyse commence à partir de la valeur de décalage donnée. La valeur de décalage doit être spécifiée en octets. La plage valide est comprise entre 0 et la taille du disque. Si ce paramètre n'est pas spécifié, l'analyse démarre à partir de la valeur de décalage 0.
/sid <numéro de session>	Le nombre de session spécifié est analysé. Si ce commutateur n'est pas spécifié, l'utilitaire analysera uniquement la session de base la plus ancienne.
/size <taille>	Taille des données de la source à analyser (en octets). Si ce paramètre n'est pas spécifié, l'utilitaire analysera l'intégralité du disque.
/vm [UUID de l'ordinateur virtuel]	Ce commutateur permet d'analyser le système proxy de sauvegarde pour le serveur CA ARCserve Central Host-Based VM Backup d'après l'UUID spécifié pour l'ordinateur virtuel. Si l'UUID de l'ordinateur virtuel n'est pas spécifié, alors les sauvegardes complètes les plus anciennes de tous les ordinateurs virtuels protégés par le proxy CA ARCserve D2D sont analysées individuellement.

Valeur renvoyée

Si l'utilitaire AFUtil.exe s'exécute, la valeur de retour est 0. Si une erreur se produit lors de l'exécution de cet utilitaire, alors la valeur de retour ne sera pas 0.

Le tableau suivant contient la liste de tous les codes d'erreurs possibles lors de l'exécution de cet utilitaire ainsi que leur description.

Code/valeur de retour	Description
SCAN_RET_ENV_ERROR 0xE0000001	Attempted to run the utility on a machine where CA ARCserve D2D was not installed. (Vous avez tenté d'exécuter l'utilitaire sur un ordinateur sur lequel CA ARCserve D2D n'est pas installé). Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)
SCAN_RET_ACT_JOB 0xE0000002	Attempted to run this utility, but there is an active job running at the same time (such as a backup or merge job). (Vous avez tenté d'exécuter l'utilitaire alors qu'un job (de sauvegarde ou de fusion) est actif.) Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)
SCAN_RET_NET_ERROR 0xE0000003	Failed to connect to the specified destination folder because of an incorrect destination path, username, or password. (Echec de la connexion au dossier de destination spécifié, car le chemin de destination, le nom d'utilisateur ou mot de passe sont incorrects.) Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)
SCAN_RET_WEB_RUN 0xE0000004	Attempted to run this utility, but the CA ARCserve D2D web service is still running. (Cet utilitaire ne peut pas être exécuté si le service Web de CA ARCserve D2D est toujours en cours d'exécution.) The CA ARCserve D2D web service must be stopped before you can run the utility. (Arrêtez le service Web CA ARCserve D2D avant d'exécuter l'utilitaire.) Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)
SCAN_RET_DATA_BAD 0xE0000005	The utility has detected data corruption while scanning the backup session. (L'utilitaire a détecté des données endommagées lors de l'analyse de la session de sauvegarde.) Scan is NOT aborted immediately when this error is encountered and continues until the scan of the entire session is completed. (L'analyse n'est pas interrompue immédiatement lorsque cette erreur se produit. Elle se poursuit jusqu'à la fin de l'analyse de l'intégralité de la session.) The error message is displayed and an entry is included in the activity log. (Le message d'erreur apparaît et une entrée est incluse dans le journal d'activité.) For more detailed debugging information about this error, search for "<<!data corruption detected!>>" in the debug log. (Pour obtenir des informations de débogage détaillées concernant cette erreur, recherchez <<!data corruption detected!>> dans le journal de débogage.)
SCAN_RET_INVALID_UUID 0xE0000006	Attempted to run this utility, but the specified UUID for the VM is invalid. (Cet utilitaire ne peut pas être exécuté, car l'UUID spécifié pour l'ordinateur virtuel n'est pas valide.) Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)
SCAN_RET_INVALID_DEST 0xE0000007	Attempted to run this utility, but failed to find a valid destination folder for the scan. (Cet utilitaire ne peut pas être exécuté, car aucun dossier de destination valide n'a été trouvé pour l'analyse.) Scan is aborted immediately when this error is encountered. (L'analyse est interrompue immédiatement lorsque cette erreur se produit.)
SCAN_RET_INVALID_CMD 0xDFFFFFFF	Attempted to run this utility, but an invalid parameter was input when running the tool and a help message is displayed. (Cet utilitaire ne peut pas être exécuté, car un paramètre non valide a été entré lors de l'exécution de l'outil et un message d'aide apparaît.)
Other non-0 value (autre valeur différente de 0)	For more detailed information about this error, check the AFUtil.log located in the Logs folder in the CA ARCserve D2D installation path. (Pour obtenir des informations détaillées concernant cette erreur, consultez le fichier journal AFUtil.log qui se trouve dans le dossier Journaux à l'emplacement d'installation de CA ARCserve D2D.) Scan is not aborted immediately when this value is returned.The scan will continue until all disks are scanned, regardless if successful or not. (L'analyse n'est pas interrompue immédiatement lorsque cette valeur est renvoyée. Dans tous les cas, l'analyse se poursuivra jusqu'à ce que tous les disques soient analysés.)

Code/valeur de retour

Description

SCAN_RET_ENV_ERROR

0xE0000001

Attempted to run the utility on a machine where CA ARCserve D2D was not installed. (Vous avez tenté d'exécuter l'utilitaire sur un ordinateur sur lequel CA ARCserve D2D n'est pas installé).

Scan is aborted immediately when this error is encountered and the error message is displayed. (L'analyse est interrompue immédiatement lorsque cette erreur se produit et lorsque le message d'erreur apparaît.)

SCAN_RET_ACT_JOB

0xE0000002

Attempted to run this utility, but there is an active job running at the same time (such as a backup or merge job). (Vous avez tenté d'exécuter l'utilitaire alors qu'un job (de sauvegarde ou de fusion) est actif.)

SCAN_RET_NET_ERROR

0xE0000003

Failed to connect to the specified destination folder because of an incorrect destination path, username, or password. (Echec de la connexion au dossier de destination spécifié, car le chemin de destination, le nom d'utilisateur ou mot de passe sont incorrects.)

SCAN_RET_WEB_RUN

0xE0000004

Attempted to run this utility, but the CA ARCserve D2D web service is still running. (Cet utilitaire ne peut pas être exécuté si le service Web de CA ARCserve D2D est toujours en cours d'exécution.) The CA ARCserve D2D web service must be stopped before you can run the utility. (Arrêtez le service Web CA ARCserve D2D avant d'exécuter l'utilitaire.)

SCAN_RET_DATA_BAD

0xE0000005

The utility has detected data corruption while scanning the backup session. (L'utilitaire a détecté des données endommagées lors de l'analyse de la session de sauvegarde.)

Scan is NOT aborted immediately when this error is encountered and continues until the scan of the entire session is completed. (L'analyse n'est pas interrompue immédiatement lorsque cette erreur se produit. Elle se poursuit jusqu'à la fin de l'analyse de l'intégralité de la session.) The error message is displayed and an entry is included in the activity log. (Le message d'erreur apparaît et une entrée est incluse dans le journal d'activité.) For more detailed debugging information about this error, search for "<<!data corruption detected!>>" in the debug log. (Pour obtenir des informations de débogage détaillées concernant cette erreur, recherchez <<!data corruption detected!>> dans le journal de débogage.)

SCAN_RET_INVALID_UUID

0xE0000006

Attempted to run this utility, but the specified UUID for the VM is invalid. (Cet utilitaire ne peut pas être exécuté, car l'UUID spécifié pour l'ordinateur virtuel n'est pas valide.)

SCAN_RET_INVALID_DEST

0xE0000007

Attempted to run this utility, but failed to find a valid destination folder for the scan. (Cet utilitaire ne peut pas être exécuté, car aucun dossier de destination valide n'a été trouvé pour l'analyse.)

Scan is aborted immediately when this error is encountered. (L'analyse est interrompue immédiatement lorsque cette erreur se produit.)

SCAN_RET_INVALID_CMD

0xDFFFFFFF

Attempted to run this utility, but an invalid parameter was input when running the tool and a help message is displayed. (Cet utilitaire ne peut pas être exécuté, car un paramètre non valide a été entré lors de l'exécution de l'outil et un message d'aide apparaît.)

Other non-0 value (autre valeur différente de 0)

For more detailed information about this error, check the AFUtil.log located in the Logs folder in the CA ARCserve D2D installation path. (Pour obtenir des informations détaillées concernant cette erreur, consultez le fichier journal AFUtil.log qui se trouve dans le dossier Journaux à l'emplacement d'installation de CA ARCserve D2D.)

Scan is not aborted immediately when this value is returned.The scan will continue until all disks are scanned, regardless if successful or not. (L'analyse n'est pas interrompue immédiatement lorsque cette valeur est renvoyée. Dans tous les cas, l'analyse se poursuivra jusqu'à ce que tous les disques soient analysés.)