Configura il backup e il ripristino basati su Backint per SAP HANA

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

Per informazioni su questa funzionalità, consulta Backup e ripristino basati su Backint per SAP HANA.

Per informazioni sull'esecuzione delle operazioni di backup e ripristino per SAP HANA utilizzando Backint, consulta Esecuzione di backup e ripristino con Backint.

Prima di iniziare

  • Convalida la tua installazione della versione 3.4 (più recente) dell'agente di Google Cloud per SAP. Per le istruzioni, consulta la guida all'installazione adatta al 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, vedi Configurare l'agente Google Cloud per SAP su Linux.
  • Se devi abilitare questa funzionalità per un'istanza dell'agente per SAP di Google Cloud in esecuzione su un host diverso da un'istanza di una macchina virtuale (VM) Compute Engine o da un server Bare Metal Solution, devi creare un incidente con supporto SAP nel componente BC-OP-LNX-GOOGLE, in modo che sia SAP che Google Cloud possano valutare la configurazione.
  • Installa SAP HANA:

crea un bucket Cloud Storage

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

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

Per creare un bucket Cloud Storage:

Console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.

    Vai alla pagina Bucket

  2. Fai clic su Crea bucket.
  3. Nella pagina Crea un bucket, inserisci le informazioni del bucket. Per andare al passaggio successivo, fai clic su Continua.
  4. Fai clic su Crea.

Riga di comando

    Crea un bucket Cloud Storage e configuralo nel seguente modo: 
    gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Imposta ruoli IAM

Per consentire all'agente di Google Cloud per SAP di eseguire operazioni di backup e ripristino per SAP HANA, devi assicurarti che l'account di servizio utilizzato dalla VM di Compute Engine o dal server Bare Metal Solution includa il ruolo IAM Storage Object Admin (storage.objectAdmin).

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

  1. Nella console Google Cloud, vai alla pagina IAM.

    Vai a IAM

  2. Selezionare il tuo progetto Google Cloud.

  3. Identifica l'account di servizio a cui vuoi aggiungere il ruolo.

    • Se l'account di servizio non è già nell'elenco delle entità, non gli sono stati assegnati ruoli. Fai clic su Aggiungi e inserisci l'indirizzo email dell'account di servizio.
    • Se l'account di servizio è già nell'elenco delle entità, ha i ruoli esistenti. Fai clic sul pulsante Modifica per l'account di servizio che vuoi modificare.

  4. Dall'elenco dei ruoli disponibili, seleziona Storage Object Admin (Amministratore oggetti Storage).

  5. Fai clic su Aggiungi o Salva per applicare i ruoli all'account di servizio.

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

L'agente per SAP di Google Cloud 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 di metadati delle istanze VM di 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 tuo sistema SAP HANA sono in esecuzione su una VM Compute Engine che non ha accesso a internet, devi configurare l'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.

Attiva la funzionalità Backint

Per abilitare la funzionalità Backint dell'agente di Google Cloud per SAP, completa questi passaggi:

  1. Connettiti all'host SAP HANA utilizzando SSH.

    Se l'host è una VM di Compute Engine, dalla pagina Istanze VM della console Google Cloud puoi fare clic sul pulsante SSH per la tua istanza VM oppure utilizzare il tuo metodo SSH preferito.

  2. Passa all'amministratore di sistema SAP HANA:

    sudo su - SID_LCadm

    Sostituisci SID_LC con il SID. Usa il minuscolo per ogni lettera.

    Questo comando imposta anche diverse variabili di ambiente, tra cui $SAPSYSTEMNAME, che viene impostata con il SID del tuo database SAP HANA.

  3. Abilita la funzionalità Backint per l'agente di Google Cloud per SAP:

    /usr/bin/google_cloud_sap_agent installbackint

    In alternativa, per installare i file correlati 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 il minuscolo per le lettere.

    Una volta eseguito il 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/. Questo include i file necessari per integrare l'agente con SAP HANA. 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 maggiori informazioni, consulta Upgrade dall'agente Backint.

  4. Configura la funzionalità Backint:

    Esegui comando

    Per configurare la funzionalità Backint dell'agente, esegui il comando configurebackint. Consigliamo questo approccio rispetto alla modifica del file di configurazione Backint.

    /usr/bin/google_cloud_sap_agent configurebackint \
  -f="PATH_TO_PARAMETERS_FILE" \
  -bucket="BUCKET_NAME"

    Sostituisci quanto segue:

    • PATH_TO_PARAMETERS_FILE: il percorso del tuo file di configurazione Backint di PARAMETERS.json

    • BUCKET_NAME: specifica il nome del bucket Cloud Storage in cui vuoi archiviare i backup SAP HANA

      Se vuoi, puoi impostare altri parametri durante l'esecuzione di questo comando. Per informazioni su questi parametri, vedi Parametri di configurazione.

    Modifica file di configurazione

    Invece di eseguire il comando configurebackint dell'agente, modifica il file di configurazione di Backint come segue:

    1. Apri il file di configurazione di Backint:

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

      Sostituisci SID con il SID del sistema SAP in cui hai installato i file relativi a Backint.

      Di seguito è riportato un esempio di cosa contiene il file di configurazione:

      {
 "bucket": "",
 "log_to_cloud": true
}

    2. Per consentire all'agente per SAP di Google Cloud di eseguire operazioni di backup e ripristino basate su Backint per il tuo 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 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 con codifica JSON corrispondente

      Per maggiori informazioni, consulta Considerazioni sull'account di servizio.

    3. Facoltativamente, puoi modificare altri parametri di configurazione. Per informazioni su questi parametri, vedi Parametri di configurazione.

    4. Salva il file di configurazione.

Personalizzare il file di configurazione di Backint

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

  • Rinomina il file parameters.json.

    Per indicare la ridenominazione, questo file è denominato PARAMETERS.json nella documentazione di Agent for SAP di Google Cloud.

  • Creare 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 i file di configurazione in un'altra directory. Ad esempio, in un deployment con scale out, puoi archiviare i file di configurazione relativi a Backint di tutti i nodi in una directory condivisa accessibile ai nodi. In questo modo sarà più facile gestire questi file.

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

Configura SAP HANA per la funzionalità Backint

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

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

  2. 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 multistreaming, specifica il numero di canali considerando il tipo di bucket Cloud Storage in uso, le prestazioni richieste e la velocità effettiva del disco.
    log_backup_using_backint Se utilizzi un file di configurazione separato per il volume dei log di backup di 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 stai utilizzando per i backup del volume di log di 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 stai utilizzando per i backup del catalogo di backup di SAP HANA.

    Di seguito è riportato un esempio di file global.ini configurato per l'utilizzo della 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

  3. 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 disponga di spazio sufficiente per archiviare i backup.
    • basepath_catalogbackup: specifica la directory nel tuo file system in cui SAP HANA può archiviare i backup del catalogo di backup di SAP HANA quando non riesce a connettersi al bucket Cloud Storage; assicurati che questa directory abbia spazio sufficiente per archiviare i backup.

    I parametri basepath_catalogbackup e basepath_logbackup mostrano lo stesso valore nella sezione persistenza del file global.ini

Convalida backup e ripristino

Dopo aver abilitato la funzionalità Backint dell'agente di Google Cloud per SAP, assicurati di convalidarla 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 sono necessari almeno 18 GB di spazio su disco disponibile nel file system. Per utilizzare questo strumento integrato per convalidare backup e ripristino, esegui questo 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 tuo file PARAMETERS.json

Mentre usi questo strumento, puoi utilizzare i parametri facoltativi diagnose_file_max_size_gb e diagnose_tmp_directory. Per ulteriori informazioni su questi parametri, consulta le relative descrizioni in Parametri di configurazione.

Se avevi installato l'agente Backint nell'host, la prima volta che utilizzi Agent per SAP di Google Cloud per eseguire un'operazione di backup, l'agente per SAP di Google Cloud crea versioni JSON dei file di configurazione testo. Per maggiori informazioni, consulta Upgrade dall'agente Backint.

File di configurazione di esempio

Di seguito è riportato un file di configurazione PARAMETERS.json completato 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 spiega i parametri di configurazione dell'Agente per SAP di Google Cloud specifici della funzionalità Backint.

Per informazioni sulla mappatura tra i parametri di configurazione dell'agente Backint e dell'agente 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 in cui l'agente 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 che l'agente legge durante le operazioni di RESTORE. Se non specifichi questo parametro, l'agente utilizza il bucket specificato per il parametro bucket per tutte le operazioni: operazioni BACKUP, RESTORE, INQUIRE, DELETE e DIAGNOSE.
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.

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 di Google Cloud per SAP e imposta il valore richiesto. I livelli di log disponibili sono i seguenti:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Il valore predefinito è INFO. Non modificare il livello di logging a meno che non ti venga richiesto dall'assistenza clienti Google Cloud.
compress

Boolean

Facoltativo. Specifica se l'agente di Google Cloud per SAP deve abilitare o meno la compressione durante la scrittura dei backup sul bucket Cloud Storage. Il valore predefinito è false.

Ti consigliamo di non abilitare la compressione. Sebbene la compressione riduca il costo di archiviazione per i backup in Cloud Storage, richiede una maggiore elaborazione della CPU durante le operazioni di backup e rallenta la velocità effettiva effettiva del backup.

Indipendentemente da questo parametro, Agent for SAP di Google Cloud supporta file di backup compressi e non compressi durante un'operazione di ripristino.
encryption_key

String

Facoltativo. Specifica il percorso della chiave di crittografia fornita dal cliente che hai configurato nel bucket Cloud Storage da utilizzare per criptare i backup. Assicurati di specificare un percorso completo per una chiave AES-256 codificata in 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 nel tuo 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 località Cloud KMS in cui si trova la chiave KMS
  • KEY_RING_NAME: il nome del keyring che contiene la chiave KMS
  • KMS_KEY_NAME: il nome della chiave KMS

Se il tuo sistema SAP HANA è in esecuzione su una VM di Compute Engine, la chiave deve essere accessibile alla VM. Se il sistema SAP HANA è in esecuzione su un host diverso da una VM Compute Engine, la chiave Cloud KMS deve essere accessibile all'account di servizio utilizzato dall'agente di Google Cloud per SAP. Per maggiori informazioni, 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 Google Cloud per SAP scrive e da cui legge. Puoi utilizzare questo parametro per organizzare i backup di diverse istanze SAP HANA nello stesso bucket Cloud Storage. Puoi specificare una singola cartella, come folder1, o un percorso di cartelle multilivello, come folder1/folder2/folder3.

Questo prefisso è inserito come cartella tra i valori BUCKET_NAME e SID nel percorso dei backup SAP HANA in Cloud Storage. Per maggiori informazioni, consulta la pagina Personalizzazioni supportate.
recovery_folder_prefix

String

Facoltativo. Specifica di impostare un prefisso per le cartelle nel bucket Cloud Storage che l'agente legge durante le operazioni di RESTORE. Puoi utilizzare questo parametro per organizzare i backup di diverse istanze SAP HANA nello stesso bucket Cloud Storage. Puoi specificare una singola cartella, come folder1, o un percorso di cartelle multilivello, ad esempio folder1/folder2/folder3. Per maggiori informazioni, consulta la sezione Personalizzazioni supportate.
shorten_folder_path

Boolean

Facoltativo. Specifica di abbreviare il percorso dell'oggetto nel bucket Cloud Storage che l'agente legge e scrive durante tutte le operazioni di Backint. Per maggiori informazioni, consulta la sezione Personalizzazioni supportate.
retries

Int

Specifica il numero massimo di volte in cui l'agente Google Cloud per SAP riprova a eseguire un tentativo non riuscito di lettura o scrittura su Cloud Storage. Il valore predefinito è 5, che è anche il valore consigliato.
parallel_streams

Int

Facoltativo. Specifica questo argomento per abilitare il caricamento parallelo dei backup nel bucket Cloud Storage. Il valore specificato per questo argomento corrisponde al numero massimo di flussi di caricamento paralleli che l'agente di Google Cloud per SAP può utilizzare. Il valore massimo è 32. I valori che superano questo limite sono limitati a 32.

Il valore predefinito è 1 e disattiva il caricamento parallelo.

Se vuoi abilitare il caricamento parallelo per i flussi di dati o se il bucket Cloud Storage ha un criterio di conservazione, devi anche impostare xml_multipart_upload su true.

Non attivare il caricamento parallelo se si applica una delle seguenti condizioni:

  • Il bucket Cloud Storage di destinazione utilizza un criterio di conservazione.
  • Hai specificato i parametri encryption_key o kms_key.

Se una delle condizioni precedenti è soddisfatta, l'agente chiude con lo stato 1. Per informazioni sui caricamenti paralleli, consulta Caricamenti paralleli.
xml_multipart_upload

Boolean

Facoltativo. Specifica se il metodo di caricamento multiparte dell'API XML viene utilizzato o meno durante la scrittura dei backup nel bucket Cloud Storage. Il valore predefinito è false.

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 caricare in contemporanea i backup dei log o del catalogo. Per caricare in contemporanea 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 di log e 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 XML multiparte vengono interrotti automaticamente e i dati caricati vengono eliminati. Ti consigliamo anche di impostare le condizioni del ciclo di vita per AbortIncompleteMultipartUpload al fine di garantire che i dati vengano eliminati se l'operazione di caricamento non riesce.
storage_class

String

Facoltativo. Specifica la classe di archiviazione utilizzata durante la scrittura dei backup nel bucket Cloud Storage. Le classi di archiviazione disponibili sono le seguenti:

  • STANDARD
  • NEARLINE
  • COLDLINE
  • ARCHIVE

Il valore predefinito è STANDARD.
metadata

Map<String, String>

Facoltativo. Specifica i campi chiave:valore da archiviare come metadati per gli oggetti durante la scrittura dei backup nel bucket Cloud Storage. 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 scritti predefiniti sono {"X-Backup-Type": "PIPE"} o {"X-Backup-Type": "FILE"}, a seconda del tipo di file.

custom_time

String

Ozionale. Specifica una data e un'ora da impostare per i metadati Custom-Time per i backup che carichi in Cloud Storage. Devi specificare la data e l'ora nel formato specificato in Custom-Time.

Questo parametro è disponibile dalla versione 3.4 dell'agente.

Di seguito è riportato un esempio di come puoi specificare questo parametro nel tuo 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 Google Cloud per SAP. Quando imposti questo parametro, la velocità effettiva può variare, ma non supera il limite specificato.
service_account_key

String

Se l'agente di Google Cloud per SAP non è in esecuzione su una VM di Compute Engine, specifica il percorso completo dell'account di servizio Google Cloud con codifica JSON. Se l'agente di Google Cloud per SAP è in esecuzione su una VM di Compute Engine, ti consigliamo di non specificare questo parametro e di utilizzare invece l'autenticazione predefinita di Compute Engine.

Se specifichi questo parametro, l'Agente per SAP di Google Cloud può utilizzare la chiave dell'account di servizio per l'autenticazione in Cloud Storage.
diagnose_file_max_size_gb

Int

Facoltativo. Specifica il limite superiore per la dimensione del file temporaneo, in GB, che lo strumento di autodiagnostica dell'agente crea ed elimina. Il valore predefinito è 16 GB.

Per un corretto funzionamento dello strumento di autodiagnosi, devi assicurarti che lo spazio di archiviazione disponibile nel file system sia superiore di almeno 2-3 GB 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 autodiagnostica dell'agente. Il valore predefinito è /tmp/backint-diagnose.
send_metrics_to_monitoring

Boolean

Facoltativo. Specifica se l'agente può raccogliere o meno le metriche relative allo stato e alla velocità effettiva dei file che vengono caricati o scaricati durante le operazioni di Backint. L'agente invia le metriche raccolte a Cloud Monitoring.

Il valore predefinito è true. Per informazioni sulle metriche relative a Backint, consulta Raccolta delle metriche di Backint.
threads

Int

Si tratta di un parametro di ottimizzazione avanzata facoltativo. Non modificare questo parametro a meno che non venga richiesto dall'assistenza clienti. Il suo 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 venga richiesto dall'assistenza clienti. Il suo valore predefinito raramente deve essere modificato.

Specifica la quantità massima di tempo, in millisecondi, durante il quale l'agente Google Cloud per SAP attende prima di 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 venga richiesto dall'assistenza clienti. Il suo 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 flusso di richieste HTTPS da o verso Cloud Storage rimane aperto fino a quando non vengono trasferiti 100 MB di dati. La dimensione massima del buffer è 250 MB.

Poiché l'agente per SAP di Google Cloud ricorre più volte alle richieste HTTPS non riuscite prima di fallire un'operazione, le dimensioni del buffer inferiori a 100 MB si traducono in meno dati che devono essere ritrasmessi in caso di esito negativo di una richiesta. Buffer di dimensioni maggiori possono migliorare la velocità effettiva, ma richiedono un utilizzo maggiore di memoria e più tempo per inviare nuovamente i dati in caso di errore della richiesta.

Se utilizzi il parametro parallel_streams, l'utilizzo della memoria richiesto deve essere moltiplicato per quel valore, perché ogni flusso 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 venga richiesto dall'assistenza clienti. Il suo 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 venga richiesto dall'assistenza clienti. Il suo valore predefinito raramente deve essere modificato.

Specifica il valore massimo, in secondi, per il periodo di ripetizione utilizzato nei 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 venga richiesto dall'assistenza clienti. Il suo valore predefinito raramente deve essere modificato.

Specifica il moltiplicatore per il periodo di ripetizione utilizzato nei nuovi tentativi sulla 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 venga richiesto dall'assistenza clienti. Il suo valore predefinito raramente deve essere modificato.

Specifica il ritardo di logging, in secondi, per gli aggiornamenti di 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 venga richiesto dall'assistenza clienti. Il suo 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.4 (più recente) dell'agente Google Cloud per SAP, consulta la guida alla risoluzione dei problemi di Google Cloud Agent for SAP.

Richiedi assistenza

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