Restaurer une SAP HANA base de données sur une EC2 instance Amazon

SAPHANAles bases de données EC2 des instances peuvent être restaurées à l'aide de la AWS Backup consoleAPI, en utilisant ou en utilisant AWS CLI.

Restaurez une base de données d'EC2instance SAP HANA sur Amazon à l'aide de la AWS Backup console

Notez que les tâches de sauvegarde et de restauration impliquant la même base de données ne peuvent pas être exécutées simultanément. Lorsqu'une tâche SAP HANA de restauration de base de données est en cours, les tentatives de sauvegarde de la même base de données peuvent générer une erreur : « Impossible de sauvegarder la base de données tant qu'elle est arrêtée ».

1. Accédez à la AWS Backup console à l'aide des informations d'identification fournies dans les prérequis.

2. Dans le menu déroulant Emplacement de restauration cible, choisissez une base de données à remplacer par le point de récupération que vous utilisez pour la restauration (notez que l'instance hébergeant la base de données cible de restauration doit également disposer des autorisations des conditions préalables).

   Important

   SAPHANAles restaurations de bases de données sont destructrices. La restauration d'une base de données remplacera la base de données à l'emplacement de restauration cible spécifié.

3. Suivez cette étape uniquement si vous effectuez une restauration de copie du système ; sinon, passez à l'étape 4.

   Les restaurations de copies du système sont des tâches de restauration qui restaurent vers une base de données cible différente de la base de données source qui a généré le point de récupération. Pour les restaurations de copies du système, notez la commande aws ssm-sap put-resource-permission qui vous est fournie sur la console. Cette commande doit être copiée, collée et exécutée sur la machine qui a rempli les conditions préalables. Lorsque vous exécutez la commande, utilisez les informations d'identification du rôle dans les conditions préalables où vous configurez les autorisations requises pour l'enregistrement des applications.

   // 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. Une fois que vous avez choisi l'emplacement de restauration, vous pouvez voir l'ID de ressource de la base de données cible, le nom de l'application, le type de base de données et l'EC2instance.

5. Facultatif Vous pouvez ouvrir les Paramètres de restauration avancés pour modifier l'option de restauration de votre catalogue. La sélection par défaut consiste à restaurer le dernier catalogue à partir d' AWS Backup.

6. Cliquez sur Restaurer la sauvegarde.

7. L'emplacement cible sera remplacé lors de la restauration (« restauration destructive »). Vous devez donc confirmer que vous l'autorisez dans la boîte de dialogue contextuelle suivante.

   1. Pour continuer, vous devez comprendre que la base de données existante sera remplacée par celle que vous restaurez.

   2. Une fois que cela est compris, vous devez reconnaître que les données existantes seront remplacées. Pour confirmer cela et continuer, tapez remplacer dans le champ de saisie de texte.

8. Cliquez sur Restaurer la sauvegarde.

Si la procédure est réussie, une bannière bleue s'affiche en haut de la console. Cela signifie que la tâche de restauration est en cours. Vous serez automatiquement redirigé vers la page Tâches où votre tâche de restauration apparaîtra dans la liste des tâches de restauration. Cette tâche la plus récente aura le statut Pending. Vous pouvez rechercher, puis cliquer sur l'ID de la tâche de restauration pour voir les détails de chaque tâche de restauration. Vous pouvez actualiser la liste des tâches de restauration en cliquant sur le bouton d'actualisation pour afficher les modifications apportées au statut des tâches de restauration.

StartRestoreJob APIpour SAP HANA un EC2

Cette action permet de récupérer la ressource enregistrée identifiée par un nom de ressource Amazon (ARN).

Syntaxe de la demande

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

URIParamètres de demande : La demande n'utilise aucun URI paramètre.

Corps de la demande : La demande accepte les données suivantes dans le JSON format suivant :

IdempotencyTokenChaîne choisie par le client que vous pouvez utiliser pour faire la distinction entre des appels par ailleurs identiques. StartRestoreJob Toute nouvelle tentative d'une demande réussie avec le même jeton d'idempotence entraîne un message de réussite sans qu'aucune action ne soit entreprise.

Type : chaîne

Obligatoire : non

Metadonnées

Un ensemble de paires clé-valeur de métadonnées. Contient des informations, telles que le nom de la ressource, nécessaires pour restaurer un point de récupération. Vous pouvez obtenir les métadonnées de configuration relatives à une ressource au moment de sa sauvegarde en appelant GetRecoveryPointRestoreMetadata. Cependant, des valeurs autres que celles fournies par GetRecoveryPointRestoreMetadata peuvent être nécessaires pour restaurer une ressource. Par exemple, vous devrez peut-être fournir un nouveau nom de ressource si l'original existe déjà.

Vous devez inclure des métadonnées spécifiques pour restaurer une EC2 instance SAP HANA sur Amazon. Voir StartRestoreJob les métadonnées pour les éléments SAP HANA spécifiques.

Pour récupérer les métadonnées pertinentes, vous pouvez utiliser l'appel GetRecoveryPointRestoreMetadata.

Exemple de point de restauration SAP HANA de base de données standard :

"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"
    }

Exemple de point de restauration continue d'une SAP HANA base de données :

"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"
    }

CLIpour SAP HANA un EC2

La commande start-restore-job récupère la ressource enregistrée identifiée par un Amazon Resource Name (ARN). CLIsuivra les API directives ci-dessus.

Résumé :

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]

Options

--recovery-point-arn(string) est une chaîne sous la forme d'un Amazon Resource Number (ARN) qui identifie de manière unique un point de récupération ; par exemple arn:aws:backup:region:123456789012:recovery-point:46bbtt4q-7unr-2897-m486-yn378k2mrw9d

--metadata (map) : un ensemble de paires clé-valeur de métadonnées. Contient des informations, telles que le nom de la ressource, nécessaires pour restaurer un point de récupération. Vous pouvez obtenir les métadonnées de configuration relatives à une ressource au moment de sa sauvegarde en appelant GetRecoveryPointRestoreMetadata. Cependant, des valeurs autres que celles fournies par GetRecoveryPointRestoreMetadata peuvent être nécessaires pour restaurer une ressource. Vous devez spécifier des métadonnées spécifiques pour restaurer une EC2 instance SAP HANA sur Amazon :

• aws:backup:request-id: Il s'agit de n'importe quelle UUID chaîne utilisée pour l'idempuissance. Cela ne modifie en rien votre expérience de restauration.

• aws:backup:TargetDatabaseArn : spécifiez la base de données dans laquelle vous souhaitez effectuer la restauration. Il s'agit de la base de EC2 données SAP HANA sur AmazonARN.

• CatalogRestoreOption : spécifiez d'où vous souhaitez restaurer votre catalogue. Il doit s'agir de NO_CATALOG, LATEST_CATALOG_FROM_AWS_BACKUP ou CATALOG_FROM_LOCAL_PATH.

• LocalCatalogPath: Si la valeur CatalogRestoreOption des métadonnées estCATALOG_FROM_LOCAL_PATH, spécifiez le chemin d'accès au catalogue local sur votre EC2 instance. Il doit s'agir d'un chemin de fichier valide dans votre EC2 instance.

• RecoveryType : actuellement, les types de récupération FULL_DATA_BACKUP_RECOVERY, POINT_IN_TIME_RECOVERY et MOST_RECENT_TIME_RECOVERY sont pris en charge.

clé = (chaîne) ; valeur = (chaîne). Syntaxe raccourcie :

KeyName1=string,KeyName2=string

JSONsyntaxe :

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

--idempotency-token est une chaîne choisie par l'utilisateur que vous pouvez utiliser pour faire la distinction entre des appels par ailleurs identiques à StartRestoreJob. Toute nouvelle tentative d'une demande réussie avec le même jeton d'idempotence entraîne un message de réussite sans qu'aucune action ne soit entreprise.

--resource-typeest une chaîne qui lance une tâche visant à restaurer un point de récupération pour l'une des ressources suivantes : SAP HANA on Amazon EC2 pour SAP HANA sur AmazonEC2. Les SAP HANA ressources peuvent éventuellement être étiquetées à l'aide de la commande aws ssm-sap tag-resource

Sortie : RestoreJobId est une chaîne identifiant de manière unique la tâche qui restaure un point de récupération.

Résolution des problèmes

Si l'une des erreurs suivantes se produit lors d'une tentative de sauvegarde, consultez la résolution associée.

• Erreur : erreur du journal de sauvegarde continue

  Pour conserver les points de restauration pour les sauvegardes continues, des journaux sont créés SAP HANA pour toutes les modifications. Lorsque les journaux ne sont pas disponibles, le statut de chacun de ces points de récupération continue est STOPPED. Le dernier point de récupération viable pouvant être utilisé pour la restauration est celui dont le statut est AVAILABLE. Si les données du journal sont manquantes pour la période entre les points de récupération dotés d'un statut STOPPED et les points dotés d'un statut AVAILABLE, il n'est pas possible de garantir la réussite de la restauration. Si vous entrez une date et une heure comprises dans cette plage, il AWS Backup tentera de faire la sauvegarde, mais utilisera l'heure de restauration disponible la plus proche. Cette erreur sera affichée par le message “Encountered an issue with log backups. Please check SAP HANA for details."

  Résolution : dans la console, l'heure de restauration la plus récente, basée sur les journaux, est affichée. Vous pouvez saisir une heure plus récente que l'heure indiquée. Toutefois, si les données relatives à cette période ne sont pas disponibles dans les journaux, AWS Backup nous utiliserons la date de restauration la plus récente.

• Erreur : Internal error

  Solution : créez un dossier d'assistance depuis votre console ou contactez votre interlocuteur en AWS Support fournissant les détails de votre restauration, tels que l'identifiant de la tâche de restauration.

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

  Résolution : assurez-vous que le rôle assumé lors de l'appel de restauration dispose des autorisations requises pour créer des rôles liés au service.

• Erreur : 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:...

  Résolution : assurez-vous que le rôle assumé lors de l'appel des autorisations de restauration décrites dans les conditions préalables est correctement entré.

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

  Résolution : assurez-vous que l'agent Backint a été correctement installé. Vérifiez toutes les conditions requises, en particulier Installer AWS BackInt l'agent et AWS Systems Manager pour SAP sur votre serveur SAP d'applications, puis réessayez d'installer l' BackInt agent.

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

  Résolution : la tâche de restauration a été annulée par le flux de travail du service. Réessayez la tâche de restauration.

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

  Résolution : une instabilité transitoire du réseau se produit sur l'instance. Réessayez la restauration. Si ce problème se produit régulièrement, essayez d'ajouter ForceRetry: "true" au fichier de configuration de l'agent à l'adresse /hana/shared/aws-backint-agent/aws-backint-agent-config.yaml.

Pour tout autre problème lié à l'agent AWS Backint, reportez-vous à la section Résoudre les problèmes liés à AWS l'agent Backint pour. SAP HANA