Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare il backup e il recupero basati su Backint per SAP HANA

Questa guida mostra come configurare l'agente di Google Cloud per SAP per eseguire il backup e il recupero basati su Backint per SAP HANA.

Per informazioni concettuali su questa funzionalità, che possono aiutarti a pianificare l'implementazione, consulta Backup e recupero per SAP HANA mediante Backint.

Per informazioni su come creare backup basati su Backint e recuperare SAP HANA utilizzandoli, consulta Eseguire il backup e il recupero di SAP HANA utilizzando Backint.

Prima di iniziare

Convalida l'installazione della versione 3.6 (la più recente) dell'agente di Google Cloud per SAP. Per le istruzioni, consulta la guida all'installazione per il tuo scenario.
Se hai installato l'agente su un server Bare Metal Solution, assicurati di aver completato i prerequisiti richiesti e di aver configurato un account di servizio. Per le istruzioni, consulta Configurare l'agente di Google Cloud per SAP su Linux.
Se il database SAP HANA è in esecuzione in un ambiente on-premise, assicurati di configurare un account di servizio e la relativa chiave. Per informazioni su come eseguire questa operazione, consulta Configurare l'agente di Google Cloud per SAP su Linux.
Se devi attivare questa funzionalità per un'istanza dell'agente di Google Cloud per SAP in esecuzione su un host diverso da un'istanza Compute Engine o da un server Bare Metal Solution, devi creare un incidente con l'assistenza SAP nel componenteBC-OP-LNX-GOOGLE in modo che sia SAP sia Google Cloud possano valutare la tua configurazione.
Installa SAP HANA:
- Per informazioni sull'automazione dell'installazione di SAP HANA su Google Cloud utilizzando Terraform, consulta la guida al deployment per il tuo scenario.
- Per informazioni sull'installazione di SAP HANA su Bare Metal Solution, consulta la guida alla pianificazione di SAP HANA su Bare Metal Solution.

Crea un bucket Cloud Storage

Prima di attivare la funzionalità Backint dell'Agente per SAP di Google Cloud, assicurati che esista un bucket Cloud Storage per archiviare i backup. Se hai un bucket Cloud Storage, puoi saltare questa sezione.

Per informazioni sull'archiviazione dei backup nei bucket Cloud Storage, consulta Archiviazione dei backup nei bucket Cloud Storage.

Per creare un bucket Cloud Storage:

Console Google Cloud

In the Google Cloud console, go to the Cloud Storage Buckets page.
Go to Buckets page
Click Create bucket.
On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
- For Name your bucket, enter a name that meets the bucket naming requirements.
- For Choose where to store your data, do the following:
  - Select a Location type option.
  - Select a Location option.
- For Choose a default storage class for your data, select a storage class.
- For Choose how to control access to objects, select an Access control option.
- For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
Click Create.

Riga di comando

Sostituisci STORAGE_CLASS con il tuo preferito classe di archiviazione.
Sostituisci LOCATION con la tua località preferita (ASIA, EU o US)
Sostituisci BUCKET_NAME con un nome bucket che soddisfa nome bucket standard.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Impostare i ruoli IAM

Per consentire all'agente di Google Cloud per SAP di eseguire operazioni di backup e recupero per SAP HANA, devi assicurarti che l'account di servizio utilizzato dall'istanza Compute Engine o dal server Bare Metal Solution includa il ruolo IAM Amministratore oggetti archiviazione (storage.objectAdmin).

Per aggiungere questo ruolo al tuo account di servizio, segui questi passaggi:

Nella console Google Cloud, vai alla pagina IAM.

Vai a IAM
Selezionare il tuo progetto Google Cloud.
Identifica l'account di servizio a cui vuoi aggiungere il ruolo.
- Se l'account di servizio non è già presente nell'elenco delle entità, non sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
- Se l'account di servizio è già presente nell'elenco dei principali, significa che ha già dei ruoli. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.
Dall'elenco dei ruoli disponibili, seleziona Storage Object Admin.
Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

Per un livello di accesso granulare, puoi impostare le seguenti autorizzazioni IAM sul ruolo personalizzato per il tuo account di servizio a livello di progetto:

storage.objects.list
storage.objects.create

Devi anche impostare i criteri IAM sul tuo bucket concedendo al tuo principale le seguenti autorizzazioni IAM:

storage.objects.get
storage.objects.update
storage.objects.delete

Aggiungi le seguenti autorizzazioni se vuoi eseguire caricamenti suddivisi:

storage.multipartUploads.create
storage.multipartUploads.abort

Per ulteriori informazioni su come creare un ruolo personalizzato, consulta Creare e gestire i ruoli personalizzati. Per saperne di più su come concedere a un principale un ruolo personalizzato per l'accesso a livello di bucket, consulta Aggiungere un principale a una policy a livello di bucket.

Abilita l'accesso alle API Cloud e ai server di metadati

L'agente di Google Cloud per SAP richiede l'accesso ai seguenti indirizzi IP e host Google Cloud durante le operazioni di backup e ripristino:

Per accedere a Cloud Storage, storage.googleapis.com.
Per il server metadati delle istanze Compute Engine:
- oauth2.googleapis.com, per l'autenticazione
- 169.254.169.254
- metadata.google.internal

Se l'agente di Google Cloud per SAP e il sistema SAP HANA sono in esecuzione su un'istanza Compute Engine che non ha accesso a internet, devi configurare Accesso privato Google in modo che l'agente possa interagire con Cloud Storage e, se utilizzi un account di servizio dedicato, autenticarsi con Google Cloud. Per le istruzioni, consulta Configurare l'accesso privato Google.

Attivare la funzionalità Backint

Per attivare la funzionalità Backint dell'agente di Google Cloud per SAP, completa i seguenti passaggi:

Connettiti all'host SAP HANA tramite SSH.

Se il tuo host è un'istanza Compute Engine, dalla pagina Istanze VM della console Google Cloud puoi fare clic sul pulsante SSH per l'istanza o utilizzare il metodo SSH che preferisci.
Passa all'amministratore di sistema SAP HANA:
```
sudo su - SID_LCadm
```
Sostituisci SID_LC con l'ID cliente. Utilizza le lettere minuscole per tutte le lettere.

Questo comando imposta anche diverse variabili di ambiente, tra cui $SAPSYSTEMNAME, che viene impostata con l'SID del database SAP HANA.
Attiva la funzionalità Backint per l'agente per SAP di Google Cloud:
```
/usr/bin/google_cloud_sap_agent installbackint
```
In alternativa, per installare i file relativi a Backint su un host con un SID diverso, includi il flag sid:
```
/usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC
```
Sostituisci DIFFERENT_SID_LC con il SID dell'istanza SAP HANA richiesta. Utilizza le lettere minuscole.

Dopo l'esecuzione corretta del comando, tutti i file relativi alla funzionalità Backint dell'agente di Google Cloud per SAP vengono installati nella directory /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Sono inclusi i file necessari per l'integrazione dell'agente con SAPHANA. Inoltre, rileva l'agente Backint di Cloud Storage per SAP HANA sul tuo host, lo disattiva e copia i relativi file in una directory recuperabile sul tuo host. Per ulteriori informazioni, consulta Eseguire l'upgrade dall'agente Backint.
Configura la funzionalità Backint:
Esegui comando
- Se il database SAP HANA è in esecuzione su un'istanza Compute Engine o su un server Bare Metal Solution, per configurare la funzionalità Backint dell'agente, esegui il comando configurebackint. Ti consigliamo questo approccio anziché modificare il file di configurazione Backint dell'agente.
  /usr/bin/google_cloud_sap_agent configurebackint \ -f="PATH_TO_PARAMETERS_FILE" \ -bucket="BUCKET_NAME"
- Se il database SAP HANA è in esecuzione in un ambiente on-premise, configura la funzionalità Backint dell'agente eseguendo il seguente comando:
  /usr/bin/google_cloud_sap_agent configurebackint \ -f="PATH_TO_PARAMETERS_FILE" \ -bucket="BUCKET_NAME" \ -service_account_key="PATH_TO_KEY" \ -log_to_cloud=false \ -send_metrics_to_monitoring=false
  Sostituisci quanto segue:
  - PATH_TO_PARAMETERS_FILE: il percorso del PARAMETERS.json file di configurazione di Backint
  - BUCKET_NAME: il nome del bucket Cloud Storage in cui vuoi archiviare i backup di SAP HANA
  - PATH_TO_KEY: il percorso completo della chiave dell'account di servizio Google Cloud codificata in JSON che hai configurato
Se vuoi, puoi impostare altri parametri durante l'esecuzione di questo comando. Per informazioni su questi parametri, consulta Parametri di configurazione.
Modifica il file di configurazione
In alternativa all'esecuzione del comando configurebackint dell'agente, puoi modificare il file di configurazione di Backint come segue:
1. Apri il file di configurazione Backint:
  /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
  Sostituisci SID con l'SID del sistema SAP dove hai installato i file relativi a Backint.
  
  Di seguito è riportato un esempio di ciò che contiene il file di configurazione:
  { "bucket": "", "log_to_cloud": true }
2. Per consentire all'agente di Google Cloud per SAP di eseguire operazioni di backup e recupero basate su Backint per il sistema SAP HANA, modifica il file di configurazione e specifica i seguenti parametri:
  - bucket: specifica il nome del bucket Cloud Storage in cui vuoi archiviare i backup di SAP HANA
  - service_account_key: se hai creato un account di servizio per l'agente di Google Cloud per SAP, specifica il percorso assoluto della directory sul tuo host in cui hai caricato la chiave dell'account di servizio codificata in JSON corrispondente
  Per ulteriori informazioni, consulta Considerazioni sugli account di servizio.
3. Se il database SAP HANA è in esecuzione in un ambiente on-premise, assicurati di impostare anche quanto segue:
  - "log_to_cloud": false
  - "send_metrics_to_monitoring": false
4. Se vuoi, puoi modificare altri parametri di configurazione. Per informazioni su questi parametri, consulta Parametri di configurazione.
5. Salva il file di configurazione.

Personalizzare il file di configurazione Backint

Se vuoi, dopo aver attivato la funzionalità Backint dell'agente di Google Cloud per SAP, puoi eseguire le seguenti personalizzazioni:

Rinomina il file parameters.json.

Per indicare questa ridenominazione, questo file viene chiamato PARAMETERS.json nella documentazione di Agent for SAP di Google Cloud.
Crea un file di configurazione separato per ciascuno dei seguenti elementi: volume di dati SAP HANA, volume di log SAP HANA e catalogo di backup SAP HANA.

Assicurati di impostare un nome univoco per ogni file di configurazione.
Sposta questi file di configurazione in un'altra directory. Ad esempio, in un deployment scalabile, puoi archiviare i file di configurazione correlati a Backint di tutti i tuoi nodi in una directory condivisa accessibile ai nodi. In questo modo puoi gestire più facilmente questi file.

Se esegui una di queste personalizzazioni, assicurati di specificare in modo appropriato il nome del file e il relativo percorso per i parametri nel file global.ini di SAP HANA. Per le istruzioni, consulta Configurare SAP HANA per la funzionalità Backint.

Configurare SAP HANA per la funzionalità Backint

Dopo aver attivato la funzionalità Backint dell'agente di Google Cloud per SAP, devi configurare il sistema SAP HANA per utilizzare questa funzionalità:

Utilizza SAP HANA Studio o SAP HANA Cockpit per modificare il file di configurazione global.ini.

Nella sezione backup del file global.ini, specifica i valori per i seguenti parametri:

Parametro	Valore
`data_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json`.
`parallel_data_backup_backint_channels`	Per i backup dei dati in multistreaming, specifica il numero di canali in base al tipo di bucket Cloud Storage che utilizzi, alle prestazioni richieste e alla velocità effettiva del disco.
`log_backup_using_backint`	Se utilizzi un file di configurazione separato per il volume dei log di backup SAP HANA, specifica il valore `true`.
`log_backup_parameter_file`	Se utilizzi un file di configurazione separato per il volume dei log di backup di SAP HANA, specifica il seguente valore: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json`. Sostituisci `PARAMETERS_LOG` con il nome del file di configurazione che utilizzi per i backup del volume di log SAP HANA.
`catalog_backup_using_backint`	Se utilizzi un file di configurazione separato per il catalogo di backup SAP HANA, specifica il valore `true`.
`catalog_backup_parameter_file`	Se utilizzi un file di configurazione separato per il catalogo di backup SAP HANA, specifica il seguente valore: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json`. Sostituisci `PARAMETERS_CATALOG` con il nome del file di configurazione che utilizzi per i backup del catalogo di backup SAP HANA.

Di seguito è riportato un esempio di file global.ini configurato per utilizzare la funzionalità Backint dell'agente di Google Cloud per SAP:

[backup]
log_backup_using_backint = true
catalog_backup_using_backint = true
parallel_data_backup_backint_channels = 16
catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

Nella sezione persistence del file global.ini, specifica i valori per i seguenti parametri:
- basepath_logbackup: specifica la directory nel file system in cui SAP HANA può archiviare i backup dei log quando non è in grado di connettersi al bucket Cloud Storage. Assicurati che questa directory abbia spazio sufficiente per archiviare i backup.
- basepath_catalogbackup: specifica la directory nel file system dove SAP HANA può archiviare i backup del catalogo di backup di SAP HANA quando non è in grado di connettersi al bucket Cloud Storage. Assicurati che questa directory abbia spazio sufficiente per archiviare i backup.

Convalida il backup e il recupero

Dopo aver attivato la funzionalità Backint dell'agente di Google Cloud per SAP, assicurati di verificarla creando e ripristinando un backup in un sistema di test.

Per i test, puoi utilizzare lo strumento di autodiagnosi integrato dell'agente. Per eseguire questo strumento integrato, devi disporre di almeno 18 GB di spazio su disco disponibile nel file system. Per utilizzare questo strumento integrato per convalidare il backup e il ripristino, esegui il seguente comando:

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

Sostituisci quanto segue:

IDENTIFIER: un valore che identifica l'esecuzione del comando. Questo identificatore viene utilizzato per assegnare un nome alla cartella temporanea creata nel bucket Cloud Storage durante l'esecuzione della diagnostica.
PATH_TO_PARAMETERS_FILE: il percorso del PARAMETERS.json file

Quando utilizzi questo strumento, puoi utilizzare i parametri facoltatividiagnose_file_max_size_gb e diagnose_tmp_directory. Per ulteriori informazioni su questi parametri, consulta le relative descrizioni in Parametri di configurazione.

Se hai installato l'agente Backint sul tuo host, la prima volta che utilizzi l'agente di Google Cloud per SAP per eseguire un'operazione di backup, l'agente di Google Cloud per SAP crea le versioni JSON dei file di configurazione di testo. Per ulteriori informazioni, consulta Eseguire l'upgrade dall'agente Backint.

File di configurazione di esempio

Di seguito è riportato un file di configurazione PARAMETERS.json completo della funzionalità Backint dell'agente di Google Cloud per SAP:

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

Parametri di configurazione

La tabella seguente illustra i parametri di configurazione dell'agente di Google Cloud per SAP specifici per la funzionalità Backint.

Per informazioni sulla mappatura tra i parametri di configurazione dell'agente Backint e l'agente di Google Cloud per SAP, consulta Mappatura dei parametri di configurazione.

Per informazioni sui parametri di configurazione dell'agente di Google Cloud per SAP, inclusi i parametri relativi alla raccolta delle metriche, consulta la guida all'installazione per il tuo scenario.

Parametri
`bucket`	`String` Specifica il nome del bucket Cloud Storage su cui l'agente di Google Cloud per SAP scrive e da cui legge. L'agente crea oggetti di backup con la classe di archiviazione del bucket e supporta tutte le classi di archiviazione. L'agente utilizza la crittografia predefinita di Compute Engine per criptare i dati at-rest.
`recovery_bucket`	`String` Facoltativo. Specifica il nome del bucket Cloud Storage letto dall'agente durante le operazioni `RESTORE`. Se non specifichi questo parametro, l'agente utilizza il bucket specificato per il parametro `bucket` per tutte le operazioni: `BACKUP`, `RESTORE`, `INQUIRE`, `DELETE` e `DIAGNOSE`. Sebbene ti consigliamo di utilizzare questo parametro per semplificare la gestione della configurazione per le operazioni di copia e aggiornamento del sistema, non è compatibile con l'argomento `CHECK ACCESS USING BACKINT` durante le operazioni di ripristino di SAP HANA.
`log_to_cloud`	`Boolean` Facoltativo. Per reindirizzare i log relativi a Backint dell'agente di Google Cloud per SAP a Cloud Logging, specifica `true`. Il valore predefinito è `true`. Se il database SAP HANA è in esecuzione in un ambiente on-premise, devi impostare il valore di questo parametro su `false`. Per informazioni sul file di log relativo a Backint, consulta Logging.
`log_level`	`String` Facoltativo. Specifica il livello di logging per la funzionalità Backint dell'agente per SAP di Google Cloud, imposta il valore richiesto. I livelli di log disponibili sono come segue: `DEBUG` `INFO` `WARNING` `ERROR` Il valore predefinito è `INFO`. Non modificare il livello di registrazione a meno che non ti venga indicato dall'assistenza clienti Google Cloud.
`compress`	`Boolean` Facoltativo. Specifica se l'agente di Google Cloud per SAP deve attivare o meno la compressione durante la scrittura dei backup nel bucket Cloud Storage. Il valore predefinito è `false`. Ti consigliamo di non attivare la compressione. Sebbene la compressione riduca il costo dell'archiviazione per i backup in Cloud Storage, richiede una maggiore elaborazione della CPU durante le operazioni di backup e rallenta il throughput effettivo del backup. Indipendentemente da questo parametro, l'agente di Google Cloud per SAP supporta sia i file di backup compressi sia quelli non compressi durante un'operazione di ripristino.
`encryption_key`	`String` Facoltativo. Specifica il percorso della chiave di crittografia fornita dal cliente che hai configurato per il bucket Cloud Storage da utilizzare per criptare i backup. Assicurati di specificare un percorso completo per una chiave AES-256 con codifica base64. Non puoi specificare il parametro `encryption_key` con i parametri `kms_key` o `parallel_streams`.
`kms_key`	`String` Facoltativo. Specifica il percorso della chiave di crittografia gestita dal cliente che hai configurato per il bucket Cloud Storage da utilizzare per criptare i backup. Specifica il percorso utilizzando il formato `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME`, dove: `KMS_PROJECT_ID`: l'ID del progetto Google Cloud in cui esiste la chiave KMS `LOCATION`: la posizione Cloud KMS in cui esiste la tua chiave KMS `KEY_RING_NAME`: il nome della raccolta di chiavi che contiene la chiave KMS `KMS_KEY_NAME`: il nome della chiave KMS Se il sistema SAP HANA è in esecuzione su un'istanza Compute Engine, la chiave deve essere accessibile a quell'istanza. Se il sistema SAP HANA è in esecuzione su un host diverso da un'istanza Compute Engine, la chiave Cloud KMS deve essere accessibile all'account di servizio utilizzato dall'Agent for SAP di Google Cloud. Per saperne di più, consulta Account di servizio. Non puoi specificare il parametro `kms_key` con i parametri `encryption_key` o `parallel_streams`.
`folder_prefix`	`String` Facoltativo. Specifica di impostare un prefisso per le cartelle nel bucket Cloud Storage in cui l'agente di Google Cloud per SAP scrive e legge. Puoi utilizzare questo parametro per organizzare i backup di diverse istanze SAP HANA nello stesso bucket Cloud Storage. Puoi specificare una singola cartella, ad esempio `folder1`, o un percorso di più livelli di cartelle, ad esempio `folder1/folder2/folder3`. Questo prefisso viene inserito come cartella tra i valori `BUCKET_NAME` e `SID` nel percorso dei backup di SAP HANA in Cloud Storage. Per ulteriori informazioni, consulta la sezione Personalizzazioni supportate. Questo parametro è disponibile a partire dalla versione 3.1 dell'agente. Avviso:la modifica del valore di questo parametro modifica il percorso dei file di backup, il che può causare errori durante le operazioni di recupero del database. Pertanto, prima di modificare il valore di questo parametro, assicurati di testare il backup e il recupero con il nuovo valore parametro in un ambiente non di produzione.
`recovery_folder_prefix`	`String` Facoltativo. Specifica di impostare un prefisso per le cartelle nel bucket Cloud Storage che l'agente legge durante le operazioni `RESTORE`. Puoi utilizzare questo parametro per organizzare i backup di diverse istanze SAP HANA nello stesso bucket Cloud Storage. Puoi specificare una singola cartella, ad esempio `folder1`, o un percorso di cartelle a più livelli, ad esempio `folder1/folder2/folder3`. Per ulteriori informazioni, consulta Personalizzazioni supportate. Questo parametro è disponibile a partire dalla versione 3.1 dell'agente. Sebbene ti consigliamo di utilizzare questo parametro per semplificare la gestione della configurazione per le operazioni di copia e aggiornamento del sistema, non è compatibile con l'argomento `CHECK ACCESS USING BACKINT` durante le operazioni di ripristino di SAP HANA. Avviso:la modifica del valore di questo parametro modifica il percorso dei file di backup, il che può causare errori durante le operazioni di recupero del database. Pertanto, prima di modificare il valore di questo parametro, assicurati di testare il backup e il recupero con il nuovo valore parametro in un ambiente non di produzione.
`shorten_folder_path`	`Boolean` Facoltativo. Specifica di accorciare il percorso dell'oggetto nel bucket Cloud Storage letto e scritto dall'agente durante tutte le operazioni di backint. Per ulteriori informazioni, consulta Personalizzazioni supportate. Questo parametro è disponibile a partire dalla versione 3.3 dell'agente. Avviso:la modifica del valore di questo parametro modifica il percorso dei file di backup, il che può causare errori durante le operazioni di recupero del database. Pertanto, prima di modificare il valore di questo parametro, assicurati di testare il backup e il recupero con il nuovo valore parametro in un ambiente non di produzione.
`retries`	`Int` Specifica il numero massimo di volte in cui l'Agente per SAP di Google Cloud ritenta un tentativo non riuscito di lettura o scrittura in Cloud Storage. Il valore predefinito è `5`, che è anche il valore consigliato.
`parallel_streams`	`Int` Facoltativo. Specifica questo parametro per abilitare il caricamento parallelo dei backup nel tuo bucket Cloud Storage. Il valore specificato per questo parametro è il numero massimo di stream di caricamento paralleli che Agent for SAP di Google Cloud può utilizzare. Il valore massimo è 32. Qualsiasi valore superiore viene limitato a 32. Il valore predefinito è `1`, che disattiva il caricamento parallelo. Se vuoi attivare il caricamento parallelo per i dati in streaming o se il tuo bucket Cloud Storage ha un criterio di conservazione, devi anche impostare `xml_multipart_upload` su `true`. Non attivare il caricamento parallelo se si verifica una delle seguenti condizioni: Il bucket Cloud Storage di destinazione utilizza una regola di conservazione. Hai specificato i parametri `encryption_key` o `kms_key`. Se una delle condizioni precedenti è soddisfatta, l'agente esce con stato `1`. Per informazioni sui caricamenti paralleli, consulta Caricamenti paralleli.
`xml_multipart_upload`	`Boolean` Facoltativo. Specifica se il metodo caricamento multiparte dell'API XML viene utilizzato o meno durante la scrittura dei backup nel bucket Cloud Storage. Il valore predefinito è `false`. Questo parametro è disponibile a partire dalla versione 3.2 dell'agente. Per utilizzare il metodo di caricamento multiparte dell'API XML, `parallel_streams` deve avere un valore maggiore di `1`. Se imposti `xml_multipart_upload` su `true`, ma non specifichi `parallel_streams`, a `parallel_streams` viene assegnato automaticamente il valore `16`. Ti consigliamo di utilizzare `xml_multipart_upload` solo per eseguire in parallelo i backup dei log o dei cataloghi. Per eseguire in parallelo i backup dei dati, ti consigliamo di impostare `parallel_data_backup_backint_channels` nella sezione `backup` del file `global.ini`. Per informazioni su come creare file di parametri separati per i backup dei log e dei dati o su come impostare il valore per `parallel_data_backup_backint_channels`, consulta Configurare SAP HANA per la funzionalità Backint. In caso di errore, i caricamenti di XML multipart vengono abortiti automaticamente e i dati in fase di caricamento vengono eliminati. Ti consigliamo inoltre di impostare le condizioni del ciclo di vita per AbortIncompleteMultipartUpload per assicurarti che i dati vengano eliminati se l'operazione di caricamento non va a buon fine.
`storage_class`	`String` Facoltativo. Specifica la classe di archiviazione utilizzata per scrivere i backup nel bucket Cloud Storage. Le classi di archiviazione disponibili sono le seguenti: `STANDARD` `NEARLINE` `COLDLINE` `ARCHIVE` Il valore predefinito è `STANDARD`. Questo parametro è disponibile a partire dalla versione 3.2 dell'agente.
`metadata`	`Map<String, String>` Facoltativo. Specifica i campi chiave:valore da archiviare come metadati per gli oggetti quando scrivi i backup nel bucket Cloud Storage. Questo parametro è disponibile a partire dalla versione 3.3 dell'agente. Il formato di un file di configurazione `PARAMETERS.json` di esempio è il seguente: { "bucket": "example-bucket-backup", "metadata": {"key1": "value1", "key2": "value2"}, "log_to_cloud": true } I metadati predefiniti scritti sono `{"X-Backup-Type": "PIPE"}` o `{"X-Backup-Type": "FILE"}` a seconda del tipo di file. Avviso: la chiave `X-Backup-Type` non deve essere sovrascritta dai metadati personalizzati.
`custom_time`	`String` Facoltativo. Specifica una data e un'ora da impostare per i metadati `Custom-Time` dei backup caricati su Cloud Storage. Devi specificare la data e l'ora nel formato specificato in `Custom-Time`. Questo parametro è disponibile a partire dalla versione 3.4 dell'agente. Puoi impostare questo parametro con il valore `UTCNow`, che imposta i metadati `Custom-Time` con la data e l'ora UTC in cui viene creato il backup. Dalla versione 3.6 dell'agente, puoi impostare una data futura per i metadati `Custom-Time` utilizzando `UTCNow+NUMBERd`. Ad esempio, per impostare `Custom-Time` su 30 giorni dalla data di creazione del backup, imposta la configurazione come nell'esempio seguente: { "bucket": "example-bucket-backup", "custom_time": "UTCNow+30d", "log_to_cloud": true } Di seguito è riportato un esempio di come puoi specificare questo parametro con un valore data/ora nel file `PARAMETERS.json`: { "bucket": "example-bucket-backup", "custom_time": "2024-06-25T13:25:00Z", "log_to_cloud": true }
`rate_limit_mb`	`Int` Facoltativo. Specifica il limite superiore, in MB, per la larghezza di banda della rete in uscita di Compute Engine durante le operazioni di backup o ripristino. Per impostazione predefinita, Google Cloud non limita la larghezza di banda della rete per l'agente di Google Cloud per SAP. Quando imposti questo parametro, la produttività potrebbe variare, ma non supererà il limite specificato.
`service_account_key`	`String` Se l'agente per SAP di Google Cloud non è in esecuzione su un'istanza Compute Engine, specifica il percorso completo dell'account di servizio Google Cloud codificato in JSON. Se Agent for SAP di Google Cloud è in esecuzione su un'istanza Compute Engine, ti consigliamo di non specificare questo parametro e di utilizzare l'autenticazione predefinita di Compute Engine. La specifica di questo parametro indica all'agente di Google Cloud per SAP di utilizzare la chiave dell'account di servizio durante l'autenticazione in Cloud Storage.
`diagnose_file_max_size_gb`	`Int` Facoltativo. Specifica il limite superiore per le dimensioni del file temporaneo, in GB, creato ed eliminato dallo strumento di autodiagnosi dell'agente. Il valore predefinito è 16 GB. Questo parametro è disponibile a partire dalla versione 3.3 dell'agente. Per il corretto funzionamento dello strumento di autodiagnosi, devi assicurarti che lo spazio di archiviazione disponibile nel file system sia almeno 2-3 GB superiore al valore di `diagnose_file_max_size_gb`.
`diagnose_tmp_directory`	`String` Facoltativo. Specifica la directory utilizzata per leggere e scrivere file temporanei per lo strumento di autodiagnosi dell'agente. Il valore predefinito è `/tmp/backint-diagnose`. Questo parametro è disponibile a partire dalla versione 3.3 dell'agente.
`send_metrics_to_monitoring`	`Boolean` Facoltativo. Specifica se l'agente può raccogliere o meno le metriche relative allo stato e al throughput dei file caricati o scaricati durante le operazioni di Backint. L'agente invia le metriche raccolte a Cloud Monitoring. Questo parametro è disponibile a partire dalla versione 3.3 dell'agente. Il valore predefinito è `true`. Se il database SAP HANA è in esecuzione in un ambiente on-premise, devi impostare il valore di questo parametro su `false`. Per informazioni sulle metriche relative a Backint, consulta la raccolta delle metriche di Backint.
`threads`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il numero di thread worker. Il valore predefinito è il numero di processori nell'host.
`file_read_timeout_ms`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il tempo massimo, in millisecondi, che l'agente di Google Cloud per SAP attende per aprire il file di backup. Il valore predefinito è `60000` (60 secondi).
`buffer_size_mb`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica questo parametro per controllare le dimensioni delle richieste HTTPS a Cloud Storage durante le operazioni di backup o ripristino. La dimensione predefinita del buffer è 100 MB, il che significa che un singolo stream di richieste HTTPS verso o da Cloud Storage viene mantenuto aperto fino a quando non vengono trasferiti 100 MB di dati. La dimensione massima del buffer è 250 MB. Poiché l'Agent for SAP di Google Cloud riprova le richieste HTTPS non riuscite più volte prima di interrompere un'operazione, le dimensioni del buffer inferiori a 100 MB comportano meno dati da ritrasmettere se una richiesta non va a buon fine. Dimensioni del buffer più grandi possono migliorare il throughput, ma richiedono un maggiore utilizzo della memoria e più tempo per inviare nuovamente i dati in caso di errore nella richiesta. Se utilizzi il parametro `parallel_streams`, l'utilizzo della memoria richiesto deve essere moltiplicato per questo valore perché ogni stream richiede il proprio buffer per elaborare le richieste HTTPS.
`retry_backoff_initial`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il valore iniziale, in secondi, per il periodo di ripetizione utilizzato nei tentativi di rete con backoff esponenziale. Il valore predefinito è `10`.
`retry_backoff_max`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il valore massimo, in secondi, per il periodo di nuovo tentativo utilizzato nei nuovi tentativi di rete con backoff esponenziale. Il valore predefinito è `300`.
`retry_backoff_multiplier`	`Float` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il moltiplicatore per il periodo di nuovo tentativo utilizzato nei nuovi tentativi di rete con backoff esponenziale. Il moltiplicatore deve essere maggiore di `1` e il valore predefinito è `2`.
`log_delay_sec`	`Int` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica il ritardo di registrazione, in secondi, per gli aggiornamenti dell'avanzamento durante le letture e le scritture nel bucket Cloud Storage. Il valore predefinito è `60`.
`client_endpoint`	`String` Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro, a meno che non ti venga richiesto di farlo dall'assistenza clienti. Il valore predefinito raramente deve essere modificato. Specifica l'endpoint del client Cloud Storage. Il valore predefinito è `storage.googleapis.com`.

Risoluzione dei problemi

Per risolvere i problemi relativi alla versione 3.6 (la più recente) dell'agente di Google Cloud per SAP, consulta la guida alla risoluzione dei problemi dell'agente di Google Cloud per SAP.

Assistenza

Se hai bisogno di aiuto per risolvere un problema con l'agente per SAP di Google Cloud, raccogli le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per ulteriori informazioni, consulta Informazioni di diagnostica dell'agente di Google Cloud per SAP per SAP HANA.

Passaggi successivi

Per scoprire come creare backup basati su Backint e recuperare il database SAP HANA utilizzandoli, consulta Eseguire il backup e il recupero di SAP HANA utilizzando Backint.