Configura l'agente per SAP di Google Cloud

Workload Manager per le soluzioni SAP utilizza l'agente per SAP di Google Cloud per rilevare e raccogliere i metadati per la valutazione delle configurazioni del sistema SAP. L'Agente per SAP, insieme all'agente host SAP, sono obbligatori su tutte le istanze VM che eseguono sistemi SAP per il supporto e il monitoraggio dei sistemi SAP in esecuzione su Google Cloud, tra cui SAP NetWeaver, SAP HANA, SAP ASE e SAP MaxDB.

Il seguente elenco di controllo riassume le attività che devi eseguire per assicurarti che l'agente per SAP sia configurato correttamente:

  1. Concedi i ruoli richiesti all'account di servizio
  2. Installa l'agente per SAP
  3. Verifica la versione dell'agente e installa gli aggiornamenti, se presenti
  4. Attiva la raccolta delle metriche di valutazione

Ruoli IAM obbligatori

L'agente diGoogle Cloudper SAP richiede un account di servizio Identity and Access Management (IAM) per l'autenticazione con Google Cloud e per l'autorizzazione ad accedere alle risorse Google Cloud . Per la raccolta delle metriche di valutazione di Workload Manager, che tu utilizzi un account di servizio nuovo, esistente o predefinito, l'account di servizio deve includere i seguenti ruoli IAM:

Installa l'agente

Se non l'hai già fatto, installa l'agente per SAP di Google Cloudsulla VM che ospita il sistema SAP:

Per installare l'agente in un'istanza Compute Engine:

  1. Stabilisci una connessione SSH all'istanza di calcolo.
  2. Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:
    • (Consigliato) Per installare la versione 3.6 (la più recente) dell'agente:

      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 install google-cloud-sap-agent

      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

      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
    • Per installare una versione specifica dell'agente:

      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 install 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 il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni dell'agente disponibili.

      Per informazioni su come eseguire il downgrade dell'agente a una versione specifica, consulta Eseguire il downgrade dell'agente Google Cloudper SAP.

Al termine dell'installazione, procedi con la configurazione dell'agente per la raccolta delle metriche di valutazione di Workload Manager.

Verifica la versione dell'agente

Google Cloud consiglia di installare la versione più recente di Agent for SAP per una valutazione accurata dei carichi di lavoro SAP, in quanto le release periodiche di Agent for SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

Per assicurarti di avere la versione più recente dell'agente Google Cloudper SAP, devi controllare periodicamente la disponibilità di aggiornamenti e aggiornare l'agente.

Cerca aggiornamenti

Seleziona il tuo sistema operativo e segui questi passaggi:

RHEL

  1. Stabilisci una connessione SSH con l'istanza.
  2. Esegui questo comando:
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Stabilisci una connessione SSH con l'istanza.
  2. Esegui questo comando:
    sudo zypper list-updates -r google-cloud-sap-agent

Installare un aggiornamento

Seleziona il tuo sistema operativo e segui i passaggi:

RHEL

  1. Stabilisci una connessione SSH con l'istanza.
  2. Aggiorna l'istanza dell'agente:
    • (Consigliato) Per eseguire l'aggiornamento alla versione 3.6 (la più recente) dell'agente:
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Per eseguire l'aggiornamento a una versione specifica dell'agente:
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Sostituisci VERSION_NUMBER con il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni dell'agente disponibili.

SLES

  1. Stabilisci una connessione SSH con l'istanza.
  2. Aggiorna l'istanza dell'agente:
    • (Consigliato) Per eseguire l'aggiornamento alla versione 3.6 (la più recente) dell'agente:
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Per eseguire l'aggiornamento a una versione specifica dell'agente:
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Sostituisci VERSION_NUMBER con il numero di versione dell'agente che vuoi installare, ad esempio 3.1-606637668. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni dell'agente disponibili.

Configurare la raccolta delle metriche di valutazione di Workload Manager

Per configurare l'agente per SAP di Google Cloud, completa i seguenti passaggi:

  1. Per consentire all'agente di raccogliere le metriche di valutazione del Gestore workload:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  2. (Facoltativo) Per attivare la raccolta delle metriche "SAP HANA Insights" e "SAP HANA Security Best Practices" in Workload Manager, aggiungi la sezione workload_validation_db_metrics_config dopo collect_workload_validation_metrics nel file di configurazione dell'agente e poi specifica i seguenti parametri:

    • hana_db_user: specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA.
    • hostname: specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA.
    • port: specifica la porta su cui l'istanza SAP HANA accetta le query.
    • hana_db_password_secret_name: specifica il nome del segreto in Secret Manager che memorizza la password dell'account utente

      In alternativa al segreto, puoi utilizzare il parametro di configurazione hdbuserstore_key.

    • hdbuserstore_key: specifica la chiave hdbuserstore che autentica l'utente specificato per hana_db_user

      Se specifichi hdbuserstore_key, salta la specifica dei parametri hostname e port.

    Per informazioni su questi parametri, consulta Parametri di configurazione.

    I seguenti esempi sono file di configurazione completati dell'agente per SAP diGoogle Cloudin esecuzione su unIstanzia Compute Engine, dove è attivata la raccolta delle metriche di valutazione di Workload Manager.

    Per l'autenticazione SAP HANA, l'agente utilizza il seguente ordine di preferenza: se specificato, il parametro di configurazione hdbuserstore_key è preferito rispetto al parametro hana_db_password, che è preferito rispetto al parametro hana_db_password_secret_name. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione.

    • L'esempio seguente utilizza una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA:
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hdbuserstore_key": "user_store_key"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }
    • L'esempio seguente utilizza un nome utente e un segreto Secret Manager per l'autenticazione SAP HANA:
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
            "hostname": "localhost",
            "port": "30015"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }
    • L'esempio seguente utilizza un nome utente e una password per l'autenticazione SAP HANA. Ti consigliamo di utilizzare un secret di Secret Manager o una chiave del repository degli utenti protetto (hdbuserstore) per l'autenticazione SAP HANA.
      {
        "provide_sap_host_agent_metrics": true,
        "bare_metal": false,
        "log_level": "INFO",
        "log_to_cloud": true,
        "collection_configuration": {
          "collect_workload_validation_metrics": true,
          "workload_validation_db_metrics_frequency": 3600,
          "workload_validation_db_metrics_config": {
            "hana_db_user": "system",
            "sid": "DEH",
            "hana_db_password": "TempPa55word",
            "hostname": "localhost",
            "port": "30015"
          },
          "collect_process_metrics": false
        },
        "discovery_configuration": {
          "enable_discovery": true,
          "enable_workload_discovery": true
        },
        "hana_monitoring_configuration": {
          "enabled": false
        }
      }

  3. Riavvia l'agente per applicare le nuove impostazioni:

    sudo systemctl restart google-cloud-sap-agent

    Dopo il riavvio, l'agente inizia a inviare le metriche di valutazione di Workload Manager a Workload Manager.

Passaggi successivi