Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Ripristino di database SAP HANA su un'istanza Amazon EC2
I database SAP HANA su istanze EC2 possono essere ripristinati utilizzando la AWS Backup console, utilizzando l'API o utilizzando. AWS CLI
**Topics**
+ [Ripristina un database SAP HANA con la console AWS Backup](#w2aac17c31c43b9)
+ [[StartRestoreJob API](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) per SAP HANA su EC2](#w2aac17c31c43c11)
+ [CLI per SAP HANA su EC2](#w2aac17c31c43c13)
+ [Ripristino di SAP HANA High Availability (HA)](#saphanarestoreha)
+ [Risoluzione dei problemi](#saphanarestoretroubleshooting)
## Ripristina un database SAP HANA con la console AWS Backup
Tieni presente che i processi di backup e ripristino che coinvolgono lo stesso database non possono essere eseguiti contemporaneamente. Quando si verifica un processo di ripristino del database SAP HANA, i tentativi di eseguire il backup dello stesso database generano un errore: "Database cannot be backed up while it is stopped".
1. Accedi alla AWS Backup console utilizzando le credenziali dei prerequisiti.
1. Nel menu a discesa **Posizione di ripristino di destinazione**, scegli un database da sovrascrivere con il punto di ripristino utilizzato per il ripristino (tieni presente che l'istanza che ospita il database di destinazione di ripristino deve anche disporre delle autorizzazioni previste dai prerequisiti).
**Importante**
I ripristini del database SAP HANA sono distruttivi. Il ripristino di un database sovrascriverà il database nella posizione di ripristino di destinazione specificata.
1. Completa questo passaggio solo se stai eseguendo un ripristino della copia del sistema; in caso contrario, vai al passaggio 4.
I ripristini delle copie del sistema sono processi di ripristino che eseguono il ripristino in un database di destinazione diverso dal database di origine che ha generato il punto di ripristino. Per i ripristini delle copie del sistema, nota il comando `aws ssm-sap put-resource-permission` fornito sulla console. Questo comando deve essere copiato, incollato ed eseguito sul computer che ha completato i prerequisiti. Durante l'esecuzione del comando, utilizza le credenziali del ruolo nel prerequisito in cui imposti le autorizzazioni richieste per la registrazione delle applicazioni.
```
// 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
```
1. Dopo aver scelto la posizione di ripristino, puoi visualizzare **ID risorsa**, **Nome applicazione**, **Tipo di database** e **Istanza EC2** del database di destinazione.
1. *Facoltativamente*, puoi espandere **le impostazioni di ripristino avanzate** per modificare l'opzione di ripristino del catalogo. Le opzioni disponibili variano in base alle impostazioni di ripristino selezionate.
1. Fai clic su **Ripristina backup**.
1. La posizione di destinazione verrà sovrascritta durante il ripristino (**"ripristino distruttivo"**), quindi è necessario confermare l'autorizzazione nella successiva finestra di dialogo pop-up.
1. Per procedere, è necessario comprendere che il database esistente verrà sovrascritto da quello che si sta ripristinando.
1. Dopodiché, è necessario confermare che i dati esistenti verranno sovrascritti. Per confermare e procedere, digita **overwrite** nel campo di immissione di testo.
1. Fai clic su **Ripristina backup**.
Se la procedura è andata a buon fine, nella parte superiore della console verrà visualizzato un banner blu. Ciò significa che il processo di ripristino è in corso. Verrà eseguito il reindirizzamento automatico alla pagina Processi e il processo di ripristino verrà visualizzato nell'elenco dei processi di ripristino. Lo stato del processo più recente sarà `Pending`. Puoi cercare e quindi fare clic sull'ID del processo di ripristino per visualizzare i dettagli di ciascun processo di ripristino. Puoi aggiornare l'elenco dei processi di ripristino facendo clic sul pulsante di aggiornamento per visualizzare le modifiche apportate allo stato del processo di ripristino.
## [StartRestoreJob API](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) per SAP HANA su EC2
Questa azione recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN).
**Sintassi della richiesta**
```
PUT /restore-jobs HTTP/1.1
Content-type: application/json
{
"[IdempotencyToken](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-IdempotencyToken)": "string",
"[Metadata](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-Metadata)": {
"string" : "string"
},
"[RecoveryPointArn](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-RecoveryPointArn)": "string",
"[ResourceType](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-ResourceType)": "string"
}
```
**Parametri della richiesta URI**: la richiesta non utilizza parametri URI.
**Corpo della richiesta**: la richiesta accetta i seguenti dati in formato JSON:
**IdempotencyToken**Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a. `StartRestoreJob` Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
▬Tipo: stringa
Obbligatorio: no
**Metadati**
Un set di coppie chiave-valore di metadati. Contiene informazioni, come il nome di una risorsa, necessarie per ripristinare un punto di ripristino. Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando `GetRecoveryPointRestoreMetadata`. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da `GetRecoveryPointRestoreMetadata`. Ad esempio, potrebbe essere necessario fornire un nuovo nome di risorsa se l'originale esiste già.
È necessario includere metadati specifici per ripristinare un'istanza SAP HANA su Amazon EC2. Visualizza i [ StartRestoreJob metadati](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#API_StartRestoreJob_RequestBody) per gli elementi specifici di SAP HANA.
Per recuperare i metadati pertinenti, puoi utilizzare la chiamata [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_GetRecoveryPointRestoreMetadata.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_GetRecoveryPointRestoreMetadata.html).
Esempio di un punto di ripristino standard del database 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"
}
```
Esempio di un punto di ripristino continuo del database 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 per SAP HANA su EC2
Il comando `start-restore-job` recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN). La CLI seguirà le linee guida API di cui sopra.
**Riepilogo:**
```
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]
```
**Opzioni**
`--recovery-point-arn` (stringa) è una stringa sotto forma di un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:region:123456789012:recovery-point:46bbtt4q-7unr-2897-m486-yn378k2mrw9d`
`--metadata` (mappa): un set di coppie chiave-valore di metadati. Contiene informazioni, come il nome di una risorsa, necessarie per ripristinare un punto di ripristino. Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando `GetRecoveryPointRestoreMetadata`. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da `GetRecoveryPointRestoreMetadata`. È necessario specificare metadati per ripristinare un'istanza SAP HANA su Amazon EC2:
+ `aws:backup:request-id`: questa è una qualsiasi stringa UUID utilizzata per idempotenza. Non altera in alcun modo l'esperienza di ripristino.
+ `aws:backup:TargetDatabaseArn`: specifica il database in cui eseguire il ripristino. Questo è l'ARN del database SAP HANA su Amazon EC2.
+ `CatalogRestoreOption`: specifica da dove ripristinare il catalogo. Uno di `NO_CATALOG`, `LATEST_CATALOG_FROM_AWS_BACKUP`, `CATALOG_FROM_LOCAL_PATH`
+ `LocalCatalogPath`: Se il valore CatalogRestoreOption dei metadati è`CATALOG_FROM_LOCAL_PATH`, specifica il percorso del catalogo locale sull'istanza EC2. Questo deve essere un percorso di file valido nell'istanza EC2.
+ `RecoveryType`: attualmente sono supportati i tipi di ripristino `FULL_DATA_BACKUP_RECOVERY`, `POINT_IN_TIME_RECOVERY` e `MOST_RECENT_TIME_RECOVERY`.
key = (stringa); value = (stringa). Sintassi abbreviata:
```
KeyName1=string,KeyName2=string
```
Sintassi JSON:
```
{"string": "string"
...}
```
`--idempotency-token` è una stringa scelta dal cliente che puoi utilizzare per distinguere tra chiamate a `StartRestoreJob` altrimenti identiche. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.
`--resource-type` è una stringa che avvia un processo per ripristinare un punto di ripristino per una delle seguenti risorse: `SAP HANA on Amazon EC2` per SAP HANA su Amazon EC2. *Facoltativamente*, le risorse SAP HANA possono essere contrassegnate utilizzando il comando `aws ssm-sap tag-resource`
**Output**: `RestoreJobId` è una stringa che identifica in modo univoco il processo che ripristina un punto di ripristino.
## Ripristino di SAP HANA High Availability (HA)
Ci sono considerazioni importanti e passaggi aggiuntivi da includere quando si ripristina un sistema ad alta disponibilità (HA) di SAP HANA. Espandi la sezione seguente che meglio si adatta al tuo caso d'uso.
Scenario di ripristino:
### Database di sistema su un target SAP HANA HA
Prima di eseguire il ripristino sul sistema SAP HANA HA di destinazione (destinazione),
1. Se è installato un cluster, metti tutte le note del cluster in modalità Manutenzione.
1. Arresta il database SAP HANA su tutti i nodi, compresi quelli primari e secondari.
1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.
Al termine del processo di ripristino, accedi al sistema SAP HANA HA ripristinato, quindi:
1. Avvia il database SAP HANA nella modalità principale.
1. Avvia manualmente qualsiasi database tenant in cui il database di sistema è stato ripristinato ma i relativi tenant non sono stati ripristinati.
1. Ristabilisci la replica del sistema SAP HANA (HSR) tra i nodi primario e secondario.
1. Avvia il database SAP HANA sul nodo secondario.
1. Se è installato un cluster, assicurati che tutti i nodi del cluster siano online.
1. Abilita tutti i piani di backup che hai disabilitato prima dell'operazione di ripristino.
*(Facoltativo)* È possibile mantenere l'applicazione sincronizzata su [AWS Systems Manager for SAP [https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html](https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html)](https://docs.aws.amazon.com/ssm-sap/latest/userguide/what-is-ssm-for-sap.html)chiamando oppure è possibile attendere l'aggiornamento pianificato dell'applicazione che porterà i metadati SAP più recenti.
### Database di sistema su una destinazione SAP HANA a nodo singolo
Prima di iniziare un processo di ripristino, vai al sistema SAP HANA a nodo singolo di destinazione, quindi:
1. Arresta il database SAP HANA sul sistema SAP HANA di destinazione.
1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.
Al termine del processo di ripristino, vai al sistema SAP HANA a nodo singolo di destinazione, quindi:
1. Avvia SAP HANA sul sistema SAP HANA di destinazione.
1. Avvia manualmente ogni database tenant sul nodo di destinazione.
1. Abilita tutti i piani di backup disabilitati prima dell'operazione di ripristino.
*(Facoltativo)* È possibile mantenere l'applicazione sincronizzata su [AWS Systems Manager for SAP [https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html](https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html)](https://docs.aws.amazon.com/ssm-sap/latest/userguide/what-is-ssm-for-sap.html)chiamando oppure è possibile attendere l'aggiornamento pianificato dell'applicazione che porterà i metadati SAP più recenti.
### Database dei tenant (esistente o copia di sistema)
Prima di iniziare un processo di ripristino, vai al sistema SAP HANA di destinazione, quindi:
1. *(Facoltativo, ma consigliato)* Metti tutti i cluster installati in modalità di manutenzione per evitare un'acquisizione imprevista durante l'operazione di ripristino.
1. Assicurati che il database di sistema sia in esecuzione sul sistema SAP HANA di destinazione.
1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.
Al termine del processo di ripristino:
+ Abilita tutti i piani di backup disabilitati prima dell'operazione di ripristino.
## Risoluzione dei problemi
Se durante il tentativo di eseguire un'operazione di backup si verifica uno dei seguenti errori, consulta la risoluzione associata.
+ **Errore: errore** nel registro di backup continuo
Per mantenere i punti di ripristino per i backup continui, i log vengono creati da SAP HANA per tutte le modifiche. Quando i log non sono disponibili, lo stato di ciascuno di questi punti di ripristino continui è `STOPPED`. L'ultimo punto di ripristino valido che può essere utilizzato per il ripristino è quello con lo stato `AVAILABLE`. Se i dati di log mancano per il tempo tra i punti di ripristino con uno stato `STOPPED` e i punti con uno stato `AVAILABLE`, non è possibile garantire che il ripristino abbia esito positivo in questi orari. Se inserisci una data e un'ora comprese in questo intervallo, AWS Backup tenterà di eseguire il backup, ma utilizzerà l'ora ripristinabile più vicina disponibile. Questo errore verrà visualizzato dal messaggio `“Encountered an issue with log backups. Please check SAP HANA for details."`
**Risoluzione:** nella console, viene visualizzata l'ora ripristinabile più recente, in base ai log. Puoi inserire un'ora più recente di quella visualizzata. Tuttavia, se i dati relativi a questo periodo non sono disponibili nei registri, AWS Backup utilizzerà l'ora di ripristino più recente.
+ **Errore:** `Internal error`
**Soluzione:** crea una richiesta di supporto dalla tua console o contatta Supporto i dettagli del ripristino, ad esempio l'ID del processo di ripristino.
+ **Errore:** `The provided role arn:aws:iam::ACCOUNT_ID:role/ServiceLinkedRole cannot be assumed by AWS Backup`
**Risoluzione:** assicurati che il ruolo assunto durante la chiamata al ripristino disponga delle autorizzazioni necessarie per creare ruoli collegati al servizio.
+ **Errore:** `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:...`
**Risoluzione:** assicurati che il ruolo assunto durante la chiamata alle autorizzazioni di ripristino descritte nei prerequisiti sia inserito correttamente.
+ **Errore:** `b* 449: recovery strategy could not be determined: [111014] The backup with backup id '1660627536506' cannot be used for recovery SQLSTATE: HY000\n`
**Risoluzione:** assicurati che l'agente Backint sia stato installato correttamente. Verifica tutti i prerequisiti, in particolare [Install AWS BackInt Agent and AWS Systems Manager for SAP](https://docs.aws.amazon.com/sap/latest/sap-hana/aws-backint-agent-installing-configuring.html) sul tuo server delle applicazioni SAP, quindi riprova a installare l'agente. BackInt
+ **Errore:** `IllegalArgumentException: Restore job provided is not ready to return chunks, current restore job status is: CANCELLED`
**Risoluzione:** il processo di ripristino è stato annullato dal flusso di lavoro del servizio. Riprova il processo di ripristino.
+ **Errore:** è stato riscontrato un problema durante il ripristino di un database tenant su un sistema SAP HANA High Availability: `b* -10709: Connection failed (RTE:[89006] System call 'connect' failed, rc=111:Connection refused ([::1]:40404 → localhost:30013))\n`
**Risoluzione:** controlla SAP HANA per assicurarti che SYSTEMDB sia attivo e funzionante.
+ **Errore:** `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'`
**Risoluzione:** su un sistema SAP HANA High Availability, SAP HANA potrebbe non essere in esecuzione sul nodo secondario mentre è in esecuzione un'operazione di ripristino attiva. Avvia SAP HANA sul nodo secondario, quindi riprova il processo di ripristino.
+ **Errore:** `RequestError: send request failed\ncaused by: read tcp 10.0.131.4:40482->35.84.99.47:443: read: connection timed out"`
**Risoluzione:** instabilità di rete temporanea si verifica sull'istanza. Riprova a eseguire il ripristino. Se questo problema si verifica costantemente, prova ad aggiungere `ForceRetry: "true"` al file di configurazione dell'agente in `/hana/shared/aws-backint-agent/aws-backint-agent-config.yaml.`
Per qualsiasi altro problema relativo all'agente AWS Backint, consulta [Risoluzione dei problemi di Backint AWS Agent](https://docs.aws.amazon.com/sap/latest/sap-hana/aws-backint-agent-troubleshooting.html) per SAP HANA.