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 nei file di traccia backup.log e backint.log. Assicurati di selezionare il nome del database pertinente quando vengono utilizzati contenitori di database multi-tenant (MDC).

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

File di log

Se si verificano errori, esamina i seguenti log:

  • SAP HANA backup.log, che contiene informazioni sulle operazioni di backup e recupero di SAP HANA.
  • SAP HANA backint.log, che contiene le chiamate all'interfaccia di backup utilizzata dall'agente Backint e da altri strumenti di backup esterni.
  • File di log dell'agente Backint, che contengono gli eventi di installazione e operativi dell'agente Backint. 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 errori relativi all'account di servizio utilizzato dall'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 al bucket Cloud Storage, rivedi i passaggi di configurazione. In particolare, controlla i seguenti elementi:

  • Riprova il backup o il ripristino non riuscito per assicurarti che l'errore non sia stato solo un problema di connettività momentaneo.
  • 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 sia nel file di configurazione dell'agente Backint sia nel file global.ini di SAP HANA.parameters.txt

Puoi testare l'accesso al bucket Cloud Storage dall'host SAP HANA utilizzando Google Cloud CLI. Utilizzando gcloud CLI, 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. Verifica 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 ricevi errori durante il multistreaming, imposta il numero di stream su 1 per verificare se l'errore è correlato al numero di stream.

Per ulteriori informazioni sul logging dell'agente Backint, consulta Backup dei dati con multistreaming con l'agente Backint.