Guida alla risoluzione dei problemi di Agent for SAP di Google Cloud

Questa guida mostra come risolvere i problemi relativi a: versione 3.4 (più recente) dell'agente Google Cloud per SAP.

Per informazioni sulla risoluzione dei problemi e sull'assistenza da SAP, consulta le seguenti risorse SAP Note

Logging

Controlla i log nella directory specifica del tuo sistema operativo.

Per visualizzare i log per l'agente Google Cloud per SAP, 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

Se hai attivato Funzionalità Backint dell'agente Google Cloud per SAP, quindi rivedi i seguenti log:

  • Il file SAP HANA backup.log, che contiene informazioni su SAP HANA le operazioni di backup e ripristino.
  • Il file SAP HANA backint.log, che contiene le chiamate al backup utilizzata dalla funzionalità Backint dell'agente e da altri strumenti di backup.
  • Il file di log di Backint dell'agente di Google Cloud per SAP: /var/log/google-cloud-sap-agent/backint.log. Questo file include informazioni su quando è stata abilitata la funzionalità Backint, relativi eventi operativi e indicazioni di errori di comunicazione con Cloud Storage e problemi di configurazione o autorizzazioni correlati.
  • Log di Google Cloud in Cloud Logging, che possono contenere errori relativo all'account di servizio usato dall'agente Google Cloud per SAP. Per visualizzare questi di Google Cloud, nella console Google Cloud, vai Pagina Esplora log.

Problemi comuni

Le seguenti sezioni forniscono informazioni sui problemi comuni relativi all'utilizzo Agent for SAP di Google Cloud, cause e soluzioni.

Problema: autorizzazioni IAM insufficienti

Problema: i log dell'agente per SAP di Google Cloud mostrano IAM insufficiente errore relativo alle autorizzazioni.

Causa: l'account di servizio utilizzato dall'agente non dispone dei necessari Autorizzazioni IAM per accedere all'API Cloud Monitoring oppure, utilizzando la funzionalità Backint dell'agente, autorizzazioni insufficienti per accedere al bucket Cloud Storage.

Soluzione:per risolvere il problema, procedi nel seguente modo:

  1. Nella console Google Cloud, sulla VM pagina dei dettagli dell'istanza, prendi nota del nome dell'account di servizio della VM. Per esempio: sap-example@example-project-123456.iam.gserviceaccount.com.

  2. Vai alla sezione IAM e Amministratore e, per l'account di servizio indicato, accertati che includa la seguenti ruoli IAM:

    Funzionalità Ruoli IAM richiesti
    Raccolta delle metriche di SAP Host Agent
    Raccolta di metriche di Process Monitoring
    Raccolta delle metriche di valutazione del Gestore carichi di lavoro
    Raccolta delle metriche di monitoraggio 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 hanno utilizzato una chiave di crittografia gestita dal cliente per crittografare i tuoi dati SAP HANA in Cloud Storage. Per informazioni al riguardo, vedi la funzionalità Opzioni di crittografia per i backup.

    Per ulteriori informazioni, vedi Autorizzazioni Cloud Storage richieste.

Per ulteriori informazioni sull'autenticazione richiesta per di Google Cloud per SAP, consulta Autenticazione e accesso.

Per confermare le autorizzazioni richieste dall'agente Cloud Monitoring, consulta documentazione di Monitoring:

Problema: Ambiti di accesso errati per l'account di servizio VM

Problema: se limiti gli ambiti di accesso sulla tua istanza VM host, I log dell'agente Google Cloud per SAP potrebbero mostrare IAM insufficiente errore relativo alle autorizzazioni.

Causa: l'agente Google Cloud per SAP richiede ambiti minimi di accesso alle API Cloud sull'istanza VM host. Questo errore si verifica quando l'account di servizio non dispongono degli ambiti di accesso richiesti.

Risoluzione: ambiti di accesso sono il metodo legacy per specificare le autorizzazioni per un'istanza VM. Compute Engine consiglia di configurare le istanze VM per consentire di accedere agli ambiti di accesso a tutte le API Cloud utilizzando solo le autorizzazioni IAM dell'account di servizio VM per controllare l'accesso alle risorse Google Cloud.

Per risolvere il problema, imposta l'accesso a tutti i cloud-platform come best practice sull'istanza VM, quindi limita in modo sicuro l'accesso all'API dell'account di servizio i ruoli IAM. Ad esempio:

  • https://www.googleapis.com/auth/cloud-platform

Se limiti gli ambiti di accesso della tua istanza VM, devi assicurarti che l'istanza VM host ha 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 Process Monitoring o Metriche di monitoraggio SAP HANA, gli ambiti di accesso dell'istanza VM host devono disponi anche 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, quindi le modifiche, quindi riavvia l'istanza VM. Per istruzioni, vedi Documentazione di Compute Engine. Non è necessario apportare modifiche alle autorizzazioni per i ruoli IAM per questo problema.

Problema: SAP Host Agent mancante o errato

Problema: i log dell'agente Google Cloud per SAP mostrano che l'host SAP risulta mancante o errato Errore dell'agente.

Causa: agente host SAP o il livello minimo di patch richiesto per l'agente host SAP L'agente host SAP non è installato. Affinché l'Agente per SAP di Google Cloud funzioni, Nel sistema SAP deve essere installato SAP Host Agent e la patch minima richiesta per l'agente host sia mantenuto.

Risoluzione: Per risolvere il problema, installa la versione richiesta di SAP Host Agent. Per istruzioni sull'installazione dell'agente host SAP, consulta documentazione SAP.

Per i requisiti di versione per l'agente host SAP, vedi quanto segue SAP Note

Problema: installazione dell'agente di Google Cloud per SAP non riuscita

Problema: l'installazione dell'agente non riesce quando viene eseguito il gestore di pacchetti comando di installazione come yum, zypper o googet oppure viene visualizzato quanto segue messaggio di errore: Package matching google-cloud-sap-agent-VERSION_NUMBER already installed. Checking for update..

Causa: l'installazione dell'agente non riesce per uno dei seguenti motivi:

  • Stai eseguendo il downgrade dell'agente a una versione non più recente e alla tua istanza Compute. viene eseguito su una versione precedente di RHEL per SAP, ad esempio 7.9.
  • L'istanza Compute che ospita l'agente è stata creata senza un server Indirizzo IP.

Soluzione: per risolvere il problema, esegui una delle seguenti operazioni, come indicato di seguito. più adatti al tuo scenario:

  • Se vuoi eseguire il downgrade dell'istanza dell'agente a una versione non più recente Compute viene eseguito su una versione precedente di RHEL per SAP, ad esempio 7.9, esegui questo comando:

    RHEL

    sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum downgrade google-cloud-sap-agent-VERSION_NUMBER.x86_64

    SLES15

    sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

    SLES 12

    sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

    Sostituisci VERSION_NUMBER con la versione dell'agente numero da installare, ad esempio 3.1-606637668. Per sulle versioni dell'agente che puoi installare, vedi Elenca tutte le versioni disponibili dell'agente.

  • Se l'istanza Compute che ospita l'agente non ha un indirizzo IP esterno, quindi configura un gateway NAT che conceda al server host l'accesso in uscita internet. Per informazioni su come configurare un gateway NAT, consulta una guida al deployment per il tuo sistema SAP. Ad esempio, per SAP NetWeaver, consulta:

Problema: raccolta delle metriche di monitoraggio SAP HANA non riuscita

Problema: durante l'upgrade dall'agente di monitoraggio per SAP HANA, dopo installare l'agente di Google Cloud per SAP, viene visualizzato un messaggio di errore simile seguenti:

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 di SAP HANA monitorare le metriche perché le istanze SAP HANA di destinazione utilizzano i certificati SSL specificati con il nome comune (CN).

Soluzione: per risolvere il problema, completa i seguenti passaggi:

  1. Per le istanze SAP HANA che vuoi monitorare utilizzando di Google Cloud per SAP, devi passare all'utilizzo di un nome alternativo del soggetto (SAN) anziché i certificati SSL specificati con Nome comune (CN).

  2. Stabilisci una connessione SSH con l'istanza VM host oppure server Bare Metal Solution.

  3. Apri il file di configurazione dell'agente di Google Cloud per SAP:

    /etc/google-cloud-sap-agent/configuration.json

  4. Nella sezione hana_monitoring_configuration, imposta il parametro enabled a true.

  5. Nella sezione hana_monitoring_configuration.hana_instances, esegui la per ogni istanza SAP HANA che utilizza il protocollo TLS/SSL comunicazioni sicure:

    1. Specifica il parametro enable_ssl e imposta il valore su true.

    2. Specifica il parametro host_name_in_certificate e imposta il valore SAP HANA nome host, come specificato nel certificato TLS/SSL, come valore.

    3. Specifica il parametro tls_root_ca_file e imposta il percorso, dove il valore il certificato TLS/SSL viene archiviato, come relativo valore.

  6. Salva il file di configurazione.

  7. Riavvia l'agente Google Cloud per SAP per applicare le nuove impostazioni:

    sudo systemctl restart google-cloud-sap-agent

  8. Verifica che l'agente stia raccogliendo le metriche di monitoraggio di SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.

  9. Disinstalla l'agente Monitoring per SAP HANA.

Problema: errore di connessione rifiutata

Problema: i log di SAP Host Agent mostrano l'errore di connessione rifiutata.

Causa: non è possibile avviare l'agente Google Cloud per SAP perché la porta 18181 non è disponibile. L'agente per SAP di Google Cloud rimane in ascolto delle richieste sulla porta 18181. Questa porta deve essere disponibile per l'avvio dell'agente.

Soluzione: per risolvere il problema, assicurati che la porta 18181 sia disponibile per SAP e l'agente Google Cloud. Se un altro servizio utilizza la porta 18181, potrebbe essere necessario riavviare l'altro servizio o riconfigurarlo per utilizzare in un'altra porta.

Problema: per le immagini sistema operativo SLES 15 SP4 for SAP e versioni successive, l'agente Google Cloud per SAP non è in esecuzione

Problema: quando si utilizza lo strumento SLES "for SAP" immagini sistema operativo, L'Agente per SAP di Google Cloud è preinstallato. Ma per le immagini del sistema operativo SLES 15 SP4 for SAP e successivi, l'agente preinstallato per SAP non inizia da solo.

Per verificare che l'agente sia in esecuzione o meno, segui questi passaggi:

  1. Connettiti all'istanza VM host o al server Bare Metal Solution.

  2. 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 automaticamente a causa di un problema con la pacchettizzazione del sistema operativo.

Risoluzione: Per risolvere il problema:

  1. Connettiti all'istanza VM host o al server Bare Metal Solution.

  2. 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

  3. 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:si verifica una velocità effettiva inferiore a quella prevista.

Causa: per la funzionalità Backint dell'agente di Google Cloud per SAP, potresti aver ha attivato la compressione utilizzando il parametro di configurazione compress.

Soluzione: per risolvere il problema, verifica che la compressione non sia abilitata. Per farlo, segui questi passaggi:

  1. Connettiti all'host SAP HANA utilizzando SSH.

  2. Apri il file di configurazione di Backint:

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

    Sostituisci SID con il SID del sistema in cui installato i file relativi a Backint.

  3. Verifica che il parametro compress sia impostato su false.

  4. Se apporti modifiche, salva il file di configurazione.

Problema: errori di multistreaming

Problema: ricevi errori durante backup dei dati multistreaming.

Causa: per la funzionalità Backint dell'agente di Google Cloud per SAP, potresti aver un numero maggiore di flussi paralleli.

Soluzione:per risolvere il problema, procedi nel seguente modo:

  1. Connettiti all'host SAP HANA utilizzando SSH.

  2. Apri il file di configurazione di Backint:

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

    Sostituisci SID con il SID del sistema in cui installato i file relativi a Backint.

  3. Se hai impostato un valore per il parametro parallel_streams, abbassalo a 1.

    Se il problema persiste, contatta l'assistenza clienti.

Problema con la connessione a Cloud Storage

Problema: stai riscontrando un problema di connettività con Cloud Storage di sincronizzare la directory di una VM con un bucket.

Causa:può essere causata da quanto segue:

  • Un problema di connettività temporaneo.
  • L'account di servizio utilizzato dall'agente Google Cloud per SAP non dispone della le autorizzazioni necessarie per accedere a Cloud Storage.
  • Si è verificato un problema con la tua configurazione.

Soluzione: risolvere un problema di connettività con Cloud Storage. bucket, controlla quanto segue:

  • Riprova a eseguire il backup o il ripristino non riusciti per assicurarti che l'errore non sia stato semplicemente un problema di connettività momentaneo.
  • Se l'agente di Google Cloud per SAP utilizza l'account di servizio della tua 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 ulteriori informazioni le informazioni, vedi Abilitare l'accesso alle API Cloud e ai server di metadati di Cloud.
  • Se hai creato un account di servizio da utilizzare con l'agente di Google Cloud per SAP, verifica quanto segue:
    • All'account di servizio viene assegnato il ruolo Amministratore oggetti Storage.
    • All'account di servizio viene assegnato Ruolo Autore crittografia/decrittografia CryptoKey Cloud KMS se utilizzi un e la chiave di crittografia gestita dal cliente per crittografare i backup di archiviazione ideale in Cloud Storage. Per ulteriori informazioni, vedi Crittografia per i backup.
  • Assicurarsi di aver specificato correttamente i parametri in Backint di configurazione del deployment, PARAMETERS.json e SAP HANA global.ini file.

Puoi testare l'accesso al tuo bucket Cloud Storage utilizzando funzionalità di autodiagnosi integrata nell'agente Google Cloud per SAP. Per ulteriori informazioni le informazioni, vedi Autodiagnosi.

Problema con un'operazione di backup o ripristino basata su snapshot del disco

Problema: un'operazione di backup o ripristino eseguita per SAP HANA utilizzando comando hanadiskbackup o hanadiskrestore dell'agente non riuscito.

Causa: questo problema può verificarsi per uno dei seguenti motivi:

  • L'agente rileva un errore ed esce dall'operazione di backup o ripristino.
  • La creazione o il caricamento dello snapshot del disco da parte dell'agente richiede più tempo del previsto a Cloud Storage a causa di un problema con un dal servizio Google Cloud.
  • L'agente ha un arresto anomalo senza un chiaro messaggio di errore o di operazione riuscita.
  • L'operazione di backup o ripristino non riesce a causa di un problema con il sistema operativo a livello di sistema.
  • L'agente è fatto per attendere più a lungo del previsto dal tuo database SAP HANA, Ciò potrebbe essere dovuto al fatto che il tuo database sta eseguendo un carico di lavoro molto elevato.

Soluzione:per risolvere il problema, utilizza le seguenti informazioni:

  • Se si tratta di un'operazione di backup non riuscita, procedi nel seguente modo:

    1. Verifica che l'agente sia in esecuzione. In caso contrario, riavvia l'agente. quindi riprova a eseguire l'operazione di backup.

    2. Se l'agente è in esecuzione 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: il progetto Google Cloud in cui l'origine di cui è stato eseguito il deployment
      • ZONE_ID: il Compute Engine zona in cui si trova il disco di origine di cui è stato eseguito il deployment, ad esempio us-central1-a
      • DISK_NAME: il nome del disco di origine

      Lo stato dell'output può essere uno dei seguenti: CREATING, UPLOADING o READY.

    3. Se lo stato della creazione dello snapshot è CREATING o UPLOADING: ti consigliamo di attendere il completamento di questa operazione, soprattutto se Questo è il primo snapshot che stai creando per il disco che ospita il tuo /hana/data volume.

      Se questa operazione non riesce, l'agente chiude automaticamente la procedura e i log degli aggiornamenti. Puoi riprovare a creare il backup eseguendo il comando Comando hanadiskbackup. L'agente si occupa di completare operazione di backup non riuscita nel database SAP HANA e crea una nuova un backup basato su snapshot.

    4. Se lo stato della creazione dello snapshot è READY, ma Il comando hanadiskbackup sembra essere ancora in esecuzione, a indicare che che l'agente sia in attesa che SAP HANA esegua la sua parte del backup .

    5. Se il comando hanadiskbackup viene eseguito più a lungo del previsto, quindi segui questi passaggi per riprendere le normali operazioni per SAP HANA database:

      1. Sblocca il file system XFS che contiene il volume /hana/data:

        xfs_freeze -u PATH_TO_HANA_DATA_VOLUME

      2. Dal tuo database SAP HANA, ottieni l'ID backup dell'archiviazione non riuscita istantanea:

        SELECT BACKUP_ID, STATE_NAME, COMMENT FROM M_BACKUP_CATALOG WHERE ENTRY_TYPE_NAME = 'data snapshot' and STATE_NAME = 'prepared'

      3. In SAP HANA, aggiorna la voce relativa allo snapshot non riuscito perché non è riuscita:

        BACKUP DATA FOR FULL SYSTEM CLOSE SNAPSHOT BACKUP_ID UNSUCCESSFUL 'Do not use - manually terminated';

      Sostituisci BACKUP_ID con il BACKUP_ID che hai recuperato nel passaggio precedente.

    6. Per risolvere il problema dell'operazione di backup non riuscita, contatta L'assistenza clienti dell'agente supporto bundle.

  • Se si tratta di un'operazione di recupero non riuscita, completa quanto segue passaggi:

    1. Verifica che il disco originale che ospita il volume /hana/data sia collegato alla VM host. Se non lo è, allegalo utilizzando il Comando gcloud compute instances attach-disk.

    2. 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

    3. Se la nuova scansione non va a buon fine, riavvia la VM host. Ciò rende rieseguire la scansione dei gruppi di volumi.

    4. In SAP HANA, verifica che il volume /hana/data sia attivo.

    5. Se il volume /hana/data non è ancora attivo, contatta L'assistenza clienti dell'agente support bundle per risolvere problema.

Assistenza per l'Agente per SAP di Google Cloud

Se hai bisogno di aiuto per risolvere un problema con l'agente di Google Cloud per SAP, Raccogli le informazioni diagnostiche richieste e contatta l'assistenza clienti Google Cloud. Per saperne di più, consulta le informazioni diagnostiche dell'Agente Google Cloud per SAP.