Restaurar una base de datos SAP HANA en una EC2 instancia de Amazon - AWS Backup
Restaure una base de datos de SAP HANA con la AWS Backup consolaStartRestoreJob API para SAP HANA en EC2CLI para SAP HANA en EC2Restauración de alta disponibilidad (HA) de SAP HANASolución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Restaurar una base de datos SAP HANA en una EC2 instancia de Amazon

Las bases de datos de SAP HANA en las EC2 instancias se pueden restaurar mediante la AWS Backup consola, la API o mediante AWS CLI.

Restaure una base de datos de SAP HANA con la AWS Backup consola

Tenga en cuenta que los trabajos de copia de seguridad y restauración que involucren la misma base de datos no pueden realizarse simultáneamente. Cuando se realiza un trabajo de restauración de una base de datos de SAP HANA, es probable que al intentar hacer una copia de seguridad de la misma base de datos se produzca un error: "Database cannot be backed up while it is stopped".

  1. Acceda a la AWS Backup consola con las credenciales de los requisitos previos.

  2. En el menú desplegable Ubicación de restauración de destino, elija una base de datos para sobrescribirla con el punto de recuperación que va a utilizar para la restauración (tenga en cuenta que la instancia que aloja la base de datos de destino de la restauración también debe tener los permisos establecidos en los requisitos previos).

    importante

    Las restauraciones de bases de datos de SAP HANA son destructivas. La restauración de una base de datos sobrescribirá la base de datos en la ubicación de restauración de destino especificada.

  3. Complete este paso solo si va a realizar una restauración de copia del sistema; de lo contrario, vaya al paso 4.

    Las restauraciones de copia del sistema son trabajos de restauración que restauran en una base de datos de destino diferente de la base de datos de origen que generó el punto de recuperación. Para las restauraciones de copia del sistema, observe el comando aws ssm-sap put-resource-permission que aparece en la consola. Este comando debe copiarse, pegarse y ejecutarse en la máquina que haya cumplido los requisitos previos. Al ejecutar el comando, utilice las credenciales del rol en el requisito previo en el que se configuran los permisos necesarios para registrar aplicaciones.

    // Example command
aws ssm-sap put-resource-permission \
--region us-east-1 \
--action-type RESTORE \
--source-resource-arn arn:aws:ssm-sap-east-1:112233445566:HANA/Foo/DB/HDB \
--resource-arn arn:aws:ssm-sap:us-east-1:112233445566:HANA/Bar/DB/HDB

  4. Una vez que elija la ubicación de restauración, podrá ver el ID de recurso de la base de datos de destino, el nombre de la aplicación, el tipo de base de datos y la EC2instancia.

  5. Si lo desea, puede ampliar la Configuración avanzada de restauración para cambiar la opción de restauración del catálogo. Las opciones disponibles varían en función de la configuración de restauración seleccionada.

  6. Haga clic en Restaurar copia de seguridad.

  7. La ubicación de destino se sobrescribirá durante la restauración (“restauración destructiva”), por lo que debe confirmar que lo permite en el siguiente cuadro de diálogo emergente.

    1. Para continuar, debe comprender que la base de datos existente se sobrescribirá con la que está restaurando.

    2. Una vez entendido esto, debe reconocer que los datos existentes se sobrescribirán. Para confirmarlo y continuar, escriba overwrite en el campo de entrada de texto.

  8. Haga clic en Restaurar copia de seguridad.

Si el procedimiento tiene éxito, aparecerá un banner azul en la parte superior de la consola. Esto significa que el trabajo de restauración está en curso. Se le redirigirá automáticamente a la página de trabajos, donde su trabajo de restauración aparecerá en la lista de trabajos de restauración. Este trabajo más reciente tendrá un estado Pending. Puede buscar el ID del trabajo de restauración y, a continuación, hacer clic en él para ver los detalles de cada trabajo de restauración. Para actualizar la lista de trabajos de restauración, haga clic en el botón de actualización para ver los cambios en el estado del trabajo de restauración.

StartRestoreJob API para SAP HANA en EC2

Esta acción recupera el recurso guardado identificado por un nombre de recurso de Amazon (ARN).

Sintaxis de la solicitud

PUT /restore-jobs HTTP/1.1
Content-type: application/json
{
   "IdempotencyToken": "string",
   "Metadata": { 
      "string" : "string" 
   },
   "RecoveryPointArn": "string",
   "ResourceType": "string"
}

Parámetros de solicitud de URI: la solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud: la solicitud admite los siguientes datos en formato JSON:

IdempotencyTokenUna cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a las que, de otro modo, serían idénticas. StartRestoreJob Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.

Tipo: cadena

Requerido: no

Metadatos

Un conjunto de pares clave-valor de metadatos. Contiene información, como el nombre del recurso, necesaria para restaurar un punto de recuperación. Para obtener los metadatos de configuración de un recurso en el momento en que se realizó la copia de seguridad, solo tiene que llamar a GetRecoveryPointRestoreMetadata. Sin embargo, es posible que para restaurar un recurso se necesiten valores adicionales a los proporcionados por el recurso GetRecoveryPointRestoreMetadata. Por ejemplo, puede que tenga que proporcionar un nombre de recurso nuevo si el original ya existe.

Debe incluir metadatos específicos para restaurar una EC2 instancia de SAP HANA en Amazon. Consulte StartRestoreJob los metadatos de los elementos específicos de SAP HANA.

Para recuperar los metadatos pertinentes, puede utilizar la llamada GetRecoveryPointRestoreMetadata.

Ejemplo de un punto de recuperación estándar de base de datos SAP HANA:

"RestoreMetadata": {
        "BackupSize": "1660948480", 
        "DatabaseName": "DATABASENAME",
        "DatabaseType": "SYSTEM",
        "HanaBackupEndTime": "1674838362",
        "HanaBackupId": "1234567890123",
        "HanaBackupPrefix": "1234567890123_SYSTEMDB_FULL",
        "HanaBackupStartTime": "1674838349",
        "HanaVersion": "2.00.040.00.1553674765",
        "IsCompressedBySap": "FALSE",
        "IsEncryptedBySap": "FALSE",
        "SourceDatabaseArn": "arn:aws:ssm-sap:region:accountID:HANA/applicationID/DB/DATABASENAME",
        "SystemDatabaseSid": "HDB",
        "aws:backup:request-id": "46bbtt4q-7unr-2897-m486-yn378k2mrw9c"
    }

Ejemplo de un punto de recuperación continuo de base de datos SAP HANA:

"RestoreMetadata": {
        "AvailableRestoreBases": "[1234567890123,9876543210987,1472583691472,7418529637418,1678942598761]",
        "BackupSize": "1711284224",
        "DatabaseName": "DATABASENAME",
        "DatabaseType": "TENANT",
        "EarliestRestorablePitrTimestamp": "1674764799789",
        "HanaBackupEndTime": "1668032687",
        "HanaBackupId": "1234567890123",
        "HanaBackupPrefix": "1234567890123_HDB_FULL",
        "HanaBackupStartTime": "1668032667",
        "HanaVersion": "2.00.040.00.1553674765",
        "IsCompressedBySap": "FALSE",
        "IsEncryptedBySap": "FALSE",
        "LatestRestorablePitrTimestamp": "1674850299789",
        "SourceDatabaseArn": "arn:aws:ssm-sap:region:accountID:HANA/applicationID/DB/SystemDatabaseSid",
        "SystemDatabaseSid": "HDB",
        "aws:backup:request-id": "46bbtt4q-7unr-2897-m486-yn378k2mrw9d"
    }

CLI para SAP HANA en EC2

El comando start-restore-job recupera el recurso guardado identificado con un nombre de recurso de Amazon (ARN). La CLI seguirá la directriz de API anterior.

Sinopsis:

start-restore-job
--recovery-point-arn value
--metadata value
--aws:backup:request-id value          
[--idempotency-token value]
[--resource-type value]
[--cli-input-json value]
[--generate-cli-skeleton value]
[--debug]
[--endpoint-url value]
[--no-verify-ssl]
[--no-paginate]
[--output value]
[--query value]
[--profile value]
[--region value]
[--version value]
[--color value]
[--no-sign-request]
[--ca-bundle value]
[--cli-read-timeout value]
[--cli-connect-timeout value]

Opciones

--recovery-point-arn (cadena) es una cadena en forma de número de recurso de Amazon (ARN) que identifica de forma exclusiva un punto de recuperación; por ejemplo arn:aws:backup:region:123456789012:recovery-point:46bbtt4q-7unr-2897-m486-yn378k2mrw9d.

--metadata (mapa): un conjunto de pares clave-valor de metadatos. Contiene información, como el nombre del recurso, necesaria para restaurar un punto de recuperación. Para obtener los metadatos de configuración de un recurso en el momento en que se realizó la copia de seguridad, solo tiene que llamar a GetRecoveryPointRestoreMetadata. Sin embargo, es posible que para restaurar un recurso se necesiten valores adicionales a los proporcionados por el recurso GetRecoveryPointRestoreMetadata. Debe especificar metadatos específicos para restaurar una EC2 instancia de SAP HANA en Amazon:

  • aws:backup:request-id: se trata de cualquier cadena de UUID utilizada para la idempotencia. No altera en modo alguno su experiencia de restauración.

  • aws:backup:TargetDatabaseArn: especifique la base de datos en la que desee restaurar. Este es el ARN de la EC2 base de datos de SAP HANA en Amazon.

  • CatalogRestoreOption: especifique dónde restaurar el catálogo. Uno de NO_CATALOG, LATEST_CATALOG_FROM_AWS_BACKUP, CATALOG_FROM_LOCAL_PATH.

  • LocalCatalogPath: Si el valor de CatalogRestoreOption los metadatos esCATALOG_FROM_LOCAL_PATH, especifique la ruta al catálogo local de la EC2 instancia. Debe ser una ruta de archivo válida en la EC2 instancia.

  • RecoveryType: actualmente se admiten los tipos de recuperación, FULL_DATA_BACKUP_RECOVERY, POINT_IN_TIME_RECOVERY y MOST_RECENT_TIME_RECOVERY.

clave = (cadena); valor = (cadena). Sintaxis abreviada:

KeyName1=string,KeyName2=string

Sintaxis de JSON:

{"string": "string"
  ...}

--idempotency-token es una cadena elegida por el usuario que puede utilizar para distinguir entre llamadas a StartRestoreJob que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.

--resource-typees una cadena que inicia un trabajo para restaurar un punto de recuperación para uno de los siguientes recursos: SAP HANA on Amazon EC2 para SAP HANA en Amazon EC2. Opcionalmente, los recursos de SAP HANA se pueden etiquetar mediante el comando aws ssm-sap tag-resource.

Resultado: RestoreJobId es una cadena que identifica de forma exclusiva el trabajo que restaura un punto de recuperación.

Restauración de alta disponibilidad (HA) de SAP HANA

Hay consideraciones importantes y pasos adicionales que se deben tener en cuenta al restaurar un sistema de alta disponibilidad (HA) de SAP HANA. Amplíe la sección que mejor se adapte a su caso de uso.

Escenario de restauración:

Antes de restaurar el sistema de HA de SAP HANA de destino,

  1. Si hay un clúster instalado, ponga todas las notas del clúster en modo Mantenimiento.

  2. Detenga la base de datos de SAP HANA en todos los nodos, incluidos el principal y el secundario.

  3. (Recomendado) Desactive cualquier plan de copia de seguridad para asegurarse de que no interfiera con la operación de restauración.

Una vez finalizado el trabajo de restauración, vaya al sistema de HA de SAP HANA restaurado y, a continuación:

  1. Inicie la base de datos de SAP HANA en el modo principal.

  2. Inicie manualmente cualquier base de datos de inquilinos en la que se haya restaurado la base de datos del sistema pero no se hayan restaurado sus inquilinos.

  3. Restablezca la replicación del sistema (HSR) de SAP HANA entre los nodos principal y secundario.

  4. Inicie la base de datos SAP HANA en el nodo secundario.

  5. Si hay un clúster instalado, asegúrese de que todos los nodos del clúster estén en línea.

  6. Habilite cualquier plan de copia de seguridad que haya desactivado antes de la operación de restauración.

(Opcional) Puede mantener la aplicación sincronizada en AWS Systems Manager for SAP llamando StartApplicationRefresh o puede esperar a la actualización programada de la aplicación que incluirá los metadatos de SAP más recientes.

Antes de comenzar un trabajo de restauración, vaya al sistema SAP HANA de nodo único de destino y, a continuación:

  1. Detenga la base de datos de SAP HANA en el sistema SAP HANA de destino.

  2. (Recomendado) Desactive cualquier plan de copia de seguridad para asegurarse de que no interfiera con la operación de restauración.

Una vez finalizado el trabajo de restauración, vaya al sistema de SAP HANA de nodo único de destino y, a continuación:

  1. Inicie SAP HANA en el sistema SAP HANA de destino.

  2. Inicie manualmente cada base de datos de inquilinos en el nodo de destino.

  3. Habilite cualquier plan de copia de seguridad que haya desactivado antes de la operación de restauración.

(Opcional) Puede mantener la aplicación sincronizada en AWS Systems Manager for SAP llamando StartApplicationRefresh o puede esperar a la actualización programada de la aplicación que incluirá los metadatos de SAP más recientes.

Antes de comenzar un trabajo de restauración, vaya al sistema SAP HANA de destino y, a continuación:

  1. (Opcional, pero recomendado) Coloque los clústeres instalados en modo de mantenimiento para evitar una toma de control inesperada durante la operación de restauración.

  2. Asegúrese de que la base de datos del sistema se ejecute en el sistema SAP HANA de destino.

  3. (Recomendado) Desactive cualquier plan de copia de seguridad para asegurarse de que no interfiera con la operación de restauración.

Una vez finalizado el trabajo de restauración:

  • Habilite cualquier plan de copia de seguridad que haya desactivado antes de la operación de restauración.

Solución de problemas

Si se produce alguno de los siguientes errores al intentar realizar una operación de copia de seguridad, consulte la resolución correspondiente.

  • Error: error en el registro de copias de seguridad continuas

    Para mantener los puntos de recuperación para las copias de seguridad continuas, SAP HANA crea registros de todos los cambios. Si los registros no están disponibles, el estado de cada uno de estos puntos de recuperación continua es STOPPED. El último punto de recuperación viable que se puede utilizar para restaurar es uno que tenga el estado AVAILABLE. Si faltan datos de registro durante el tiempo transcurrido entre los puntos de recuperación con un estado STOPPED y los puntos con un estado AVAILABLE, no se puede garantizar que la restauración se realice correctamente en esos momentos. Si introduce una fecha y una hora dentro de este intervalo, AWS Backup intentará realizar la copia de seguridad, pero utilizará la hora de restauración más cercana disponible. Este error se muestra en el mensaje “Encountered an issue with log backups. Please check SAP HANA for details."

    Solución: en la consola, se muestra la hora de restauración más reciente, con base en los registros. Puede introducir una hora más reciente que la que se muestra. Sin embargo, si los datos de este momento no están disponibles en los registros, AWS Backup utilizará la hora de restauración más reciente.

  • Error: Internal error

    Solución: crea un caso de soporte desde la consola o ponte en contacto Support con ellos con los detalles de la restauración, como el identificador del trabajo de restauración.

  • Error: The provided role arn:aws:iam::ACCOUNT_ID:role/ServiceLinkedRole cannot be assumed by AWS Backup

    Solución: asegúrese de que el rol asumido al realizar la restauración tenga los permisos necesarios para crear roles vinculados a servicios.

  • Error: User: arn:aws:sts::ACCOUNT_ID:assumed-role/ServiceLinkedRole/AWSBackup-ServiceLinkedRole is not authorized to perform: ssm-sap:GetOperation on resource: arn:aws:ssm-sap:us-east-1:ACCOUNT_ID:...

    Solución: asegúrese de introducir correctamente el rol que se asume al solicitar los permisos de restauración descritos en los requisitos previos.

  • Error: b* 449: recovery strategy could not be determined: [111014] The backup with backup id '1660627536506' cannot be used for recovery SQLSTATE: HY000\n

    Solución: asegúrese de que el agente Backint esté instalado correctamente. Compruebe todos los requisitos previos, especialmente el de instalar el AWS BackInt agente y el AWS Systems Manager de SAP en su servidor de aplicaciones SAP y, a continuación, vuelva a intentar instalar el BackInt agente.

  • Error: IllegalArgumentException: Restore job provided is not ready to return chunks, current restore job status is: CANCELLED

    Solución: el flujo de trabajo del servicio canceló el trabajo de restauración. Vuelva a intentar el trabajo de restauración.

  • Error: se produjo un problema al restaurar una base de datos de inquilinos en un sistema de alta disponibilidad de SAP HANA: b* -10709: Connection failed (RTE:[89006] System call 'connect' failed, rc=111:Connection refused ([::1]:40404 → localhost:30013))\n

    Solución: compruebe SAP HANA para asegurarse de que SYSTEMDB esté en funcionamiento.

  • Error: b'* 448: recovery could not be completed: [301102] exception 301153: Sending root key to secondary failed: connection refused. This may be caused by a stopped system replication secondary. Please keep the secondary online to receive the restored root key. Alternatively you could unregister the secondary site in case of an urgent recovery.\n SQLSTATE: HY000\n'

    Solución: en un sistema de alta disponibilidad de SAP HANA, es posible que SAP HANA no se ejecute en el nodo secundario mientras se esté ejecutando una operación de restauración activa. Inicie SAP HANA en el nodo secundario y, a continuación, vuelva a intentar el trabajo de restauración.

  • Error: RequestError: send request failed\ncaused by: read tcp 10.0.131.4:40482->35.84.99.47:443: read: connection timed out"

    Solución: se está produciendo una inestabilidad de red transitoria en la instancia. Vuelva a intentar la restauración. Si este problema se produce de forma constante, intente agregar ForceRetry: "true" al archivo de configuración del agente en /hana/shared/aws-backint-agent/aws-backint-agent-config.yaml.

Para cualquier otro problema relacionado con el agente AWS Backint, consulte Solución de problemas del AWS agente Backint para SAP HANA.