Avamar: come ripristinare un database Exchange da un backup Avamar interessato dal problema di mancata corrispondenza tra lettere maiuscole e minuscole nel percorso del database

Obiettivo:

• Ripristino di un database Exchange da un backup Avamar interessato dal problema di mancata corrispondenza tra lettere maiuscole e minuscole nel percorso del database, descritto in Avamar: Ripristino del database Exchange non riuscito con errore avtar indicante che il database non è stato trovato nel backup
• Questa soluzione alternativa viene utilizzata per ripristinare un database Exchange da un backup creato prima dell'applicazione del flag "--use-case-sensitive-paths"
• Utilizza il binario avtar.exe in un prompt dei comandi con privilegi elevati

• Se il backup che deve essere ripristinato è stato eseguito negli ultimi sette giorni (in rare occasioni), passare alla sezione relativa a ulteriori informazioni e seguire le istruzioni.

Prerequisiti della soluzione alternativa:

1. Nel sistema da cui viene avviato avtar.exe, Avamar Windows Client deve essere registrato sullo stesso Avamar Server in cui si trova il backup. Il plug-in di Exchange non è necessario per questa soluzione alternativa.
2. Il prompt dei comandi di Windows deve essere aperto come amministratore (prompt dei comandi con privilegi elevati); l'account utente deve disporre del privilegio di amministratore locale del sistema.
3. È necessario disporre delle credenziali per Avamar MCUser (o un altro utente Avamar con privilegi di ripristino).
4. Sono richiesti il percorso completo di Avamar Backup Client, il numero dell'etichetta di backup e il percorso completo del database.
5. L'unità di destinazione deve disporre di spazio libero su disco sufficiente per contenere i database e i file di registro relativi al ripristino (di seguito viene fornito un esempio di calcolo dello spazio).

Command Syntax: 

avtar.exe -x --internal --incpartials --status=60 --nostdout --debug --server=<IP/FQDN> --id=MCuser --ap=<password> --path=<domain/client> --labelnum=<label> --logfile=<Log path> --target=<Destination Path> <DB path to be restored without the mismatched section of the path> 

• Il percorso completo del client per l'opzione "---acnt" effettua distinzione tra maiuscole e minuscole ed è disponibile nel registro di backup (file di registro avtar o .alg). Vedere l'esempio:

    <flag type="string" value="/clients/Exchange/EX-Node1.Dell.com" name="path" />

• Il numero dell'etichetta di backup può essere visualizzato direttamente dalla sezione restore nell'interfaccia utente di Avamar (GUI o AUI).
• Per l'ultimo elemento del comando <percorso dell'elemento da ripristinare>, aprire il registro di backup (se ancora disponibile nella cartella /var) e cercare la sezione "targetlist", in cui identificare il percorso completo del database richiesto per il ripristino, vedere l'esempio per "database4":

  <targetlist>
    <view>
      <dir internal="true" labelnum="158" fullname="EX-Node4_00000000/H:/MountPoint/Database6" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node4_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />      
      <dir internal="true" labelnum="155" fullname="EX-Node3_00000000/H:/MountPoint/database5" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="155" fullname="EX-Node3_00000000/H:/mountpoint/database4" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="156" fullname="EX-Node3_00000000/C:/program files/avs/var/backupmetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="157" fullname="EX-Node2_00000000/H:/MountPoint//Database3" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="158" fullname="EX-Node2_00000000/H:/MountPoint/Database2" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node2_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="158" fullname="EX-Node1_00000000/H:/MountPoint/Database1" acnt="/clients/Exchange/EX-Node1.Dell.com" />
      <dir internal="true" labelnum="159" fullname="EX-Node1_00000000/C:/Program Files/avs/var/backupMetadata" acnt="/clients/Exchange/EX-Node1.Dell.com" />
    </view>
  </targetlist>

• Se il registro di backup non è più disponibile nella cartella /var, utilizzare le istruzioni "Recupero di un registro di backup Avamar dal server" nella sezione "Ulteriori informazioni" dell'articolo Avamar: Come raccogliere i registri per risolvere i problemi di backup e ripristino
• In questo esempio, il percorso è simile al seguente:

  • EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb

• Tuttavia, poiché il problema di mancata corrispondenza tra lettere maiuscole e minuscole è al livello "mountpoints", l'utilizzo di questo percorso completo comporterebbe l'errore di ripristino noto "Database not found in backup"
• Per risolvere questo problema di ripristino, il percorso viene tagliato dal livello immediatamente a sinistra dell'area di "mountpoints" con mancata corrispondenza. In questo esempio, il percorso utilizzato nel comando è il seguente:

  • EX-Node3_00000000\H:\

• Il risultato di questa soluzione alternativa è il ripristino di qualsiasi database Exchange, inclusi i registri delle transazioni (se si trovano nello stesso percorso nell'unità H:) ospitati sul nodo Exchange "EX-Node3" al momento del backup.
  • Questa operazione richiederebbe spazio libero su disco sufficiente sul sistema in cui viene eseguito il comando per ospitare tutti i registri di database e transazioni presenti su "EX-Node3" al momento del backup.
  • Ad esempio: se la dimensione completa del backup era di 3 TB, non richiederebbe necessariamente 3 TB di spazio libero per il ripristino: 
    • Richiede solo le dimensioni di tutti i database e i registri ripristinati dal nodo "EX-Node3"
    • Ad esempio, deve avere 400 GB anziché 3 TB, ovvero le dimensioni dei database 4 e 5 insieme ai registri corrispondenti
    • Lo spazio su disco deve essere calcolato caso per caso

Procedura alternativa:

1. Preparare il comando in un blocco note con le informazioni corrette (se i valori di logfile o target contengono spazi, devono essere racchiusi tra virgolette doppie)
2. Aprire il prompt dei comandi di Windows con privilegi elevati
3. Passare alla cartella in cui si trova il file binario "avtar.exe", percorso predefinito "C:\Program Files\avs\bin\"
4. Eseguire il comando precompilato, vedere l'esempio riportato di seguito

avtar.exe -x --internal --incpartials --status=60 --nostdout --debug --server=192.168.20.105 --id=MCUser --password=******** --account=/clients/Exchange/EX-Node1.Dell.com --labelnum=163 --logfile=D:/Restore_logs/Restore_163_Database4_30-08-2024.log --target=E:/Restore_Temp EX-Node3_00000000/H:/ 

5. Attendere il completamento del comando (viene restituito il prompt). A seconda delle dimensioni dei dati da ripristinare, potrebbe richiedere alcuni minuti o diverse ore
6. Una volta completato il comando, verificare che i database Exchange siano stati ripristinati correttamente insieme ai rispettivi registri delle transazioni
7. Se viene rilevato un problema durante il processo, esaminare i file di registro di ripristino, come indicato nell'esempio "D:/Restore_logs/Restore_163_Database4_30-08-2024.log".
   • Se è necessaria ulteriore assistenza, contattare il team di supporto Avamar utilizzando il processo Service Request

Attività successiva al ripristino:

• Se il ripristino ha esito positivo, il database ripristinato dovrebbe essere visualizzato nello stato "Dirty Shutdown".
• Ciò è dovuto al fatto che i file di registro delle transazioni non sono stati ancora riprodotti nel database.
• Per riprodurre nuovamente i registri, seguire questo articolo Avamar: Come ripristinare un database Exchange dallo stato "Dirty Shutdown"

• Se il backup che deve essere ripristinato è stato eseguito nei sette giorni precedenti, contattare immediatamente il team di supporto Avamar utilizzando il processo di Service Request (rare occasioni).
• Segnalare che questo articolo è stato letto e fornire il relativo riferimento al team di supporto.
• Il team di supporto Avamar aiuta a eseguire il ripristino utilizzando una procedura leggermente diversa, ma più efficace.