Utilitário AFUtil.exe

Uma falha ao mesclar do ponto de recuperação pode tornar o ponto de recuperação irrecuperável › Utilitário AFUtil.exe

Utilitário AFUtil.exe

O utilitário AFUtil.exe é usado para verificar uma sessão de backup da Arcserve UDP para confirmar a integridade dos dados de backup. Esse utilitário deve ser colocado na pasta “Bin” para a instalação da Arcserve UDP antes de usá-lo. Quando esse utilitário for executado sem parâmetros, por padrão, ele irá determinar o destino do backup configurado e verificará a sessão de Backup completo mais antiga de todos os computadores protegidos pela Arcserve UDP. Entretanto, é altamente recomendável verificar todas as imagens de backup para garantir que os dados desses pontos de recuperação sejam restauráveis.

Observação: o utilitário AFUtil.exe se aplica somente se o Formato dos dados de backup estiver definido como Padrão.

Uso:

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

Observação: para garantir que cada imagem seja verificada, use a opção /sid, conforme descrito no segundo exemplo. Você terá que executar o utilitário uma vez para cada sessão.

Exemplos:

Execute o seguinte comando para verificar a sessão base mais antiga:
```
AFUtil
```

Execute o seguinte comando para verificar a quinta sessão de backup:

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

Execute o seguinte comando para verificar os backups completos mais antigos de todas as máquinas virtuais conectadas ao sistema proxy de backup para o servidor do Host-Based VM Backup:
```
AFUtil.exe /AFStor /vm
```

Os seguintes comandos são suportados pelo utilitário AFUtili.exe:

Comando	Descrição
/?	Exibe uma lista de todos os comandos suportados.
/help	Exibe uma lista de todos os comandos suportados.
/AFStor	Comandos relacionados à sessão.

As opções a seguir são suportadas pelo comando AFStor:

Observação: é possível visualizar uma lista de todas as opções suportadas usando o "AFUtil.exe /? comando AFStor"

Switch	Descrição
/dest <destination_path>	Pasta de destino de backup a ser verificada. Por padrão, o utilitário tentará determinar o caminho de backup das definições configuradas de Arcserve UDP. Essa opção poderá ser usada se as definições não estiverem configuradas ou se quiser verificar um caminho diferente. Observação: os nomes de caminho com espaços devem estar entre aspas duplas.
/un <username>	Use este nome de usuário para se conectar ao destino remoto. Por padrão, o nome do usuário é recuperado das configurações de backup da Arcserve UDP. Se outras credenciais forem usadas para a conexão com o destino remoto, essa opção pode ser usada.
/upwd <password>	Use esta senha para se conectar ao destino remoto. Por padrão, a senha é recuperada das configurações de backup da Arcserve UDP. Se outras credenciais forem usadas para a conexão com o destino remoto, essa opção pode ser usada.
/vhd <D2D file>	Use esta opção para verificar um arquivo específico da Arcserve UDP. Essa opção exige o caminho completo e o nome do arquivo para verificação. Não é possível combinar essa opção com a opção ‘/dest’ . Observação: os nomes de caminho com espaços devem estar entre aspas duplas.
/pwd <password>	Use a senha fornecida para descriptografar as sessões. Por padrão, o utilitário tentará ler a senha a partir de arquivos da Arcserve UDP, caso o utilitário for executado no computador em que os backups foram realizados. Se o utilitário não conseguir ler automaticamente a senha de criptografia, essa opção pode ser usada para especificar uma senha.
/offset <start offset>	Iniciar verificação no valor de deslocamento determinado.. O valor de deslocamento deve ser especificado em bytes. O intervalo válido é de 0 até o tamanho do disco. Se esse parâmetro não for especificado, a verificação será iniciada no deslocamento 0.
/sid <session number>	Verificar o número de sessão especificada. Se essa opção não for especificada, o utilitário verificará apenas a sessão base mais antiga.
/size <size>	Tamanho dos dados (em bytes) de origem a serem verificados. Se esse parâmetro não for especificado, o utilitário verificará o disco inteiro.
/vm [VM UUID]	Usado para verificar o sistema proxy de backup para o servidor do Host-Based Backup VM com base na UUID especificado para a máquina virtual. Se o UUID para a máquina virtual não for especificado, os Backups completos mais antigos de todas as máquinas virtuais protegidas pelo proxy da Arcserve UDP são verificados um a um.

Valor de retorno

Se o utilitário AFUtil.exe for executado com êxito, o valor de retorno será 0. Se algum erro for encontrado durante a execução desse utilitário, o valor de retorno não será 0.

A tabela a seguir contém uma lista de todos os possíveis códigos de erro que podem ocorrer ao tentar executar esse utilitário e uma descrição correspondente.

Valor/código de retorno	Descrição
SCAN_RET_ENV_ERROR 0xE0000001	Tentativa de executar o utilitário em um computador no qual a Arcserve UDP não está instalada. A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.
SCAN_RET_ACT_JOB 0xE0000002	Tentativa de executar esse utilitário, mas houve uma tarefa ativa em execução ao mesmo tempo (como uma tarefa de backup ou de mesclagem). A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.
SCAN_RET_NET_ERROR 0xE0000003	Ocorreu um erro ao se conectar com a pasta de destino especificada devido a um caminho de destino, nome de usuário ou senha incorreto. A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.
SCAN_RET_WEB_RUN 0xE0000004	Tentativa de executar esse utilitário, mas o serviço web da Arcserve UDP ainda está em execução. O serviço web da Arcserve UDP deve ser interrompido antes que seja possível executar o utilitário. A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.
SCAN_RET_DATA_BAD 0xE0000005	O utilitário detectou dados corrompidos durante a verificação da sessão de backup. A verificação NÃO é interrompida imediatamente quando este erro é encontrado e continua até que a verificação de toda a sessão seja concluída. A mensagem de erro é exibida e uma entrada é incluída no log de atividades. Para obter informações mais detalhadas de depuração sobre o erro, consulte <<!dados corrompidos detectados!>> no log de depuração.
SCAN_RET_INVALID_UUID 0xE0000006	Tentativa de executar esse utilitário, mas a UUID especificada para a máquina virtual é inválida. A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.
SCAN_RET_INVALID_DEST 0xE0000007	Tentativa de executar esse utilitário, mas não conseguiu encontrar uma pasta de destino válida para a verificação. A verificação é interrompida imediatamente quando este erro é encontrado.
SCAN_RET_INVALID_CMD 0xDFFFFFFF	Tentativa de executar esse utilitário, mas um parâmetro inválido foi inserido ao executar a ferramenta e uma mensagem de ajuda é exibida.
Outros valores diferentes de zero	Para obter informações mais detalhadas sobre o erro, verifique o AFUtil.log localizado na pasta Logs, no caminho de instalação da Arcserve UDP. A verificação não é interrompida imediatamente quando esse valor é retornado.A verificação continuará até que todos os discos sejam verificados, independentemente se for bem-sucedida ou não.

Valor/código de retorno

Descrição

SCAN_RET_ENV_ERROR

0xE0000001

Tentativa de executar o utilitário em um computador no qual a Arcserve UDP não está instalada.

A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.

SCAN_RET_ACT_JOB

0xE0000002

Tentativa de executar esse utilitário, mas houve uma tarefa ativa em execução ao mesmo tempo (como uma tarefa de backup ou de mesclagem).

A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.

SCAN_RET_NET_ERROR

0xE0000003

Ocorreu um erro ao se conectar com a pasta de destino especificada devido a um caminho de destino, nome de usuário ou senha incorreto.

A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.

SCAN_RET_WEB_RUN

0xE0000004

Tentativa de executar esse utilitário, mas o serviço web da Arcserve UDP ainda está em execução. O serviço web da Arcserve UDP deve ser interrompido antes que seja possível executar o utilitário.

A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.

SCAN_RET_DATA_BAD

0xE0000005

O utilitário detectou dados corrompidos durante a verificação da sessão de backup.

A verificação NÃO é interrompida imediatamente quando este erro é encontrado e continua até que a verificação de toda a sessão seja concluída. A mensagem de erro é exibida e uma entrada é incluída no log de atividades. Para obter informações mais detalhadas de depuração sobre o erro, consulte <<!dados corrompidos detectados!>> no log de depuração.

SCAN_RET_INVALID_UUID

0xE0000006

Tentativa de executar esse utilitário, mas a UUID especificada para a máquina virtual é inválida.

A verificação é interrompida imediatamente quando este erro for encontrado e a mensagem de erro será exibida.

SCAN_RET_INVALID_DEST

0xE0000007

Tentativa de executar esse utilitário, mas não conseguiu encontrar uma pasta de destino válida para a verificação.

A verificação é interrompida imediatamente quando este erro é encontrado.

SCAN_RET_INVALID_CMD

0xDFFFFFFF

Tentativa de executar esse utilitário, mas um parâmetro inválido foi inserido ao executar a ferramenta e uma mensagem de ajuda é exibida.

Outros valores diferentes de zero

Para obter informações mais detalhadas sobre o erro, verifique o AFUtil.log localizado na pasta Logs, no caminho de instalação da Arcserve UDP.

A verificação não é interrompida imediatamente quando esse valor é retornado.A verificação continuará até que todos os discos sejam verificados, independentemente se for bem-sucedida ou não.