Avamar: Disparidades de ID do client (CID) com a correção do Goav
Summary: As disparidades de ID do client (CID) e as incompatibilidades de caminho ocorrem nos Avamar Servers quando a Global Storage Area Network (GSAN) e o Management Console Service Database (MCDB) diferem ao armazenar informações de contabilidade do client. ...
Symptoms
Navegar em um client na interface do usuário do Avamar (AUI) ou no Avamar Administrator mostra a mensagem de erro: Internal Administrator Client Error.
Um client não é exibido na AUI.
A caixa de seleção procurar subdomínio na AUI não retorna resultados e pode possivelmente exibir um erro.
O seguinte erro é relatado: 0 ERROR! Exit code 74: Account not found in the Avamar database.
Cause
Visão geral
As disparidades de ID do client (CID) e as incompatibilidades de caminho ocorrem nos Avamar Servers quando a Global Storage Area Network (GSAN) e o Management Console Service Database (MCDB) diferem ao armazenar informações de contabilidade do client.
As informações de contabilidade do cliente são armazenadas em dois locais: GSAN e MCDB.
Há dois itens importantes a serem armazenados para um cliente.
- O caminho completo do client:
-
/clients/w11ofsd.lab.com
-
- O ID exclusivo do cliente (CID):
-
c7d083d712377955d84a52d2d618b47e33fa1ef
-
Uma correspondência adequada entre o GSAN e o MCDB seria que o caminho do client e o CID correspondessem.
Em um ambiente de replicação, o Avamar Server de destino tem o domínio chamado "/REPLICATE".
Este é um domínio somente do GSAN. O MCDB não armazena informações sobre clients replicados nesse domínio.
Há alguns cenários em que o GSAN e o MCDB podem ser diferentes ao armazenar as informações de contabilidade do cliente:
- Existe um caminho de client em um armazenamento, mas não no outro, e o CID não corresponde.
- Existe um caminho de client em um armazenamento, mas não no outro, e o CID corresponde a um client com um caminho diferente no outro armazenamento.
- Existe um caminho do client em ambos os repositórios, mas o ID do client não corresponde.
A verificação manual das informações contábeis do cliente pode ser feita no GSAN e no MCDB.
GSAN
avmgr getl --path=<domain_of_client_path> | grep -i <client_name>
Exemplo:
admin@avamar:~/>: avmgr getl --path=/clients | grep -i w11ofsd.lab.com 1 w11ofsd.lab.com location: c7d083d712377955d84a52d2d618b47e33fa1ef1 pswd: 89e28a1932a8d1b4a4f9e2883e03a9f33f5082d1
A partir do exemplo, c7d083d712377955d84a52d2d618b47e33fa1ef1 é o CID, e o caminho completo é /clients/w11ofsd.lab.com.
No GSAN, uma pesquisa semelhante pode ser feita para resolver o caminho completo do cliente a partir de um CID:
admin@avamar:~/>: avmgr resf --acnt=ref{c7d083d712377955d84a52d2d618b47e33fa1ef1}
1 Request succeeded
/clients/w11ofsd.lab.com c7d083d712377955d84a52d2d618b47e33fa1ef1
MCDB
psql -p 5555 mcdb -U admin -c "select cid,descr from clients where cid='<CID>'"
Exemplo:
admin@avamar:~/>: psql -p 5555 mcdb -U admin -c "select cid,descr from clients where cid='c7d083d712377955d84a52d2d618b47e33fa1ef1'" cid | descr ------------------------------------------+--------------------------------------- c7d083d712377955d84a52d2d618b47e33fa1ef1 | /clients/w11ofsd.lab.com (1 row)
A partir do exemplo, c7d083d712377955d84a52d2d618b47e33fa1ef1 é o CID, e o caminho completo é /clients/w11ofsd.lab.com.
Se não houver uma correspondência íntegra entre o GSAN e o MCDB, essa será uma disparidade de CID.
Resolution
A ferramenta GoAV é usada para corrigir automaticamente disparidades de CID.
Faça download e instale a ferramenta Goav.
000192151 | Avamar: Ferramenta
GoavExecute o seguinte comando para verificar se há incompatibilidades de CID e gerar dois arquivos de relatório:
./goav client cid-mismatch check
Há um arquivo de relatório seguro e não seguro. Analise os dois para obter uma explicação.
Exemplo:
admin@avamar:~/>: ./goav client cid-mismatch check =========================================================== GoAv : 1.80 Avamar : 19.10 Date : 19 Aug 2024 16:20 -03 =========================================================== COMMAND : ./goav client cid-mismatch check NOTE: This is not an official tool =========================================================== Client CID & Path Mismatch Script --------------------------------- Load GSAN clients from avmgr cpdb Load MCS clients from mcdb Analyze GSAN mismatches GSAN path /MC_DELETED/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ2021.09.01.13.38.57 does not exist in MCDB, but the GSAN cid b8429c8a089567b7a1aa8cfa7608b735413630ab exists in MCDB at path /avamarVC/VirtualMachines/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ, and has 0 backups GSAN Mismatch Count: 1 Analyze MCDB mismatches MCDB path /avamarVC/VirtualMachines/DPADatastoreServer_bgVYLK0WONuiFagzVngqBQ does not exist in GSAN, but the MCDB cid b8429c8a089567b7a1aa8cfa7608b735413630ab exists in GSAN at path MCDB Mismatch Count: 1 Report Files Generated ---------------------- Safe Report: /home/admin/goav_clients/client_cid_mismatch_report_SAFE_delete_2024-08-19-1724095237 Unsafe Report: /home/admin/goav_clients/client_cid_mismatch_report_UNSAFE_delete_2024-08-19-1724095237
Na parte inferior do resultado no exemplo, há informações sobre a localização dos arquivos de relatório.
As disparidades de CID que foram designadas como seguras para remoção não exigem análise e aprovação do SME e podem ser resolvidas sem a intervenção do Suporte Dell.
As disparidades de CID designadas como não seguras exigem análise e aprovação do SME.
O cliente ou o engenheiro de suporte fornece os arquivos de relatório e a solicitação de chave de acesso seguro do Goav a um SME para corrigir disparidades não seguras.
Exemplo inseguro:
./goav client cid-mismatch fix
Process CID Mismatch Reports ---------------------------- Parsing reports for mismatches to fix No safe mismatches found to fix Provide the following CID mismatch unsafe auto-fix key request to an SME --> 1709325232,1724098448 <--- >
No exemplo de disparidades não seguras acima, o SME concede uma chave de acesso segura com base na solicitação 1709325232,1724098448.
O que torna uma disparidade de CID segura ou insegura para remover?
As disparidades de CID seguro ocorrem em que o caminho do client existe em um armazenamento, mas não no outro. O CID não corresponde ao CID de um client com um caminho diferente no outro armazenamento e não tem backups no GSAN.
As disparidades não seguras de CID são consideradas por meio dos seguintes cenários:
- O client ainda tem backups no GSAN para remover.
- O caminho do client não existe no outro armazenamento, mas tem um CID correspondente a um caminho diferente.
- Os caminhos do client correspondem em ambos os armazenamentos e têm um CID diferente.