Configura l'agente per i workload SAP

Workload Manager per le soluzioni SAP utilizza Google Cloud's Agent per SAP per rilevare e raccogliere i metadati per la valutazione delle configurazioni del sistema SAP. L'agente per SAP, insieme a l'agente host SAP, è obbligatorio su tutte le istanze VM che eseguono sistemi SAP per il supporto e il monitoraggio dei sistemi SAP in esecuzione su Google Cloud, inclusi 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:

Concedi i ruoli richiesti al service account
Installa l'agente per SAP
Verifica la versione dell'agente e installa gli aggiornamenti, se presenti
Abilita la raccolta delle metriche di valutazione

Ruoli IAM richiesti

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

Visualizzatore Compute (roles/compute.viewer)
Writer di approfondimenti di Workload Manager (roles/workloadmanager.insightWriter)
Accessore ai secret di Secret Manager (roles/secretmanager.secretAccessor), se utilizzi Secret Manager per archiviare la password del database SAP HANA

Installa l'agente

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

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

Stabilisci una connessione SSH all'istanza di computing.

Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:

(Consigliato) Per installare la versione 3.12 (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 Elenca tutte le versioni disponibili dell'agente.

Per informazioni sul downgrade dell'agente a una versione specifica, consulta Esegui il downgrade Google Cloud's dell'agente per SAP.

Al termine dell'installazione, procedi alla 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 dell'agente per SAP per una valutazione accurata dei carichi di lavoro SAP, perché le release periodiche dell'agente per SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

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

Verifica la disponibilità di aggiornamenti

Seleziona il tuo sistema operativo e segui questi passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza.

Esegui questo comando:

sudo yum check-update google-cloud-sap-agent

SLES

Stabilisci una connessione SSH con l'istanza.

Esegui questo comando:

sudo zypper list-updates -r google-cloud-sap-agent

Installa un aggiornamento

Seleziona il tuo sistema operativo e segui i passaggi:

RHEL

Stabilisci una connessione SSH con l'istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.12 (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 Elenca tutte le versioni disponibili dell'agente.

SLES

Stabilisci una connessione SSH con l'istanza.
Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.12 (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 Elenca tutte le versioni disponibili dell'agente.

Configura la raccolta delle metriche di valutazione di Workload Manager

Per configurare Google Cloudl'agente per SAP di: completare i seguenti passaggi:

Per consentire all'agente di raccogliere le metriche di valutazione di Workload Manager:

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

(Facoltativo) Per abilitare 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, quindi 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 secret in Secret Manager che memorizza la password dell'account utente

In alternativa al secret, 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, non devi specificare i parametri hostname e port.

Per informazioni su questi parametri, consulta Parametri di configurazione.

Gli esempi seguenti sono file di configurazione completi dell' Google Cloud'agente per SAP di in esecuzione su un istanza Compute Engine, in cui è abilitata 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 hdbuserstore_key parametro di configurazione è preferito al parametro hana_db_password, che è preferito 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 dell'archivio utenti sicuro (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 secret di Secret Manager secret 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 invece un secret di Secret Manager o chiave dell'archivio utenti sicuro (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
  }
}

Riavvia l'agente per applicare le nuove impostazioni:

Nota: a partire dalla versione 3.7, non è necessario riavviare l'agente perché le modifiche alla configurazione dell'agente vengono applicate automaticamente entro i 30 secondi successivi.
```
sudo systemctl restart google-cloud-sap-agent
```
Dopo il riavvio dell'agente, questo inizia a inviare le metriche di valutazione di Workload Manager a Workload Manager.

Convalida la configurazione per la raccolta delle metriche di valutazione di Workload Manager

Puoi verificare se hai la configurazione corretta per la raccolta delle metriche di valutazione di Workload Manager eseguendo il comando dell'agente. Google Cloud status Questo comando è supportato a partire dalla versione 3.7 dell'agente.

Per convalidare la Google Cloud configurazione:

Stabilisci una connessione SSH con l'istanza Compute Engine.

Esegui questo comando:

sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

Se la configurazione per la raccolta delle metriche di valutazione di Workload Manager è corretta, l'output include quanto segue. Google Cloud La configurazione potrebbe avere valori diversi da quelli default.

    Agent Status:
        ...
        Systemd Service Enabled: True
        Systemd Service Running: True
        Cloud API Full Scopes: True
        Configuration File: /etc/google-cloud-sap-agent/configuration.json
        Configuration Valid: True
    ...
    ----------------------------------------------------------------------------
    System Discovery: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            enable_discovery:                  true  (default)
            enable_workload_discovery:         true  (default)
            sap_instances_update_frequency:    60    (default)
            system_discovery_update_frequency: 14400 (default)
    ----------------------------------------------------------------------------
    Workload Manager Evaluation: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_workload_validation_metrics:      true       (default)
            config_target_environment:                PRODUCTION (default)
            fetch_latest_config:                      true       (default)
            workload_validation_db_metrics_frequency: 3600       (default)
            workload_validation_metrics_frequency:    300        (default)
    ...

Se l'output indica che manca una configurazione, esamina le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste, e poi esegui di nuovo il status comando per convalidare nuovamente la configurazione.

Passaggi successivi

Scopri di più sulle valutazioni dei carichi di lavoro

Configura l'agente per i workload SAP Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Ruoli IAM richiesti

Installa l'agente

RHEL

SLES15

SLES 12

RHEL

SLES15

SLES 12

Verifica la versione dell'agente

Verifica la disponibilità di aggiornamenti

RHEL

SLES

Installa un aggiornamento

RHEL

SLES

Configura la raccolta delle metriche di valutazione di Workload Manager

Convalida la configurazione per la raccolta delle metriche di valutazione di Workload Manager

Passaggi successivi

Configura l'agente per i workload SAP