Guida all'installazione dell'agente Backint di Cloud Storage per SAP HANA

Importante: per le nuove installazioni, anziché utilizzare l'agente Backint Cloud Storage per SAP HANA, ti consigliamo di utilizzare il suo successore, l'agente di Google Cloud per SAP. Dalla versione 3.0, l'agente per SAP di Google Cloud combina la raccolta delle metriche di Agente host SAP con altre funzionalità come il backup e il ripristino basati su Backint per SAP HANA.

Se utilizzi l'agente Backint, ti consigliamo di passare prima alla versione 3.2 (più recente) dell'agente per SAP di Google Cloud, ma prima che l'assistenza venga interrotta per l'agente Backint. Per istruzioni sull'upgrade, consulta la pagina relativa all'upgrade all'agente Google Cloud per SAP da altri agenti Google Cloud.

Il supporto per l'agente Backint termina a febbraio 2025. Questo agente non è supportato sui tipi di macchine di Compute Engine che sono diventati in disponibilità generale (GA) dopo febbraio 2024.

Queste istruzioni mostrano come installare e configurare l'agente Backint Cloud Storage per SAP HANA (agente Backint).

Per informazioni sulle opzioni di configurazione dell'agente Backint, consulta la panoramica dell'agente Backint di Cloud Storage per SAP HANA.

Prerequisiti

Prima di poter installare l'agente Backint, devi installare SAP HANA. Per installare SAP HANA su Google Cloud, consulta la Guida al deployment di SAP HANA.

Per informazioni sull'installazione di SAP HANA su Bare Metal Solution, consulta la Guida alla pianificazione di SAP HANA su Bare Metal Solution.

Se la VM host non ha accesso a internet, devi configurare l'accesso privato Google in modo che l'agente Backint possa accedere alle API Google Cloud. Per configurare l'accesso privato Google, consulta Configurazione dell'accesso privato Google.

Nota: se devi installare l'agente Backint su un host che non è una macchina virtuale (VM) Compute Engine o una macchina bare metal Solution Bare Metal Solution, crea un incidente con il supporto SAP nel componente BC-OP-LNX-GOOGLE in modo che SAP e Google Cloud possano valutare la tua configurazione.

Creazione di un bucket Cloud Storage per i backup

Prima di poter configurare l'agente Backint, devi creare un bucket Cloud Storage in cui inserire i backup.

Per creare un bucket Cloud Storage, utilizza la console Google Cloud.

Per informazioni sulle opzioni dei bucket, consulta Archiviazione dei backup nei bucket Cloud Storage.

1. Apri il browser Cloud Storage nella console Google Cloud.

   Apri il browser Cloud Storage

2. Fai clic su CREA BUCKET.

3. Assegna un nome al bucket e fai clic su Continua.

4. Segui le istruzioni per selezionare le opzioni del bucket.

   Nota: le opzioni di crittografia presentate nella console Google Cloud durante la creazione dei bucket si applicano in genere agli oggetti at-rest nel bucket. L'agente Backint fornisce opzioni di crittografia aggiuntive per i backup indipendenti dalle opzioni di crittografia del bucket.

5. Fai clic su Crea.

6. Per configurare le autorizzazioni del bucket, fai clic sulla scheda delle autorizzazioni. Per impostazione predefinita, in qualità di proprietario del bucket, disponi dell'accesso in lettura e scrittura al bucket. Puoi anche consentire ad altre entità di accedere al tuo bucket.

Installazione dell'agente Backint sull'host SAP HANA

L'agente Backint è installato nello stesso file system condiviso del database SAP HANA.

In un deployment con scale out SAP HANA, installa l'agente Backint su ciascun nodo del sistema SAP HANA. Per semplificare l'amministrazione, puoi archiviare i file di configurazione in una posizione condivisa accessibile a tutti i nodi del deployment, ad esempio /hana/shared.

1. Connettiti al tuo host SAP HANA tramite SSH. Se il tuo host è una VM di Compute Engine, nella pagina Istanze VM 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
   

3. Scarica e installa l'agente Backint.

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Nota: se stai aggiornando un'istanza esistente dell'agente Backint a una nuova versione, segui le istruzioni riportate in Aggiornamento dell'agente Backint a una nuova versione.

   Lo script install.sh esegue le seguenti azioni:

   • Installa l'agente Backint come file JAR in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Scarica una versione compatibile di Java Runtime Environment.
   • Configura lo script backint che richiama l'agente Backint. Non modificare lo script backint a meno che non ti venga richiesto di farlo dall'assistenza clienti Google Cloud.
   • Al termine, visualizza un messaggio che richiede di aggiornare il file parameter.txt e di configurare l'autenticazione. Per ulteriori dettagli, consulta Configurazione dell'agente Backint e di SAP HANA.

4. Se uno dei seguenti scenari si applica al tuo caso, devi creare un account di servizio per l'agente Backint:

   • È necessario che l'agente Backint utilizzi un insieme di autorizzazioni per le risorse diverso da quello utilizzato dalla VM Compute Engine host.
   • SAP HANA è in esecuzione su Bare Metal Solution.
   • SAP HANA non è in esecuzione su Google Cloud.

   Per creare un account di servizio per l'agente Backint:

   1. Nella console Google Cloud, vai alla pagina Account di servizio.

      Vai alla pagina Account di servizio

   2. Selezionare il tuo progetto Google Cloud.

   3. Fai clic su Crea account di servizio.

   4. Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.

   5. Fai clic su Crea e continua.

   6. Fai clic su Continua per creare l'account di servizio senza autorizzazioni.

   7. Se necessario, concedi ad altri utenti l'accesso all'account di servizio.

   8. Fai clic su Fine.

   9. Nella pagina Account di servizio nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio appena creato.

   10. Sotto il nome dell'account di servizio, fai clic sulla scheda Chiavi.

   11. Fai clic sul menu a discesa Aggiungi chiave, quindi seleziona Crea nuova chiave per creare una chiave dell'account di servizio.

   12. Accetta JSON come tipo di chiave e fai clic su Crea. Una chiave privata viene salvata sul tuo computer.

5. Carica il file della chiave JSON nell'host SAP HANA.

   • Archivia il file .json in una directory a cui può accedere l'utente SID_LCadm, ad esempio /usr/sap/SID/home
   • Assicurati che l'utente SID_LCadm sia autorizzato a leggere il file.

6. Aggiorna il bucket Cloud Storage per concedere all'account di servizio l'autorizzazione a utilizzare il bucket:

   1. Fai clic sul nome del bucket nel browser Cloud Storage.

      Apri il browser Cloud Storage

   2. Fai clic sulla scheda Autorizzazioni.

   3. Fai clic su Aggiungi entità.

   4. Nel campo Nuove entità, inserisci l'indirizzo email completo dell'account di servizio. Ad esempio:

      [e-mail]

   5. Fai clic sul menu a discesa Seleziona un ruolo e inserisci Amministratore oggetti Storage.

   6. Fai clic su Salva.

Configurazione dell'agente Backint e di SAP HANA

Puoi configurare l'agente Backint specificando i parametri in un file di configurazione di testo normale.

Puoi utilizzare la stessa configurazione unica per tutti i tipi di backup (dati, log e catalogo) oppure puoi utilizzare una configurazione diversa per ogni tipo di backup creando un file di configurazione separato per ciascuno.

Puoi specificare il percorso di ogni file di configurazione dell'agente Backint in SAP HANA specificando i parametri nel file global.ini.

1. Configura l'agente Backint specificando i parametri nel file parameters.txt. Puoi rinominare il file in base alle tue esigenze.

   1. Utilizza il tuo metodo preferito per modificare il file parameters.txt. Il file viene installato nella seguente directory.

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

      Puoi rinominare il file parameters.txt e utilizzare file di configurazione diversi per backup di dati, log e cataloghi.

      Per descrizioni dei parametri di configurazione e suggerimenti sulle prestazioni, consulta Opzioni di configurazione per l'agente Backint.

   2. Specifica il nome del bucket Cloud Storage da utilizzare per i backup.

      #BUCKET bucket-name
      

   3. Se hai creato un account di servizio e una chiave privata per l'agente Backint, specifica il percorso del file di chiavi JSON.

      #SERVICE_ACCOUNT /path/key-file-name.json

   L'esempio seguente mostra i contenuti di un file parameters.txt valido. Tieni presente che # nell'esempio fa parte della sintassi e non significa che la riga sia un commento.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. (Facoltativo) Configura l'agente Backint in modo che ignori o utilizzi un proxy per i backup e i recuperi. Per impostazione predefinita, l'agente Backint aggira i proxy HTTP.

   Avviso: il routing dei backup tramite un proxy influisce negativamente sulle prestazioni e sull'affidabilità di tutto il traffico proxy durante l'invio o il recupero dei backup da Cloud Storage. Google Cloud consiglia vivamente che l'agente Backint ignori i proxy HTTP.

   Le query al server dei metadati dell'istanza devono sempre ignorare il server proxy HTTP. Utilizza i parametri proxy http o https come richiesto dal server proxy.

   Per specificare le impostazioni del server proxy per l'agente Backint, modifica il file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

   Ad esempio, la seguente configurazione specifica un server proxy HTTPS:

   http.proxyHost=proxy-host
   http.proxyPort=proxy-port
   http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
   https.proxyHost=proxy-host
   https.proxyPort=proxy-port
   

   Per saperne di più sull'utilizzo dell'agente Backint con un proxy, consulta la pagina relativa ai proxy e all'agente Backint.

3. Configura SAP HANA per utilizzare l'agente Backint:

   1. Utilizza SAP HANA Studio o SAP HANA Cockpit per impostare i seguenti parametri nella sezione backup del file di configurazione global.ini sui valori mostrati nella tabella. Non è necessario riavviare SAP HANA dopo aver apportato queste modifiche.

      Se utilizzi un file di configurazione diverso per ogni tipo di backup, specifica i diversi file di configurazione come mostrato nella seguente tabella. Altrimenti, specifica lo stesso file di configurazione per tutti i tipi.

      Parametro	Valore
      catalog_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint	true
      data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint	true

   2. Utilizza SAP HANA Studio per specificare lo stesso valore per basepath_catalogbackup e basepath_logbackup nella sezione persistence del file global.ini. Ad esempio:

      

4. Testa l'installazione creando un backup nel bucket Cloud Storage e ripristinandolo dal backup.

5. Per supportare la funzione di aggiornamento automatico dell'agente Backint, abilita le richieste HTTP remote dalla VM SAP HANA a https://www.googleapis.com/.

6. Facoltativamente, abilita Cloud Logging.

   • Se SAP HANA è in esecuzione su una VM di Compute Engine, aggiungi il gestore com.google.cloud.logging.LoggingHandler alla proprietà com.google.cloud.partners.handlers nel file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties.
   • Se SAP HANA viene eseguito al di fuori di Google Cloud, installa Google Cloud CLI e configura l'accesso predefinito dell'applicazione utilizzando il comando gcloud auth application-default login.

Aggiornamento dell'agente Backint a una nuova versione

Prima di aggiornare l'agente Backint a una nuova versione nell'ambiente di produzione, assicurati di testare la nuova versione in un ambiente non di produzione. Per informazioni su cosa offre una versione dell'agente Backint, consulta le note di rilascio per quella versione.

Per aggiornare l'agente Backint a una nuova versione:

1. Assicurati che non siano in corso o pianificati backup dei dati per il periodo che si sovrappone all'aggiornamento.

2. Disabilita i backup automatici dei log impostando il parametro enable_auto_log_backup SAP HANA su no. Per le istruzioni, consulta il documento SAP HANA Abilitare e disabilitare il backup automatico dei log.

3. Abilita le richieste HTTP remote dall'host SAP HANA a https://www.googleapis.com/.

4. Come SID_LCadm, sull'host SAP HANA, installa la nuova versione:

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   Lo script update.sh esegue le seguenti azioni:

   • Installa la nuova versione dell'agente Backint in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Aggiorna lo script backint per richiamare la nuova versione dell'agente Backint.
   • Aggiorna il numero di versione in VERSION.txt.
   • Archivia lo script update.sh localmente in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Invia un messaggio al termine dell'operazione.

   Il processo di aggiornamento non modifica né sostituisce il file parameters.txt esistente. Per utilizzare le nuove opzioni introdotte nella nuova versione, devi aggiungere i parametri corrispondenti al file parameters.txt esistente.

   Il processo di aggiornamento lascia la versione precedente dell'agente Backint nella directory /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs, in modo da poter tornare alla versione precedente, se necessario.

5. Abilita i backup automatici dei log impostando il parametro enable_auto_log_backup per SAP HANA su yes. Per le istruzioni, consulta il documento SAP HANA Abilitare e disabilitare il backup automatico dei log.

6. Monitora il sistema per verificare che i backup siano andati a buon fine.

Ritorno a una versione precedente

Se riscontri problemi con una nuova versione dell'agente Backint e l'assistenza di Google Cloud o SAP ti consiglia di utilizzare la versione precedente, puoi farlo modificando il file di script backint.

Non è necessario rimuovere i parametri che potresti aver aggiunto per la nuova versione nel file parameter.txt. La versione precedente dell'agente Backint ignora i parametri della versione più recente.

Per tornare a una versione precedente:

1. Come SID_LCadm, apri lo script backint per modificarlo. Ad esempio:

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint

2. Modifica il nome del file JAR dell'agente Backint con il nome del file JAR della versione precedente.

   Ad esempio, se torni dalla versione 1.0.6 alla versione 1.0.4, modificherai:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar

   to:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

3. Apri il file VERSION.txt da modificare e specifica il numero della versione precedente. Devi eseguire questa operazione in modo che il meccanismo di aggiornamento sappia quale versione è in esecuzione.

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt

4. Testa l'agente Backint attivando un backup.

Risoluzione dei problemi

Per risolvere i problemi relativi all'agente Backint per SAP HANA, consulta Risoluzione dei problemi dell'agente Backint per SAP HANA.

Richiedere assistenza per l'agente Backint

Se hai bisogno di aiuto per risolvere un problema con l'agente Backint per SAP HANA, raccogli le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta Informazioni diagnostiche sull'agente Backint per SAP HANA.