Questa pagina è stata tradotta dall'API Cloud Translation.

Configura l'agente per SAP di Google Cloud

Workload Manager per le soluzioni SAP utilizza l'agente per SAP diGoogle Cloud per rilevare e raccogliere i metadati per valutare le configurazioni del sistema SAP. L'agente per SAP, insieme all'agente host SAP, sono necessari 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

L'agente diGoogle Cloudper SAP richiede un service account di 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 del Gestore carichi di lavoro, 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)
Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
Secret Manager Secret Accessor (roles/secretmanager.secretAccessor), se utilizzi Secret Manager per archiviare la password del database SAP HANA.

Installa l'agente

Se non l'hai ancora fatto, installa l'agente di Google Cloudper SAP sulla VM che ospita il tuo sistema SAP:

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

Stabilisci una connessione SSH all'istanza di calcolo.

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

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

Per informazioni sul downgrade dell'agente a una versione specifica, vedi Eseguire il downgrade Google Clouddell'agente per SAP.

Al termine dell'installazione, procedi alla configurazione dell'agente per la raccolta delle metriche di valutazione del Gestore workload.

Verificare la versione dell'agente

Google Cloud consiglia di installare l'ultima versione di Agent for SAP per una valutazione accurata dei carichi di lavoro SAP, perché i rilasci periodici di Agent for SAP potrebbero aggiungere o modificare le metriche utilizzate per la valutazione.

Per assicurarti di avere l'ultima versione dell'agente per SAP di Google Cloud, 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

Installare 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.9 (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 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.9 (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 Elenca tutte le versioni disponibili dell'agente.

Configura la raccolta delle metriche di valutazione del Gestore workload

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

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
```

(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, 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, vedi Parametri di configurazione.

Gli esempi seguenti sono file di configurazione completi dell'agente per SAP diGoogle Cloudin esecuzione su un'server Bare Metal Solution, 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 parametro di configurazione hdbuserstore_key ha la precedenza sul parametro hana_db_password, che ha la precedenza sul 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 Secure User Store (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 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 Secure User Store (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 far sì che le nuove impostazioni diventino effettive:

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 riuscito, l'agente inizia a inviare le metriche di valutazione del Gestore workload al Gestore workload.

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

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

Per convalidare la Google Cloud configurazione, completa i seguenti passaggi:

Stabilisci una connessione SSH con l'istanza Compute Engine.

Esegui questo comando:

sudo /usr/bin/google_cloud_sap_agent status

Se la configurazione di Google Cloud per la raccolta delle metriche di valutazione di Workload Manager è corretta, l'output include quanto segue. La configurazione potrebbe avere valori diversi da quelli di 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, rivedi le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste e poi esegui di nuovo il comando status per convalidare nuovamente la configurazione.

Passaggi successivi

Scopri di più sulle valutazioni dei workload

Configura l'agente per SAP di Google Cloud 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

Verificare la versione dell'agente

Verifica la disponibilità di aggiornamenti

RHEL

SLES

Installare un aggiornamento

RHEL

SLES

Configura la raccolta delle metriche di valutazione del Gestore workload

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

Passaggi successivi

Configura l'agente per SAP di Google Cloud