Queste istruzioni mostrano come installare e configurare l'agente Backint di 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 della soluzione SAP HANA su Bare Metal.
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.
Creazione di un bucket Cloud Storage per i backup
Prima di poter configurare l'agente Backint, devi creare un bucket Cloud Storage per conservare i backup.
Per creare un bucket Cloud Storage, utilizza la console Google Cloud.
Per informazioni sulle opzioni dei bucket, consulta Archiviare i backup nei bucket Cloud Storage.
Apri il browser Cloud Storage nella console Google Cloud.
Fai clic su CREA BUCKET.
Assegna un nome al bucket e fai clic su Continua.
Segui le istruzioni per selezionare le opzioni del bucket.
Fai clic su Crea.
Per configurare le autorizzazioni del bucket, fai clic sulla scheda delle autorizzazioni. Per impostazione predefinita, in qualità di proprietario del bucket hai 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 a scalabilità orizzontale di 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 nel deployment, ad esempio /hana/shared
.
Connettiti all'host SAP HANA utilizzando SSH. Se l'host è una VM Compute Engine, dalla pagina Istanze VM puoi fare clic sul pulsante SSH per la tua istanza VM oppure puoi utilizzare il metodo SSH che preferisci.
Passa all'amministratore di sistema SAP HANA.
sudo su - SID_LCadm
Scarica e installa l'agente Backint.
curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh chmod +x install.sh ./install.sh
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 scriptbackint
a meno che non ti venga richiesto dall'assistenza clienti Google Cloud. - Al termine, invia un messaggio che ti indica di aggiornare il fileParameters.txt e di configurare l'autenticazione. Per ulteriori dettagli, consulta Configurazione dell'agente Backint e di SAP HANA.
- Installa l'agente Backint come file JAR in
Se uno dei seguenti scenari si applica al tuo caso, devi creare un account di servizio per l'agente Backint:
- Devi fare in modo che l'agente Backint utilizzi un set di autorizzazioni per le risorse diverso da quello utilizzato dalla VM Compute Engine host.
- SAP HANA è in esecuzione sulla soluzione Bare Metal Solution.
- SAP HANA non è in esecuzione su Google Cloud.
Per creare un account di servizio per l'agente Backint:
Nella console Google Cloud, vai alla pagina Account di servizio.
Selezionare il tuo progetto Google Cloud.
Fai clic su Crea account di servizio.
Specifica un nome per l'account di servizio e, facoltativamente, una descrizione.
Fai clic su Crea e continua.
Fai clic su Continua per creare l'account di servizio senza autorizzazioni.
Se necessario, concedi ad altri utenti l'accesso all'account di servizio.
Fai clic su Fine.
Nella pagina Account di servizio della console Google Cloud, fai clic sull'indirizzo email dell'account di servizio appena creato.
Sotto il nome dell'account di servizio, fai clic sulla scheda Chiavi.
Fai clic sul menu a discesa Aggiungi chiave e seleziona Crea nuova chiave per creare una chiave dell'account di servizio.
Accetta JSON come tipo di chiave e fai clic su Crea. Una chiave privata viene salvata sul computer.
Carica il file della chiave JSON nell'host SAP HANA.
- Archivia il file
.json
in una directory a cui può accedere l'utenteSID_LCadm
, come/usr/sap/SID/home
- Assicurati che l'utente
SID_LCadm
sia autorizzato a leggere il file.
- Archivia il file
Aggiorna il bucket Cloud Storage per concedere all'account di servizio l'autorizzazione per utilizzare il bucket:
Fai clic sul nome del bucket nel browser Cloud Storage.
Fai clic sulla scheda Autorizzazioni.
Fai clic su Aggiungi entità.
Nel campo Nuove entità, inserisci l'indirizzo email completo dell'account di servizio. Ad esempio:
backint-test@my-project.iam.gserviceaccount.com
Fai clic sul menu a discesa Seleziona un ruolo e inserisci Amministratore oggetti Storage.
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 in 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
.
Configura l'agente Backint specificando i parametri nel file
parameters.txt
. Puoi rinominare il file come opportuno.Utilizza il tuo metodo preferito per modificare il file
parameters.txt
. Il file viene installato nella directory seguente./usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
Puoi rinominare il file
parameters.txt
e utilizzare diversi file di configurazione per i backup di dati, log e catalogo.Per le descrizioni dei parametri di configurazione e dei suggerimenti per le prestazioni, consulta Opzioni di configurazione per l'agente Backint.
Specifica il nome del bucket Cloud Storage da utilizzare per i backup.
#BUCKET bucket-name
Se hai creato un account di servizio e una chiave privata per l'agente Backint, specifica il percorso del file della chiave 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 è un commento.#BUCKET hana-backups #DISABLE_COMPRESSION #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json
(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 ignora i proxy HTTP.
Le query al server di metadati dell'istanza devono sempre ignorare il server proxy HTTP. Utilizza i parametri proxy
http
ohttps
, 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 ulteriori informazioni sull'utilizzo dell'agente Backint con un proxy, consulta Proxies e l'agente Backint.
Configura SAP HANA per utilizzare l'agente Backint:
Utilizza SAP HANA Studio o SAP HANA Cockpit per impostare i seguenti parametri nella sezione
backup
del file di configurazioneglobal.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 diverso di backup, specifica i diversi file di configurazione come illustrato 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
Utilizza SAP HANA Studio per specificare lo stesso valore sia per
basepath_catalogbackup
sia perbasepath_logbackup
nella sezionepersistence
del fileglobal.ini
. Ad esempio:
Verifica l'installazione creando un backup nel bucket Cloud Storage ed eseguendo il ripristino dal backup.
Per supportare la funzione di aggiornamento automatico dell'agente Backint, abilita le richieste HTTP remote dalla VM SAP HANA a
https://www.googleapis.com/
.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 è in esecuzione al di fuori di Google Cloud, installa Google Cloud CLI
e configura l'accesso predefinito per l'applicazione utilizzando il comando
gcloud auth application-default login
.
- Se SAP HANA è in esecuzione su una VM di Compute Engine, aggiungi il gestore
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:
Assicurati che nessun backup dei dati sia in corso o pianificato per il periodo che si sovrappone all'aggiornamento.
Disabilita i backup automatici dei log impostando il parametro SAP HANA
enable_auto_log_backup
suno
. Per le istruzioni, consulta il documento SAP HANA Abilita e disabilita il backup automatico dei log.Abilita le richieste HTTP remote dall'host SAP HANA a
https://www.googleapis.com/
.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.
La procedura 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 fileparameters.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 che tu possa tornare alla versione precedente, se necessario.- Installa la nuova versione dell'agente Backint in
Abilita i backup automatici dei log impostando il parametro SAP HANA
enable_auto_log_backup
suyes
. Per le istruzioni, consulta il documento SAP HANA Abilita e disabilita il backup automatico dei log.Monitora il sistema per verificare che i backup vadano a buon fine.
Come tornare a una versione precedente
Se riscontri problemi con una nuova versione dell'agente Backint e il supporto Google Cloud o SAP consiglia di tornare alla versione precedente, puoi farlo modificando il file di script backint
.
Non è necessario rimuovere gli eventuali parametri aggiunti per la nuova versione nel file parameter.txt. La versione precedente dell'agente Backint ignora i parametri della versione più recente.
Per utilizzare il fallback a una versione precedente:
In qualità di
SID_LCadm
, apri lo scriptbackint
per la modifica. Ad esempio:vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint
Modifica il nome del file JAR dell'agente Backint con il nome del file JAR della versione precedente.
Ad esempio, se utilizzi la versione 1.0.6 alla versione 1.0.4, devi modificare:
-jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar
a:-jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar
Apri il file
VERSION.txt
per la modifica e specifica il numero della versione precedente. Devi farlo in modo che il meccanismo di aggiornamento sappia quale versione stai eseguendo.vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt
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.
Richiesta di assistenza per l'agente Backint
Se hai bisogno di aiuto per risolvere un problema con l'agente Backint per SAP HANA, raccogli le informazioni diagnostiche necessarie e contatta l'assistenza clienti Google Cloud. Per ulteriori informazioni, consulta Informazioni diagnostiche dell'agente Backint per SAP HANA.