Questa guida mostra come risolvere i problemi relativi alla versione 3.2 (più recente) dell'agente per SAP di Google Cloud.
Per informazioni sulla risoluzione dei problemi e sull'assistenza da SAP, consulta le seguenti note SAP:
- 1642148 - Domande frequenti: backup e ripristino dei database SAP HANA
- 2031547 - Panoramica degli strumenti di backup di terze parti certificati SAP e del processo di assistenza associato
- 2705632 - Procedura di assistenza per Google Cloud Storage
Logging
Controlla i log nella directory specifica per il tuo sistema operativo.
Per visualizzare i log per l'agente per SAP di Google Cloud, vai ai seguenti percorsi:
Linux
/var/log/google-cloud-sap-agent.log
Windows
C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log
Visualizza i log correlati a Backint
Se hai abilitato la funzionalità Backint dell'agente per SAP di Google Cloud, esamina i seguenti log:
- Il file
backup.log
di SAP HANA, che contiene informazioni sulle operazioni di backup e ripristino di SAP HANA. - Il file
backint.log
SAP HANA, che contiene le chiamate all'interfaccia di backup utilizzata dalla funzionalità Backint dell'agente e da altri strumenti di backup esterni. - Il file di log Backint dell'agente per SAP di Google Cloud:
/var/log/google-cloud-sap-agent/backint.log
. Questo file include informazioni su quando è stata abilitata la funzionalità Backint, sui relativi eventi operativi e indicazioni sugli errori di comunicazione con Cloud Storage e sui relativi problemi di configurazione o autorizzazioni. - I log di Google Cloud in Cloud Logging, che possono contenere errori relativi all'account di servizio utilizzato dall'agente per SAP di Google Cloud. Per visualizzare questi log, nella console Google Cloud vai alla pagina Esplora log.
Problemi comuni
Le seguenti sezioni forniscono informazioni sui problemi comuni relativi all'utilizzo dell'agente per SAP di Google Cloud, le relative cause e soluzioni.
Problema: autorizzazioni IAM insufficienti
Problema: i log dell'agente per SAP di Google Cloud mostrano l'errore di autorizzazioni IAM insufficienti.
Causa: l'account di servizio utilizzato dall'agente non dispone delle autorizzazioni IAM necessarie per accedere all'API Cloud Monitoring oppure, se stai utilizzando la funzionalità Backint dell'agente, non dispone delle autorizzazioni sufficienti per accedere al bucket Cloud Storage.
Soluzione:per risolvere il problema, svolgi i seguenti passaggi:
Nella pagina dei dettagli dell'istanza VM della console Google Cloud, prendi nota del nome dell'account di servizio VM. Ad esempio:
sap-example@example-project-123456.iam.gserviceaccount.com
.Vai alla pagina IAM e amministrazione e, per l'account di servizio indicato, assicurati che includa i seguenti ruoli IAM:
Funzionalità Ruoli IAM obbligatori Raccolta delle metriche dell'agente host SAP Raccolta delle metriche di monitoraggio dei processi - Visualizzatore Compute
(
roles/compute.viewer
) - Writer metriche Monitoring (
roles/monitoring.metricWriter
) -
Funzione di accesso ai secret di Secret Manager
(
roles/secretmanager.secretAccessor
)
(richiesto quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Raccolta di metriche di valutazione del Gestore carichi di lavoro - Visualizzatore Compute
(
roles/compute.viewer
) -
Writer insight gestore carichi di lavoro
(
roles/workloadmanager.insightWriter
) -
Funzione di accesso ai secret di Secret Manager (
roles/secretmanager.secretAccessor
)
(Obbligatorio quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Raccolta delle metriche di monitoraggio SAP HANA - Visualizzatore Compute
(
roles/compute.viewer
) - Writer metriche Monitoring (
roles/monitoring.metricWriter
) -
Funzione di accesso ai secret di Secret Manager (
roles/secretmanager.secretAccessor
)
(Obbligatorio quando utilizzi Secret Manager per autenticare l'account utente del database per SAP HANA).
Backup e ripristino basati su backint per SAP HANA - Amministratore oggetti Storage (
roles/storage.objectAdmin
) - Autore crittografia/decrittografia CryptoKey Cloud KMS
(
roles/cloudkms.cryptoKeyEncrypterDecrypter
), se hai utilizzato una chiave di crittografia gestita dal cliente per criptare i tuoi backup di SAP HANA in Cloud Storage. Per informazioni su questa funzionalità, consulta Opzioni di crittografia per i backup.
Per maggiori informazioni, consulta Autorizzazioni Cloud Storage richieste.
- Visualizzatore Compute
(
Per ulteriori informazioni sull'autenticazione richiesta per l'agente di Google Cloud per SAP, consulta Autenticazione e accesso.
Per confermare le autorizzazioni richieste dall'agente Cloud Monitoring, consulta la seguente documentazione di Monitoring:
Problema: Ambiti di accesso non corretti per l'account di servizio VM
Problema: se limiti gli ambiti di accesso sull'istanza VM host, i log dell'agente per SAP di Google Cloud potrebbero mostrare un errore di autorizzazioni IAM insufficienti.
Causa: l'agente per SAP di Google Cloud richiede ambiti di accesso all'API Cloud minimi sull'istanza VM host. Questo errore si verifica quando l'account di servizio non dispone degli ambiti di accesso richiesti.
Risoluzione: gli ambiti di accesso sono il metodo precedente per specificare le autorizzazioni per l'istanza VM. Compute Engine consiglia di configurare le istanze VM in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM dell'account di servizio VM per controllare l'accesso alle risorse Google Cloud.
Per risolvere il problema, come best practice, imposta l'intero ambito di accesso cloud-platform
sull'istanza VM, quindi limita in modo sicuro l'accesso API dell'account di servizio con i ruoli IAM. Ad esempio:
https://www.googleapis.com/auth/cloud-platform
Se limiti gli ambiti di accesso dell'istanza VM, devi assicurarti che l'istanza VM host abbia i seguenti ambiti di accesso:
https://www.googleapis.com/auth/source.read_write
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/servicecontrol
https://www.googleapis.com/auth/service.management.readonly
https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/devstorage.full_control
Se hai abilitato la raccolta delle metriche di monitoraggio dei processi o di SAP HANA, anche gli ambiti di accesso dell'istanza VM host devono disporre dell'accesso in scrittura per pubblicare i dati delle metriche nel tuo progetto Google Cloud:
https://www.googleapis.com/auth/monitoring.write
Per modificare gli ambiti di accesso, devi arrestare l'istanza VM, apportare le modifiche, quindi riavviare l'istanza VM. Per le istruzioni, consulta la documentazione di Compute Engine. Per questo problema, non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM.
Problema: Agente host SAP mancante o errato
Problema: i log dell'agente per SAP di Google Cloud mostrano un errore di SAP Host Agent mancante o non corretto.
Causa:l'agente host SAP o il livello di patch minimo richiesto per l'agente host SAP non è installato. Affinché l'agente di Google Cloud per SAP funzioni, nel sistema SAP deve essere installato l'agente host SAP e viene mantenuto il livello minimo di patch richiesto per l'agente host.
Soluzione: per risolvere il problema, installa la versione richiesta dell'agente host SAP. Per istruzioni su come installare l'agente host SAP, consulta la documentazione su SAP.
Per i requisiti di versione per l'agente host SAP, consulta le seguenti note SAP:
- Linux: nota SAP 2460297 - SAP su Linux su Google Cloud Platform: monitoraggio avanzato
- Windows: nota SAP 1409604 - Virtualizzazione su Windows: monitoraggio avanzato
Problema: installazione dell'agente di Google Cloud per SAP non riuscita
Problema: l'installazione dell'agente non riesce quando viene eseguito il comando di installazione del
gestore di pacchetti (yum
, zypper
o googet
).
Causa:l'installazione dell'agente non riesce perché il server host che è in esecuzione l'agente è stato creato senza un indirizzo IP esterno.
Soluzione: per risolvere il problema, configura un gateway NAT che fornisca al server host l'accesso in uscita a internet. Per informazioni su come configurare un gateway NAT, consulta la guida al deployment per il tuo sistema SAP. Ad esempio, per SAP NetWeaver, consulta:
- Configurazione di un gateway NAT su un'istanza VM di Compute Engine
- Guida per il deployment di SAP NetWeaver su Linux
- Guida al deployment di SAP NetWeaver su Windows
Problema: raccolta delle metriche di monitoraggio SAP HANA non riuscita
Problema: durante l'upgrade dall'agente di monitoraggio per SAP HANA, dopo aver installato l'agente di Google Cloud per SAP, viene visualizzato un messaggio di errore simile al seguente:
tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead
Causa:l'agente di Google Cloud per SAP non può avviare la raccolta delle metriche di monitoraggio SAP HANA perché le istanze SAP HANA di destinazione utilizzano i certificati SSL specificati con Common Name (CN).
Soluzione:per risolvere il problema, completa la procedura seguente:
Per le istanze SAP HANA che vuoi monitorare utilizzando l'agente di Google Cloud per SAP, devi passare a un certificato SSL SAN (Subject Alternative Name) anziché a certificati SSL specificati con il nome comune (CN).
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Apri il file di configurazione dell'agente per SAP di Google Cloud:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sutrue
.Nella sezione
hana_monitoring_configuration.hana_instances
, esegui le operazioni seguenti per ogni istanza SAP HANA che utilizza il protocollo TLS/SSL per le comunicazioni sicure:Specifica il parametro
enable_ssl
e impostane il valore sutrue
.Specifica il parametro
host_name_in_certificate
e imposta come valore il nome host SAP HANA, come specificato nel certificato TLS/SSL.Specifica il parametro
tls_root_ca_file
e imposta il percorso in cui è archiviato il certificato TLS/SSL.
Salva il file di configurazione.
Riavvia l'agente Google Cloud per SAP per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Verifica che l'agente stia raccogliendo le metriche di monitoraggio SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.
Disinstalla l'agente di monitoraggio per SAP HANA.
Problema: errore di connessione rifiutata
Problema:i log dell'agente host SAP mostrano l'errore di connessione rifiutata.
Causa:l'agente Google Cloud per SAP non può essere avviato perché la porta 18181
non è disponibile. L'agente di Google Cloud per SAP rimane in ascolto delle richieste sulla porta 18181
.
Questa porta deve essere disponibile per consentire l'avvio dell'agente.
Soluzione: per risolvere il problema, assicurati che la porta 18181
sia disponibile per l'agente di Google Cloud per SAP. Se un altro servizio utilizza la porta 18181
, potrebbe essere necessario riavviare l'altro servizio o riconfigurarlo in modo che utilizzi un'altra porta.
Problema: per le immagini sistema operativo SLES 15 SP4 per SAP e versioni successive, l'agente per SAP di Google Cloud non è in esecuzione
Problema: quando utilizzi le immagini sistema operativo SLES "for SAP", l'agente per SAP di Google Cloud è preinstallato. Tuttavia, per le immagini sistema operativo SLES 15 SP4 per SAP e versioni successive, l'Agente per SAP preinstallato non si avvia da solo.
Per verificare che l'agente sia in esecuzione o meno:
- Connettiti all'istanza VM host o al server Bare Metal Solution.
Esegui questo comando:
systemctl status google-cloud-sap-agent
Se l'agente non è in esecuzione, l'output contiene
inactive (dead)
. Ad esempio:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled) Active: inactive (dead)
Causa: l'agente per SAP non si avvia da solo a causa di un problema con la pacchettizzazione del sistema operativo.
Soluzione: per risolvere il problema, svolgi i seguenti passaggi:
- Connettiti all'istanza VM host o al server Bare Metal Solution.
Esegui questi comandi:
sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service sudo systemctl restart google-cloud-sap-agent
Verifica che l'agente sia in esecuzione:
systemctl status google-cloud-sap-agent
Dovresti vedere un output simile al seguente:
google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled) Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago Main PID: 6117 (google_cloud_sa) Tasks: 6 Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M) CGroup: /system.slice/google-cloud-sap-agent.service └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon
Problema: velocità effettiva bassa
Problema: la velocità effettiva è inferiore a quella prevista.
Causa: per la funzionalità Backint dell'agente di Google Cloud per SAP, potresti aver abilitato la compressione utilizzando il parametro di configurazione compress
.
Soluzione: per risolvere il problema, verifica che la compressione non sia attiva. Per farlo, segui questi passaggi:
Connettiti al tuo host SAP HANA tramite SSH.
Apri il file di configurazione Backint:
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
Sostituisci
SID
con il SID del sistema in cui hai installato i file correlati a Backint.Verifica che il parametro
compress
sia impostato sufalse
.Se apporti modifiche, salva il file di configurazione.
Problema: errori di multistreaming
Problema: ricevi errori durante l'esecuzione dei backup dei dati in modalità multistream.
Causa:per la funzionalità Backint dell'agente di Google Cloud per SAP, potresti aver specificato un numero più elevato di flussi paralleli.
Soluzione:per risolvere il problema, svolgi i seguenti passaggi:
Connettiti al tuo host SAP HANA tramite SSH.
Apri il file di configurazione Backint:
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
Sostituisci
SID
con il SID del sistema in cui hai installato i file correlati a Backint.Se hai impostato un valore per il parametro
parallel_streams
, abbassalo a1
.Se l'errore persiste, contatta l'assistenza clienti.
Problema di connessione a Cloud Storage
Problema: stai riscontrando un problema di connettività con il bucket Cloud Storage.
Causa:
- Un problema di connettività temporaneo.
- L'account di servizio utilizzato dall'agente per SAP di Google Cloud non dispone delle autorizzazioni necessarie per accedere a Cloud Storage.
- Si è verificato un problema con la configurazione.
Risoluzione: per risolvere un problema di connettività con il bucket Cloud Storage, verifica quanto segue:
- Riprova a eseguire il backup o il ripristino non riuscito per assicurarti che l'errore non sia solo un problema di connettività temporaneo.
- Se l'agente di Google Cloud per SAP utilizza l'account di servizio della VM, assicurati che la VM abbia accesso a tutti gli ambiti cloud o se stai limitando l'accesso, assicurati che la VM abbia accesso a
storage.googleapis.com
. Per maggiori informazioni, consulta Abilitare l'accesso alle API Cloud e ai server di metadati. - Se hai creato un account di servizio da utilizzare con l'agente di Google Cloud per SAP, assicurati di quanto segue:
- All'account di servizio viene assegnato il ruolo Amministratore oggetti Storage.
- All'account di servizio viene assegnato il ruolo Autore crittografia/decrittografia CryptoKey Cloud KMS se utilizzi una chiave di crittografia gestita dal cliente per criptare i backup in Cloud Storage. Per maggiori informazioni, consulta Crittografia per i backup.
- Assicurati di aver specificato correttamente i parametri nel file di configurazione Backint, in
PARAMETERS.json
e nel fileglobal.ini
di SAP HANA.
Puoi testare l'accesso al tuo bucket Cloud Storage utilizzando la funzionalità di autodiagnosi integrata nell'agente per SAP di Google Cloud. Per saperne di più, consulta la pagina Autodiagnosi.
Problema con un'operazione di backup o ripristino basata su snapshot del disco
Problema: un'operazione di backup o di recupero eseguita per SAP HANA utilizzando il comando hanadiskbackup
o hanadiskrestore
dell'agente non è riuscita.
Causa:questo problema può verificarsi per uno dei seguenti motivi:
- L'agente riscontra un errore e chiude l'operazione di backup o ripristino.
- L'agente impiega più tempo del previsto per creare lo snapshot del disco o caricarlo su Cloud Storage a causa di un problema con un servizio Google Cloud sottostante.
- L'agente si arresta in modo anomalo senza un chiaro messaggio di errore o di operazione riuscita.
- L'operazione di backup o ripristino non va a buon fine a causa di un problema a livello di sistema operativo.
- L'agente è fatto attendere più a lungo del previsto dal tuo database SAP HANA, probabilmente perché il database sta ricevendo un carico di lavoro molto pesante.
Soluzione:per risolvere il problema, utilizza le seguenti informazioni:
Se si tratta di un'operazione di backup non riuscita, procedi nel seguente modo:
Verifica che l'agente sia in esecuzione. In caso contrario, riavvia l'agente e riprova a eseguire l'operazione di backup.
Se l'agente viene eseguito come previsto, lo stato della creazione dello snapshot:
gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE_ID/disks/DISK_NAME"
Sostituisci quanto segue:
PROJECT_ID
: progetto Google Cloud in cui viene eseguito il deployment del disco di origineZONE_ID
: la zona di Compute Engine in cui viene eseguito il deployment del disco di origine, ad esempious-central1-a
DISK_NAME
: il nome del disco di origine
Lo stato dell'output può essere uno dei seguenti:
CREATING
,UPLOADING
oREADY
.Se lo stato della creazione dello snapshot è
CREATING
oUPLOADING
, ti consigliamo di attendere il completamento dell'operazione, soprattutto se si tratta del primo snapshot che stai creando per il disco che ospita il tuo volume/hana/data
.Se questa operazione non va a buon fine, l'agente esce automaticamente dalla procedura e aggiorna i log. Puoi riprovare a creare il backup eseguendo il comando
hanadiskbackup
. L'agente si occupa di completare l'operazione di backup non riuscita nel database SAP HANA e di creare un nuovo backup basato su snapshot.Se lo stato della creazione dello snapshot è
READY
, ma il comandohanadiskbackup
sembra ancora in esecuzione, significa che l'agente è in attesa che SAP HANA esegua la propria procedura di backup.Se il comando
hanadiskbackup
sembra essere in esecuzione più a lungo del previsto, procedi nel seguente modo per riprendere le normali operazioni per il tuo database SAP HANA:Sblocca il file system XFS che contiene il volume
/hana/data
:xfs_freeze -u PATH_TO_HANA_DATA_VOLUME
Dal tuo database SAP HANA, recupera l'ID di backup dello snapshot di archiviazione non riuscito:
SELECT BACKUP_ID, STATE_NAME, COMMENT FROM M_BACKUP_CATALOG WHERE ENTRY_TYPE_NAME = 'data snapshot' and STATE_NAME = 'prepared'
In SAP HANA, aggiorna la voce dello snapshot non riuscito come non riuscito:
BACKUP DATA FOR FULL SYSTEM CLOSE SNAPSHOT BACKUP_ID UNSUCCESSFUL 'Do not use - manually terminated';
Sostituisci
BACKUP_ID
con il valoreBACKUP_ID
che hai recuperato nel passaggio precedente.Per risolvere il problema dell'operazione di backup non riuscita, contatta l'assistenza clienti con il pacchetto di assistenza dell'agente.
Se si tratta di un'operazione di recupero non riuscita, completa i seguenti passaggi:
Verifica che il disco originale che ospita il volume
/hana/data
sia collegato alla VM host. In caso contrario, collegalo utilizzando il comandogcloud compute instances attach-disk
.Esegui di nuovo la scansione dei gruppi di volumi e dei volumi logici:
sudo /sbin/dmsetup remove_all sudo /sbin/vgscan -v --mknodes sudo /sbin/vgchange -ay sudo /sbin/lvscan sudo mount -av
Se la nuova scansione non va a buon fine, riavvia la VM host. In questo modo il sistema operativo esegue una nuova scansione dei gruppi di volumi.
In SAP HANA, verifica che il volume
/hana/data
sia attivo.Se il volume
/hana/data
non è ancora attivo, contatta l'assistenza clienti con il pacchetto di assistenza dell'agente per risolvere il problema.
Ottenere assistenza per l'agente di Google Cloud per SAP
Se hai bisogno di aiuto per risolvere un problema con l'agente di Google Cloud per SAP, raccogli le informazioni di diagnostica richieste e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta le informazioni diagnostiche sull'agente di Google Cloud per SAP.