Configura l'agente per i workload SAP

Workload Manager per 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, è obbligatorio su tutte le istanze VM che eseguono sistemi SAP per l'assistenza e il monitoraggio dei sistemi SAP in esecuzione su Google Cloud, inclusi SAP NetWeaver, SAP HANA, SAP ASE e SAP MaxDB.

Prima di iniziare

Google Cloud

Ruoli IAM richiesti per l'agente

L'agente per SAP utilizza il account di servizio collegato all'istanza di computing per l'autenticazione e per accedere alle risorse Google Cloud .

Per migliorare la sicurezza, ti consigliamo di utilizzare un service account per un unico scopo anziché il service account predefinito di Compute Engine.

Per assicurarti che il account di servizio disponga delle autorizzazioni necessarie per consentire all'agente per SAP di autenticarsi conGoogle Cloud e accedere alle risorse Google Cloud , chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio del tuo progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche assegnare al account di servizio le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Abilita l'accesso alle API Cloud

Compute Engine consiglia di configurare le istanze in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud. Per controllare l'accesso alle risorse Google Cloud, utilizza solo le autorizzazioni IAM del service account dell'istanza. Per saperne di più, consulta Crea una VM che utilizza un service account gestito dall'utente.

Se limiti l'accesso alle API Cloud, l'agente per SAP richiede almeno i seguenti ambiti di accesso alle API Cloud nell'istanza di computing host:

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

Per saperne di più, consulta le best practice per gli ambiti.

Se esegui applicazioni SAP su un'istanza di computing che non ha un indirizzo IP esterno, devi attivare l'accesso privato Google sulla subnet dell'istanza in modo che l'agente per SAP possa accedere alle API di Google e ai servizi Google. Per informazioni su come abilitare l'accesso privato Google, consulta Configura l'accesso privato Google.

Installa e configura l'agente utilizzando il gestore di pacchetti

Questa sezione mostra come installare l'agente per SAP sulla tua istanza di computing e configurarlo per la connessione al workload SAP utilizzando un gestore di pacchetti.

Se vuoi installare e configurare l'agente su un parco risorse di VM, puoi utilizzare una policy del gestore di estensioni VM. Per saperne di più, consulta Installa e gestisci l'agente su un parco risorse di VM utilizzando il gestore di estensioni VM.

Installa l'agente

Se non l'hai già fatto, installa l'agente per SAP di Google Cloud su tutte le istanze di computing che eseguono il tuo workload SAP:

Per installare l'agente su un'istanza Compute Engine, segui questi passaggi:

  1. Stabilisci una connessione SSH alla tua istanza di computing.
  2. Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:
    • (Consigliato) Per installare la versione 3.16 (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 dell'agente per SAP di Google Cloud.

Configura la raccolta delle metriche di valutazione di Workload Manager

Dopo aver installato l'agente per SAP, devi configurarlo per 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 di Workload Manager:

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

  2. (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'agente per SAP diGoogle Cloudin esecuzione su unistanza 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 parametro di configurazione hdbuserstore_key è 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 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 invece 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
  }
}

  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.

Installa e gestisci l'agente su un parco risorse di VM utilizzando il gestore di estensioni VM

Questa sezione mostra come installare e gestire l'agente per SAP su un parco risorse di VM utilizzando il gestore di estensioni VM.

La policy di gestore di estensioni VM consente di eseguire attività come le seguenti:

  • Installazione su tutta la flotta: Installa l'agente per SAP sui seguenti dispositivi:
    • Tutte le VM nel progetto Google Cloud o un sottoinsieme di VM identificate dalle etichette.
    • Tutte le VM all'interno di una zona o un sottoinsieme di VM identificate da etichette.
  • Gestione della configurazione: applica una configurazione personalizzata all'agente su tutte le VM gestite da una policy.

Configura gestore di estensioni VM

Per configurare il gestore di estensioni VM, completa i seguenti passaggi:

Installa e configura l'agente su un parco risorse di VM

Per installare l'ultima versione dell'agente per SAP sul tuo parco risorse di VM utilizzando una policy di gestore di estensioni VM, consulta la sezione appropriata:

Installa e configura l'agente sulle VM all'interno del tuo progetto Google Cloud

Per installare l'agente su tutte le VM del tuo progetto Google Cloud o su un sottoinsieme di VM identificate da etichette, utilizzando una policy di gestore di estensioni VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic su Crea policy di estensione.

  3. Nel campo Nome, inserisci un nome per la policy.

  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.

  5. Nel campo Priorità, specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nella sezione Ambito, seleziona Implementazione globale.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e poi segui questi passaggi:

    1. Dall'elenco Estensione, seleziona Estensione di Google Cloud per SAP.

    2. Lascia invariata la selezione del campo Versione.

      In questo modo, la policy installa l'ultima versione dell'agente per SAP diGoogle Cloudnel tuo parco risorse di VM.

    3. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

      Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload SAP, consulta Parametri di configurazione.

    4. Fai clic su Fine.

    5. Nel campo Rilascio, seleziona l'opzione del piano di rilascio che vuoi utilizzare: Rilascio lento (consigliata) o Rilascio rapido.

  8. (Facoltativo) Per limitare l'implementazione della policy alle VM richieste, in Istanze VM di destinazione, segui questi passaggi:

    1. Fai clic su Aggiungi etichette e includi le etichette che identificano le VM richieste.
    2. Fai clic su Fine.

  9. Fai clic su Crea.

gcloud

Nel terminale di Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

Sostituisci quanto segue:

  • POLICY_NAME: un nome univoco per la policy di estensione della VM.
  • PROJECT_ID: l'ID progetto del progettoGoogle Cloud per cui stai creando la policy

  • ROLLOUT_PLAN_OPTION: l'opzione di implementazione che vuoi applicare alla policy globale. I valori supportati sono slow_rollout (consigliato) e fast_rollout.

    • In alternativa, puoi utilizzare un piano di rilascio personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, consulta Informazioni sui piani di rilascio.
    • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

  • DESCRIPTION: una descrizione facoltativa della policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione dell'agente per SAP.

    • In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-sap-extension="CONFIG".
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per scegliere come target le VM.

    • Affinché una VM sia interessata dalla policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM del progetto.

  • PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Per saperne di più, consulta Priorità delle policy e risoluzione dei conflitti.

Installa e configura l'agente su un parco risorse di VM all'interno di una zona specifica

Per installare l'ultima versione dell'agente per SAP sul tuo parco risorse di VM all'interno di una zona specifica utilizzando una policy del gestore di estensioni VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic su Crea policy di estensione.

  3. Nel campo Nome, inserisci un nome per la policy.

  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.

  5. Nel campo Priorità, specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nella sezione Ambito, seleziona Implementazione a livello di zona, quindi seleziona la Regione e la Zona in cui vuoi applicare questa policy.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e poi segui questi passaggi:

    1. Dall'elenco Estensione, seleziona Estensione di Google Cloud per SAP.

    2. Lascia vuoto il campo Version (Versione).

      In questo modo, la policy installa l'ultima versione dell'agente per SAP diGoogle Cloud.

    3. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

      Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload SAP, consulta Parametri di configurazione.

    4. Fai clic su Fine.

  8. (Facoltativo) Per limitare l'implementazione della policy alle VM richieste, in Istanze VM di destinazione, segui questi passaggi:

    1. Fai clic su Aggiungi etichette e includi le etichette che identificano le VM richieste.
    2. Fai clic su Fine.

  9. Fai clic su Crea.

gcloud

Nel terminale o in Cloud Shell, esegui il comando gcloud zona di computing-vm-extension-policies create:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Sostituisci quanto segue:

  • POLICY_NAME: un nome per la policy di estensione della VM.

    Il comando non va a buon fine se nella zona esiste già una policy con il nome specificato.

  • ZONE: la zona in cui vuoi applicare questa policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON che contiene la configurazione dell'agente per SAP per la connessione al workload SAP.

    • In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-sap-extension="CONFIG". Google Cloud consiglia di utilizzare --config-from-file.
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload SAP, consulta Parametri di configurazione.

  • DESCRIPTION: una descrizione facoltativa della policy.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per scegliere come target le VM.

    • Affinché una VM sia interessata dalla policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata.

  • PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

Esempio:

Il seguente comando crea una policy denominata test-agent-policy nel progettoGoogle Cloud denominato test-project, che installa l'ultima versione di Agent for Compute Workloads su tutte le VM di cui è stato eseguito il deployment nella zona us-centrail-f. La configurazione specificata in agent-config.json viene applicata all'agente.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension="/usr/agent-config.json"

Gestisci l'agente su un parco risorse di VM

Per modificare il modo in cui una policy di gestore di estensioni VM gestisce l'agente per SAP, aggiorna la policy. Quando aggiorni una policy, il gestore di estensioni VM implementa le modifiche a tutte le VM applicabili, in genere entro un minuto. Se modifichi le etichette di inclusione, l'agente per SAP potrebbe essere installato su nuove VM o disinstallato dalle VM esistenti in base alla corrispondenza delle VM con le etichette aggiornate.

Le sezioni seguenti mostrano come gestire l'agente per SAP per:

Modifica la configurazione dell'agente su un parco risorse di VM

Per modificare la configurazione delle istanze dell'agente per SAP che hai installato nel tuo parco risorse di VM utilizzando una policy del gestore di estensioni VM, devi modificare la policy.

Per modificare la configurazione dell'agente nel tuo parco VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Per aggiornare una policy a livello di zona, vai alla scheda Policy a livello di zona.

  3. Fai clic sulla policy che vuoi modificare.

  4. Nella pagina Dettagli policy di estensione, fai clic su Modifica.

  5. Nella sezione Gestisci estensioni, segui questi passaggi:

    1. Seleziona Estensione di Google Cloud per SAP.
    2. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

    Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  6. Fai clic su Fine.

  7. Fai clic su Salva.

gcloud

A livello di zona

Per modificare la configurazione dell'agente per SAP sulle VM all'interno di una zona specifica, esegui il comando gcloud compute zone-vm-extension-policies update. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. I campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti della policy modificata.

Per modificare la configurazione dell'agente:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --zone=ZONE \
  --extensions=google-cloud-sap-extension \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Sostituisci quanto segue:

  • POLICY_NAME: il nome della policy di estensione della VM che vuoi modificare.
  • ZONE: la zona Google Cloud in cui si applica la policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione dell'agente per SAP.

    • Puoi anche fornire la configurazione dell'agente come stringa incorporata utilizzando il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-sap-extension="CONFIG". Google Cloud consiglia di utilizzare --config-from-file.
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per scegliere le VM target.

    • Affinché una VM sia interessata dalla policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata.

  • PRIORITY_NUMBER: la priorità che vuoi impostare per la policy. Puoi specificare un numero intero compreso tra 0 e 65535.

  • DESCRIPTION: una descrizione della policy di estensione della VM.

Globale

Per modificare la configurazione dell'agente per SAP sulle VM nel tuo progettoGoogle Cloud , esegui il comando gcloud compute global-vm-extension-policies update. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. I campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti della policy modificata.

Per modificare la configurazione dell'agente:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=google-cloud-sap-extension \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Sostituisci quanto segue:

  • POLICY_NAME: il nome della policy di estensione della VM che vuoi modificare.
  • PROJECT_ID: l'ID del progetto Google Cloud in cui si trova la policy.

  • ROLLOUT_PLAN_OPTION: l'opzione di implementazione che vuoi applicare alla policy globale. I valori supportati sono slow_rollout (consigliato) e fast_rollout.

    • In alternativa, puoi utilizzare un piano di rilascio personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, consulta Informazioni sui piani di rilascio.
    • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione dell'agente per SAP.

    • Puoi anche fornire la configurazione dell'agente come stringa incorporata utilizzando il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-sap-extension="CONFIG". Google Cloud consiglia di utilizzare --config-from-file.
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per scegliere le VM target.

    • Affinché una VM sia interessata dalla policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nel progetto.

  • PRIORITY_NUMBER: la priorità che vuoi impostare per la policy. Puoi specificare un numero intero compreso tra 0 e 65535.

  • DESCRIPTION: una descrizione della policy di estensione della VM.

Aggiorna una policy globale per includere nuove zone

Quando crei VM in una nuova zona dopo aver creato e implementato una policy globale, gestore di estensioni VM non applica automaticamente la policy alle VM nelle nuove zone. Per includere le VM in nuove zone, devi riavviare l'implementazione della policy globale.

Per riavviare l'implementazione di una policy globale, completa i seguenti passaggi:

  • Nel terminale o in Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies update e fornisci l'opzione --rollout-entry-uuid come segue:

    gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID

    Sostituisci quanto segue:

    • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di nuovo tentativo. Per crearne uno, puoi utilizzare qualsiasi generatore di UUID. Per saperne di più, consulta Riprova un'implementazione.

    • ROLLOUT_PLAN_OPTION: l'opzione di implementazione che vuoi applicare alla policy globale. I valori supportati sono slow_rollout (consigliato) e fast_rollout.

      • In alternativa, puoi utilizzare un piano di rilascio personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, consulta Informazioni sui piani di rilascio.
      • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

Aggiorna una policy globale per escludere le zone

Per aggiornare una policy globale in modo da escludere le zone, completa i seguenti passaggi:

  • Nel terminale o in Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies update e fornisci un piano di rilascio personalizzato che specifichi le zone in cui applicare la policy:

    gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID

    Sostituisci quanto segue:

    • NEW_CUSTOM_PLAN_NAME: il nome del nuovo piano di implementazione personalizzato che identifica le zone in cui applicare la policy. Per informazioni sulla creazione di piani di rilascio personalizzati, consulta Informazioni sui piani di rilascio.
    • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di nuovo tentativo. Per crearne uno, puoi utilizzare qualsiasi generatore di UUID. Per saperne di più, consulta Riprova un'implementazione.

Disinstalla l'agente da un parco risorse di VM

Per disinstallare l'agente per SAP dal tuo parco risorse di VM, devi eliminare la policy del gestore di estensioni VM che gestisce il parco risorse di VM.

Durante l'eliminazione di una policy, se un'altra policy attiva con priorità inferiore si applica a una VM e dichiara l'agente per SAP, l'agente rimane installato su quella VM in base alla policy con priorità inferiore.

Il gestore di estensioni VM rimuove l'agente da tutte le VM accessibili entro un minuto dall'eliminazione della policy. Se una VM non è accessibile perché l'agente guest è stato rimosso o la VM è stata eliminata, il gestore di estensioni VM salta l'eliminazione dell'agente per SAP. Se una VM di questo tipo diventa nuovamente disponibile, il gestore di estensioni VM rimuove l'agente per SAP in quel momento.

Per disinstallare l'agente per SAP dal tuo parco risorse di VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic sulla policy che gestisce l'agente per SAP nel tuo parco risorse di VM.

  3. Nella pagina Dettagli della policy di estensione, fai clic su Elimina e conferma l'eliminazione.

gcloud

A livello di zona

Per eliminare una policy di gestore di estensioni VM a livello di zona, utilizza il comando gcloud compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Sostituisci quanto segue:

  • POLICY_NAME: il nome della policy di zona che vuoi eliminare.
  • PROJECT_ID: l'ID del progetto Google Cloud in cui si trova la policy.
  • ZONE: la zona Google Cloud in cui si trova la policy.

Globale

Per eliminare una policy globale di gestore di estensioni VM, utilizza il comando gcloud compute global-vm-extension-policies delete:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION

Sostituisci quanto segue:

  • POLICY_NAME: il nome della policy di zona che vuoi eliminare.
  • PROJECT_ID: l'ID del progetto Google Cloud in cui si trova la policy.

  • ROLLOUT_PLAN_OPTION: l'opzione di implementazione che vuoi applicare alla policy globale. I valori supportati sono slow_rollout (consigliato) e fast_rollout.

    • In alternativa, puoi utilizzare un piano di rilascio personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, consulta Informazioni sui piani di rilascio.
    • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

Verifica la versione dell'agente

Google Cloud consiglia di installare l'ultima versione dell'agente per SAP per una valutazione accurata dei workload SAP, poiché le release periodiche dell'agente per 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, quindi 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

Installa un aggiornamento

Seleziona il tuo sistema operativo, quindi 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.16 (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

  1. Stabilisci una connessione SSH con l'istanza.
  2. Aggiorna l'istanza dell'agente:
    • (Consigliato) Per eseguire l'aggiornamento alla versione 3.16 (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.

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

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

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

  1. Stabilisci una connessione SSH con l'istanza Compute Engine.
  2. Esegui questo comando: 
    sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

    Se la configurazione di Google Cloud per la raccolta delle metriche di valutazione di Workload Manager è corretta, l'output include quanto segue. La tua 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)
    ...
  3. Se l'output indica che manca una parte della configurazione, consulta le informazioni fornite nelle sezioni precedenti, esegui le azioni richieste, quindi esegui nuovamente il comando status per convalidare nuovamente la configurazione.

File di configurazione di esempio

Gli esempi seguenti sono file di configurazione completi dell'agente per SAP diGoogle Cloudin esecuzione su unistanza 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 parametro di configurazione hdbuserstore_key è 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 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 invece 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
  }
}

Per informazioni sui parametri di configurazione supportati dall'agente per SAP, consulta Parametri di configurazione.

Passaggi successivi