Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Restaurer une base de données SAP HANA sur une instance Amazon EC2
Les bases de données SAP HANA sur EC2 les instances peuvent être restaurées à l'aide de la AWS Backup console, de l'API ou de. AWS CLI
Rubriques
Restaurer une base de données SAP HANA avec la console AWS Backup
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 de restauration de base de données SAP HANA est en cours, les tentatives de sauvegarde de la même base de données peuvent entraîner le message d'erreur suivant : « Impossible de sauvegarder la base de données tant qu'elle est arrêtée ».
-
Accédez à la AWS Backup console à l'aide des informations d'identification fournies dans les prérequis.
-
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
Les restaurations de bases de données SAP HANA sont destructrices. La restauration d'une base de données remplacera la base de données à l'emplacement de restauration cible spécifié.
-
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-arnarn:aws:ssm-sap-east-1:112233445566:HANA/Foo/DB/HDB
\ --resource-arnarn:aws:ssm-sap:us-east-1:112233445566:HANA/Bar/DB/HDB
-
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.
-
Vous pouvez éventuellement étendre les paramètres de restauration avancés pour modifier l'option de restauration de votre catalogue. Les options disponibles varient en fonction des paramètres de restauration sélectionnés.
-
Cliquez sur Restaurer la sauvegarde.
-
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.
-
Pour continuer, vous devez comprendre que la base de données existante sera remplacée par celle que vous restaurez.
-
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.
-
-
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 API pour SAP HANA sur EC2
Cette action récupère la ressource enregistrée identifiée par un Amazon Resource Name (ARN).
Syntaxe de la demande
PUT /restore-jobs HTTP/1.1 Content-type: application/json { "IdempotencyToken": "string", "Metadata": { "string" : "string" }, "RecoveryPointArn": "string", "ResourceType": "string" }
Paramètres de demande URI : la demande n'utilise pas de paramètres URI.
Corps de la requête : la demande accepte les données suivantes au format JSON :
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. Consultez les StartRestoreJob métadonnées des éléments spécifiques à SAP HANA.
Pour récupérer les métadonnées pertinentes, vous pouvez utiliser l'appel GetRecoveryPointRestoreMetadata
.
Exemple de point de récupération de base de données SAP HANA 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 récupération d'une base de données SAP HANA en continu :
"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 pour SAP HANA sur EC2
La commande start-restore-job
récupère la ressource enregistrée identifiée par un Amazon Resource Name (ARN). L'interface de ligne de commande suivra les directives de l'API ci-dessus.
Résumé :
start-restore-job --recovery-point-arn
value
--metadatavalue
--aws:backup:request-idvalue
[--idempotency-tokenvalue
] [--resource-typevalue
] [--cli-input-jsonvalue
] [--generate-cli-skeletonvalue
] [--debug] [--endpoint-urlvalue
] [--no-verify-ssl] [--no-paginate] [--outputvalue
] [--queryvalue
] [--profilevalue
] [--regionvalue
] [--versionvalue
] [--colorvalue
] [--no-sign-request] [--ca-bundlevalue
] [--cli-read-timeoutvalue
] [--cli-connect-timeoutvalue
]
Options
--recovery-point-arn
(chaîne) 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 chaîne UUID utilisée pour l'idempotence. 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 l'ARN de la base de EC2 données SAP HANA sur Amazon. -
CatalogRestoreOption
: spécifiez d'où vous souhaitez restaurer votre catalogue. Il doit s'agir deNO_CATALOG
,LATEST_CATALOG_FROM_AWS_BACKUP
ouCATALOG_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érationFULL_DATA_BACKUP_RECOVERY
,POINT_IN_TIME_RECOVERY
etMOST_RECENT_TIME_RECOVERY
sont pris en charge.
clé = (chaîne) ; valeur = (chaîne). Syntaxe raccourcie :
KeyName1=string,KeyName2=string
Syntaxe JSON :
{"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-type
est une chaîne qui lance une tâche de restauration d'un point de restauration pour l'une des ressources suivantes : SAP HANA on Amazon EC2
pour SAP HANA sur Amazon EC2. Facultatif Les ressources SAP HANA peuvent être balisé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.
Restauration de la haute disponibilité (HA) de SAP HANA
Des considérations importantes et des étapes supplémentaires doivent être prises en compte lors de la restauration d'un système de haute disponibilité (HA) de SAP HANA. Développez la section ci-dessous qui correspond le mieux à votre cas d'utilisation.
Scénario de restauration :
Avant de procéder à la restauration sur le système SAP HANA HA cible (de destination),
-
Si un cluster est installé, mettez toutes les notes du cluster en mode Maintenance.
-
Arrêtez la base de données SAP HANA sur tous les nœuds, y compris le nœud principal et le nœud secondaire.
-
(Recommandé) Désactivez tous les plans de sauvegarde pour vous assurer qu'ils n'interfèrent pas avec l'opération de restauration.
Une fois le travail de restauration terminé, accédez au système SAP HANA HA restauré, puis :
-
Démarrez la base de données SAP HANA en mode principal.
-
Démarrez manuellement toute base de données mutualisée dans laquelle la base de données système a été restaurée mais dont les locataires n'ont pas été restaurés.
-
Rétablissez la réplication du système SAP HANA (HSR) entre les nœuds principal et secondaire.
-
Démarrez la base de données SAP HANA sur le nœud secondaire.
-
Si un cluster est installé, assurez-vous que tous les nœuds du cluster sont en ligne.
-
Activez tous les plans de sauvegarde que vous avez désactivés avant l'opération de restauration.
(Facultatif) Vous pouvez synchroniser l'application sur AWS
Systems Manager for SAP en appelant StartApplicationRefresh
, ou vous pouvez attendre l'actualisation planifiée de l'application qui fournira les dernières métadonnées SAP.
Avant de commencer une tâche de restauration, accédez au système SAP HANA à nœud unique cible, puis :
Arrêtez la base de données SAP HANA sur le système SAP HANA cible.
(Recommandé) Désactivez tous les plans de sauvegarde pour vous assurer qu'ils n'interfèrent pas avec l'opération de restauration.
Une fois la tâche de restauration terminée, accédez au système SAP HANA à nœud unique cible, puis :
Démarrez SAP HANA sur le système SAP HANA cible.
Démarrez manuellement chaque base de données mutualisée sur le nœud cible.
Activez tous les plans de sauvegarde que vous avez désactivés avant l'opération de restauration.
(Facultatif) Vous pouvez synchroniser l'application sur AWS
Systems Manager for SAP en appelant StartApplicationRefresh
, ou vous pouvez attendre l'actualisation planifiée de l'application qui fournira les dernières métadonnées SAP.
Avant de démarrer une tâche de restauration, accédez au système SAP HANA cible, puis :
(Facultatif, mais recommandé) Mettez tous les clusters installés en mode maintenance pour éviter une prise de contrôle inattendue lors de l'opération de restauration.
Assurez-vous que la base de données du système fonctionne sur le système SAP HANA cible.
(Recommandé) Désactivez tous les plans de sauvegarde pour vous assurer qu'ils n'interfèrent pas avec l'opération de restauration.
Une fois le travail de restauration terminé :
Activez tous les plans de sauvegarde que vous avez désactivés avant l'opération de restauration.
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
Afin de conserver les points de récupération pour les sauvegardes continues, des journaux sont créés par 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 estAVAILABLE
. Si les données du journal sont manquantes pour la période entre les points de récupération dotés d'un statutSTOPPED
et les points dotés d'un statutAVAILABLE
, 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 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 BackupRé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 tous les prérequis, en particulier Installer AWS BackInt l'agent et AWS Systems Manager pour SAP sur votre serveur d'applications SAP, 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 : problème rencontré lors de la restauration d'une base de données client sur un système SAP HANA High Availability :
b* -10709: Connection failed (RTE:[89006] System call 'connect' failed, rc=111:Connection refused ([::1]:40404 → localhost:30013))\n
Solution : Vérifiez SAP HANA pour vous assurer que le SYSTEMDB est opérationnel.
-
Erreur :
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'
Solution : Sur un système SAP HANA High Availability, il est possible que SAP HANA ne soit pas exécuté sur le nœud secondaire pendant qu'une opération de restauration active est en cours d'exécution. Démarrez SAP HANA sur le nœud secondaire, puis 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.