Risoluzione dei problemi dell'agente Backint per SAP HANA

Se si verificano errori durante l'esecuzione di un backup o di un recupero, i messaggi di errore vengono visualizzati in SAP HANA Studio o SAP HANA Cockpit, quindi controlla prima qui per informazioni sulla causa di un errore. Queste informazioni potrebbero essere visualizzate i file di traccia backup.log e backint.log. Assicurati di selezionare il tipo nome del database quando vengono utilizzati container di database multitenant (MDC).

Assicurati di aver installato l'agente Backint come sidadm utente.

File di log

Se si verificano errori, esamina i seguenti log:

  • SAP HANA backup.log, che contiene informazioni su SAP HANA le operazioni di backup e ripristino.
  • SAP HANA backint.log, che contiene le chiamate al backup utilizzata dall'agente Backint e da altri strumenti di backup esterni.
  • File di log dell'agente Backint, che contengono l'agente Backint di installazione e operazioni. I file di log dell'agente Backint si trovano in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. I log dell'agente Backint possono includere indicazioni di errori di comunicazione con Cloud Storage e problemi di configurazione o autorizzazioni correlati.
  • I log di Google Cloud, che possono contenere gli errori relativi all'account di servizio usato Agente Backint. Per esaminare i log di Google Cloud, consulta la pagina Esplora log nella console Google Cloud.

Controlla anche le informazioni sull'I/O del disco e della rete sull'host SAP HANA per verificare l'attività.

Per ulteriori informazioni sul logging dell'agente Backint, consulta Logging per l'agente Backint.

Problemi di connettività

Se l'agente Backint non riesce a connettersi a Cloud Storage un bucket, rivedi i passaggi di configurazione. In particolare, controlla i seguenti elementi:

  • Riprova a eseguire il backup o il ripristino non riusciti per assicurarti che l'errore non sia stato un problema temporaneo di connettività.
  • Se utilizzi l'account di servizio della VM host con l'agente Backint, l'ambito di accesso per Storage è indicato come Lettura/scrittura in Ambiti di accesso API di Cloud nella pagina Dettagli istanza VM della console Google Cloud. In caso contrario, arresta l'istanza e modifica l'ambito di accesso.
  • Se hai creato un account di servizio per l'agente Backint:
    • Nella scheda Autorizzazioni della pagina Dettagli bucket della console Google Cloud, verifica che l'account di servizio agente Backint sia elencato e che abbia il ruolo Amministratore oggetti Storage.
    • Verifica di aver creato una chiave privata, di averla memorizzata sull'host SAP HANA e di aver specificato correttamente il percorso del file della chiave JSON nel file di configurazione dell'agente Backint,/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
  • Tutti i parametri sono specificati correttamente in entrambi i campi parameters.txt File di configurazione dell'agente Backint e file SAP HANA global.ini.

Puoi testare l'accesso al bucket Cloud Storage da SAP HANA utilizzando Google Cloud CLI. Utilizzando l'interfaccia a riga di comando gcloud, salva e accedi a un file di testo nel bucket Cloud Storage:

  1. Se non utilizzi l'account di servizio predefinito, esegui l'autenticazione su Google Cloud come utente autorizzato al bucket Cloud Storage o all'account di servizio dell'agente Backint: 

    gcloud auth login user-account
     In alternativa: 
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
     Per ulteriori informazioni sull'autenticazione di Cloud Storage di un account di servizio, consulta Autenticazione della CLI gcloud.

  2. Verifica di poter elencare gli oggetti archiviati nel bucket: 

    gcloud storage ls gs://bucket/

  3. Crea un file di test: 

    touch test.txt

  4. Verifica di poter scrivere il file di test nel bucket: 

    gcloud storage cp test.txt gs://bucket/test.txt

  5. Conferma di poter leggere il file di test nel bucket: 

    gcloud storage cp gs://bucket/test.txt

Bassa velocità effettiva

Se il throughput è inferiore alle aspettative, verifica che la compressione sia disattivata.

Per disattivare la compressione, aggiungi il flag #DISABLE_COMPRESSION al file parameters.txt dell'agente Backint.

Errori di multistreaming

Se si verificano errori durante il multistreaming, modifica il numero di stream in uno (1) per vedere se l'errore è correlato al numero di stream.

Per ulteriori informazioni sul logging dell'agente Backint, consulta Multistreaming i backup dei dati con l'agente Backint.