AFUtil.exe Utility

Recovery Point Merge Failure May Render Recovery Point Unrecoverable › AFUtil.exe Utility

AFUtil.exe Utility

The AFUtil.exe utility is used to scan a CA ARCserve D2D backup session to confirm the integrity of the backed-up data. This utility should be placed in the "Bin" folder for the CA ARCserve D2D installation prior to using it. When this utility is executed without any parameters, by default it will determine the configured backup destination and scan the oldest Full Backup session of all the machines that are protected by CA ARCserve D2D. However, it is strongly recommended to scan all backup images to ensure that data from these recovery points are restorable.

Usage

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

Note: To ensure each and every image is scanned, use the /sid switch as described in the second example. You will have to run the utility one time for every session.

Examples:

Run the following command to scan the oldest base session:
```
AFUtil
```

Run the following command to scan the 5th backup session:

AFUtil.exe /AFStor /dest <destination_path> /un <username> /upwd <password> /sid 5

Run the following command to scan the oldest Full backup for all of the VMs connected to the backup proxy system for the Host-Based VM Backup server:
```
AFUtil.exe /AFStor /vm
```

The following commands are supported by the AFUtili.exe utility:

Command	Description
/?	Displays a list of all supported commands.
/help	Displays a list of all supported commands.
/AFStor	Session related commands.

The following switches are supported by the AFStor command:

Note: You can view a list of all supported switches by using the "AFUtil.exe /? AFStor" command.

Switch	Description
/dest <destination_path>	Backup destination folder to scan. By default, the utility will try to determine the backup path from the configured CA ARCserve D2D settings. If the settings are not configured or if you want to scan a different path, this switch can be used. Note: Path names with spaces in them should be enclosed in double quotes.
/un <username>	Use this user name to connect to the remote destination. By default, the user name is retrieved from the CA ARCserve D2D backup settings. If different credentials are to be used to connect to the remote destination, this switch can be used.
/upwd <password>	Use this password to connect to the remote destination. By default the password is retrieved from the CA ARCserve D2D backup settings. If different credentials are to be used to connect to the remote destination, this switch can be used.
/vhd <D2D file>	Use this to scan a specific CA ARCserve D2D file. This switch requires the full path and name of the CA ARCserve D2D file to scan. This switch cannot be combined with ‘/dest’ switch. Note: Path names with spaces in them should be enclosed in double quotes.
/pwd <password>	Use the provided password for decrypting the sessions. By default, the utility will attempt to read the password from the CA ARCserve D2D files if the utility is run on the machine where the backups were performed. If the utility is not able to auto read the encryption password, then this switch can be used to specify a password.
/offset <start offset>	Start scanning at the given offset value. The offset value must be specified in bytes. Valid range is from 0 to the size of the disk. If this parameter is not specified, the scan starts from offset 0.
/sid <session number>	Scan the specified session number. If this switch is not specified, the utility will only scan the oldest base session.
/size <size>	Size of data (in bytes) of the source to be scanned. If this parameter is not specified, the utility will scan the entire disk.
/vm [VM UUID]	Used to scan the backup proxy system for the Host-Based Backup VM server based on the specified UUID for the VM. If the UUID for the VM is not specified, then the oldest Full backup of all the VMs protected by the CA ARCserve D2D proxy are scanned one by one.

Return Value

If the AFUtil.exe utility runs successfully, the return value is 0. If any error is encountered during the running of this utility, then the return value will not be 0.

The following table contains a listing of all possible error codes that can occur when attempting to run this utility and a corresponding description.

Return Value/Code	Description
SCAN_RET_ENV_ERROR 0xE0000001	Attempted to run the utility on a machine where CA ARCserve D2D was not installed. Scan is aborted immediately when this error is encountered and the error message is displayed.
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). Scan is aborted immediately when this error is encountered and the error message is displayed.
SCAN_RET_NET_ERROR 0xE0000003	Failed to connect to the specified destination folder because of an incorrect destination path, username, or password. Scan is aborted immediately when this error is encountered and the error message is displayed.
SCAN_RET_WEB_RUN 0xE0000004	Attempted to run this utility, but the CA ARCserve D2D web service is still running. The CA ARCserve D2D web service must be stopped before you can run the utility. Scan is aborted immediately when this error is encountered and the error message is displayed.
SCAN_RET_DATA_BAD 0xE0000005	The utility has detected data corruption while scanning the backup session. Scan is NOT aborted immediately when this error is encountered and continues until the scan of the entire session is completed. The error message is displayed and an entry is included in the activity log. For more detailed debugging information about this error, search for "<<!data corruption detected!>>" in the debug log.
SCAN_RET_INVALID_UUID 0xE0000006	Attempted to run this utility, but the specified UUID for the VM is invalid. Scan is aborted immediately when this error is encountered and the error message is displayed.
SCAN_RET_INVALID_DEST 0xE0000007	Attempted to run this utility, but failed to find a valid destination folder for the scan. Scan is aborted immediately when this error is encountered.
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.
Other non-0 value	For more detailed information about this error, check the AFUtil.log located in the Logs folder in the CA ARCserve D2D installation path. Scan is not aborted immediately when this value is returned.The scan will continue until all disks are scanned, regardless if successful or not.

Return Value/Code

Description

SCAN_RET_ENV_ERROR

0xE0000001

Attempted to run the utility on a machine where CA ARCserve D2D was not installed.

Scan is aborted immediately when this error is encountered and the error message is displayed.

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).

Scan is aborted immediately when this error is encountered and the error message is displayed.

SCAN_RET_NET_ERROR

0xE0000003

Failed to connect to the specified destination folder because of an incorrect destination path, username, or password.

Scan is aborted immediately when this error is encountered and the error message is displayed.

SCAN_RET_WEB_RUN

0xE0000004

Attempted to run this utility, but the CA ARCserve D2D web service is still running. The CA ARCserve D2D web service must be stopped before you can run the utility.

Scan is aborted immediately when this error is encountered and the error message is displayed.

SCAN_RET_DATA_BAD

0xE0000005

The utility has detected data corruption while scanning the backup session.

Scan is NOT aborted immediately when this error is encountered and continues until the scan of the entire session is completed. The error message is displayed and an entry is included in the activity log. For more detailed debugging information about this error, search for "<<!data corruption detected!>>" in the debug log.

SCAN_RET_INVALID_UUID

0xE0000006

Attempted to run this utility, but the specified UUID for the VM is invalid.

Scan is aborted immediately when this error is encountered and the error message is displayed.

SCAN_RET_INVALID_DEST

0xE0000007

Attempted to run this utility, but failed to find a valid destination folder for the scan.

Scan is aborted immediately when this error is encountered.

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.

Other non-0 value

For more detailed information about this error, check the AFUtil.log located in the Logs folder in the CA ARCserve D2D installation path.

Scan is not aborted immediately when this value is returned.The scan will continue until all disks are scanned, regardless if successful or not.