Avamar: La restauración de la base de datos de Exchange falla con un error avtar que indica que la base de datos no se encuentra en el respaldo

Caso:

• El requisito es restaurar una base de datos de Exchange, que llamamos "Database4" para este ejemplo.
• El proceso de restauración de la base de datos falla con un mensaje en el registro que indica que la ruta de Database4 no se encuentra en la pieza de respaldo; sin embargo, la base de datos está disponible para la restauración en la interfaz de usuario de Avamar (GUI y AUI).
•  Este es el tipo de mensaje de error que se ve en el registro de restauración:

avtar Error <5195>: Path "EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb" not found in backup. (Element 'Database4.edb' at position 3 in search path 'EX-Node3_00000000\H:\mountpoints\Database4\Database4.edb' not found) 

• La restauración de otra base de datos (por ejemplo, Database2) desde la misma pieza de respaldo y el mismo Exchange Server funciona según lo esperado. 

El entorno de Exchange presenta una configuración de base de datos no estándar compatible con Microsoft, pero se sabe que causa este problema en el producto Avamar.

En este escenario, la base de datos afectada (Database4) presenta mayúsculas y minúsculas incoherentes en la ruta de archivo de la base de datos.
Hay una incompatibilidad entre la "ruta de almacenamiento de la base de datos" del SO y la "ruta de ubicación de la base de datos" de la aplicación de ExchangeEjemplo

de una base de datos afectada (Database4):
Rutas de incompatibilidad: 

• La ruta del sistema operativo para las bases de datos se creó con la carpeta "Mount Point" en mayúsculas (letras M y P)

H:\MountPoints\Database4\Database4.edb

• La ruta de Database4 en la aplicación de Exchange se configuró con todas las letras en minúscula:

H:\mountpoints\Database4\Database4.edb

Ejemplo de una base de datos no afectada (Database2):
La ruta de acceso de la base de datos del sistema operativo y su ruta correspondiente dentro de la configuración de Exchange tienen el mismo uso de mayúsculas y minúsculas:

• Ruta de almacenamiento de la base de datos

H:\MountPoints\Database2\Database2.edb

• Ruta de ubicación de la base de datos

H:\MountPoints\Database2\Database2.edb

 
Para verificar esas rutas:

• Utilice el Explorador de Windows para comprobar la ruta del sistema operativo
• Use el Centro de administración de Exchange (EAC) para comprobar la configuración de la base de datos
  • >= propiedades servers/databases/<edit de la base de datos afectada>
    • Como alternativa, utilice el comando de Exchange PowerShell:

Get-MailboxDatabase -Identity <affected DB name> | Select-Object edbfilepath, logfolderpath | fl

La condición de incompatibilidad de mayúsculas y minúsculas hace que el proceso de Avamar (avtar) registre la información incorrecta de la base de datos en los metadatos de respaldo durante el proceso de respaldo.

En el momento de la restauración, el proceso avtar no identifica la ruta correcta de la base de datos. Por lo tanto, no puede restaurar la base de datos imprimiendo el mensaje "database not found in backup"

Para resolver la situación de incompatibilidad de mayúsculas y minúsculas en esta base de datos, el producto Avamar cuenta con una marca denominada "--use-case-sensitive-paths" que se encarga de este tipo de escenarios.

• La marca se debe agregar en el archivo "avexvss.cmd" en la carpeta var del cliente Avamar (ruta predeterminada "C:\Program Files\avs\var\") en todos los nodos DAG de Exchange que participan en el proceso de respaldo.
• Además, para los respaldos federados de DAG, la marca se debe agregar en el archivo "avexvss.cmd" en el directorio var del cliente de clúster
  • Esta es la ruta UNC compartida entre los nodos DAG y es necesaria para coordinar respaldos y almacenar archivos
    de registro y configuración del cliente DAG Ejemplo de ruta UNC "\\share-server\share-folder\DAGname\var\")
• El valor de la marca debe establecerse como "false" (su valor predeterminado es "true"):
  • --rutas-sensibles-a-caso-de-uso=false

• Si la marca solo se agrega al nodo proxy (en la configuración de DAG sin IP) o al cliente del clúster (en la configuración federada), el respaldo se realiza correctamente, pero la restauración puede fallar con este mismo problema.
• Por lo tanto, es importante agregar la marca mencionada en cada nodo de Exchange (del clúster DAG) que participe en el proceso de respaldo.

 
Establecer esta marca como "false" garantiza que todos los respaldos futuros no se verán afectados y que la restauración se realice correctamente para esos nuevos respaldos.

Los respaldos más antiguos no se corrigen con esta marca y requieren que se restaure un procedimiento especializado.

Este procedimiento especial se describe en Avamar: Cómo restaurar una base de datos de Exchange a partir de un respaldo afectado por el problema de incompatibilidad de mayúsculas y minúsculas en la ruta de la base de datos.

• Si la marca mencionada no se utiliza en un entorno de Exchange que presenta la incompatibilidad de mayúsculas y minúsculas, el respaldo puede fallar con este error:

avtar Error <7042>: Failed to create snapview, as one of the elements required for path "XXXXXXXXX.edb" not found in backup account '/XXXXXX' lablenum 3 (only found 'XXXX\E:' of path 'XXXX.edb').

• Esto se describe en la Guía del usuario de Avamar para Exchange VSS en el capítulo "Solución de problemas", sección "El respaldo falla debido a la distinción entre mayúsculas y minúsculas"
• También se documenta en Avamar: El respaldo de Exchange VSS falla con el error avtar "No se pudo crear snapview, ya que uno de los elementos necesarios para la ruta "XXXXX.edb" no se encontró"