Questa pagina è stata tradotta dall'API Cloud Translation.

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

Importante: per le nuove installazioni, anziché utilizzare l'agente Backint di Cloud Storage per SAP HANA, ti consigliamo di usare la versione successiva, Agente di Google Cloud per SAP. A partire dalla versione 3.0, Agent for SAP di Google Cloud combina la raccolta delle metriche di SAP Host Agent con altre come il backup e il ripristino basati su Backint per SAP HANA.

Se utilizzi l'agente Backint, ti consigliamo di passare all'utilizzo versione 3.4 (più recente) dell'Agente per SAP di Google Cloud non appena possibile, ma prima dell'interruzione del supporto per l'agente Backint. Per upgrade istruzioni, vedi Esegui l'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 supportati sui tipi di macchine di Compute Engine che sono diventati generalmente disponibile (GA) dopo febbraio 2024.

Queste istruzioni mostrano come installare e configurare 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 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 Deployment di SAP HANA Google Cloud.

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

Se la VM host non ha accesso a internet, devi configurare 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, è necessario per creare un bucket Cloud Storage in cui conservare 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.

Apri il browser Cloud Storage nella console Google Cloud.

Apri il browser di Cloud Storage
Fai clic su CREA BUCKET.
Assegna un nome al bucket e fai clic su Continua.
Segui le istruzioni per selezionare le opzioni del bucket.

Nota: le opzioni di crittografia presentate nella console Google Cloud durante la creazione di bucket si applica in genere agli oggetti inattivi nel bucket. La L'agente Backint fornisce opzioni di crittografia aggiuntive per indipendenti dalle opzioni di crittografia del bucket.
Fai clic su Crea.
Per configurare le autorizzazioni del bucket, fai clic sulla scheda delle autorizzazioni. Per impostazione predefinita, come proprietario del bucket, devi l'accesso in lettura/scrittura al bucket. Puoi anche consentire ad altre entità di per accedere al bucket.

Installazione dell'agente Backint sull'host SAP HANA

L'agente Backint viene installato nello stesso condiviso come database SAP HANA.

In un deployment a scalabilità orizzontale di SAP HANA, installa l'agente Backint su ogni nodo del sistema SAP HANA. Per semplificare l'amministrazione, puoi archiviare di configurazione in una posizione condivisa accessibile a tutti nodi nel deployment, ad esempio /hana/shared.

Connettiti all'host SAP HANA utilizzando SSH. Se l'host è un VM di Compute Engine, dalla pagina Istanze VM: puoi fare clic sul pulsante SSH per la tua istanza VM oppure puoi utilizzare metodo SSH preferito.
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
```
Nota: se stai aggiornando un'istanza esistente dell'agente Backint a una nuova versione, segui le istruzioni riportate in Aggiornare il Esegui il rollback dell'agente 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 dall'assistenza clienti Google Cloud.
- Al termine, invia un messaggio che indica di aggiornare il fileParameters.txt e configurare l'autenticazione. Consulta Configurazione dell'agente Backint e di SAP HANA per ulteriori dettagli.
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 insieme diverso rispetto a quelle utilizzate 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:
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 della 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 e seleziona Crea nuova chiave per creare una chiave dell'account di servizio.
12. Accetta JSON come tipo di chiave e fai clic su Crea. Un privato viene salvato sul computer.
Carica il file della chiave JSON nell'host SAP HANA.
- Archivia il file .json in una directory in cui SID_LCadm utente può accedere, ad esempio /usr/sap/SID/home
- Assicurati che l'utente SID_LCadm sia autorizzato per leggere il file.
Aggiorna il bucket Cloud Storage per concedere l'account di servizio per 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 l'account di servizio. Ad esempio:
  
  backint-test@my-project.iam.gserviceaccount.com
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 modo semplice di configurazione del testo di Google.

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.

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

Configura l'agente Backint specificando i parametri nel campo parameters.txt. Puoi rinominare il file come appropriato.
1. Utilizza il tuo metodo preferito per modificare parameters.txt. Il file è 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 i backup di dati, log e catalogo.
  
  Per le descrizioni dei parametri di configurazione e delle prestazioni vedi Opzioni di configurazione per l'agente Backint.
2. Specifica il nome del bucket Cloud Storage da utilizzare per backup.
```
#BUCKET bucket-name
```
3. Se hai creato un account di servizio e una chiave privata l'agente Backint, specifica il percorso del file chiave JSON.
```
#SERVICE_ACCOUNT /path/key-file-name.json
```
L'esempio seguente mostra il contenuto di un modello parameters.txt. Tieni presente che il valore # nel 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) Configurare l'agente Backint per bypassare o utilizzare un per backup e recuperi. Per impostazione predefinita, l'agente Backint ignora i proxy HTTP.

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

Le query al server di metadati dell'istanza devono sempre ignorare il protocollo HTTP un server proxy. Utilizza i parametri del 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 ulteriori informazioni sull'uso 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 quanto segue nella sezione backup della configurazione global.ini ai valori mostrati nella tabella. Non è necessario riavviare SAP HANA dopo aver apportato queste modifiche.

Se utilizzi un file di configurazione diverso per ogni backup, specifica i diversi file di configurazione come mostrato nella tabella seguente. In caso contrario, 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 per entrambi basepath_catalogbackup e basepath_logbackup in persistence del file global.ini. Ad esempio:

Testa l'installazione creando un backup in Cloud Storage un bucket Cloud Storage e il ripristino dal backup.
Per supportare la funzione di aggiornamento automatico dell'agente Backint, abilita 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 com.google.cloud.logging.LoggingHandler al gestore com.google.cloud.partners.handlers proprietà nel /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 configurare l'accesso predefinito per l'applicazione utilizzando gcloud auth application-default login .

Aggiornamento dell'agente Backint a una nuova versione

Prima di aggiornare l'agente Backint a una nuova versione in produzione assicurati di testare la nuova versione in un ambiente non di produzione. Per informazioni su quale versione all'agente Backint, vedi 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 sovrappongono all'aggiornamento.
Disabilita i backup automatici dei log impostando il parametro SAP HANA enable_auto_log_backup su no. Per istruzioni, consulta la documentazione SAP Documento HANA Attiva e disattiva il backup automatico dei log.
Abilita le richieste HTTP remote dall'host SAP HANA per https://www.googleapis.com/.
Come SID_LCadm, sull'host SAP HANA, installa la nuova versione 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 il nuovo agente Backint completamente gestita.
- 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 le impostazioni esistenti parameters.txt. Per utilizzare nuove opzioni nella nuova versione, devi aggiungere i parametri corrispondenti al file parameters.txt esistente.

Il processo di aggiornamento lascia la versione precedente dell'agente Backint nel /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs in modo da poter utilizzare la versione precedente, se necessario.
Abilita i backup automatici dei log impostando il parametro SAP HANA enable_auto_log_backup su yes. Per istruzioni, consulta la documentazione SAP Documento HANA Attiva e disattiva il backup automatico dei log.
Monitora il sistema per verificare che i backup vadano a buon fine.

Come tornare a una versione precedente

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

Non è necessario rimuovere gli eventuali parametri aggiunti per nuova versione nel fileParameters.txt. La versione precedente L'agente Backint ignora i parametri della versione più recente.

Per utilizzare una versione di riserva:

In qualità di SID_LCadm, apri lo script backint per 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 JAR della versione precedente.

Ad esempio, se si esegue il fallback dalla versione 1.0.6 alla versione 1.0.4, cambieresti:
```
-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 la versione precedente numero. Affinché il meccanismo di aggiornamento sappia quale versione che 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 richieste e contatta l'assistenza clienti Google Cloud. Per ulteriori informazioni, consulta Informazioni diagnostiche dell'agente Backint per SAP HANA.