Per il supporto SAP di sistemi SAP in esecuzione su un server Bare Metal Solution, è richiesto l'agente Google Cloud per SAP.
Se utilizzi le seguenti immagini di sistema operativo RHEL o SLES "for SAP" fornite da Google Cloud, l'agente di Google Cloud per SAP viene pacchettizzato con le immagini del sistema operativo:
- RHEL: tutte le immagini "per SAP"
- SLES: SLES 15 SP4 per SAP e versioni successive
Per informazioni sui sistemi operativi disponibili per l'esecuzione di SAP sui server Bare Metal Solution, consulta le seguenti pagine:
- Per SAP HANA, vedi Sistemi operativi certificati.
- Per SAP NetWeaver, vedi Sistemi operativi certificati.
Per installare e configurare la versione 3.3 (più recente) dell'agente di Google Cloud per SAP su un'istanza VM di Compute Engine, consulta Installare l'agente Google Cloud per SAP su un'istanza VM di Compute Engine.
Panoramica dell'installazione
Puoi installare l'agente di Google Cloud per SAP utilizzando i comandi standard per la gestione
dei pacchetti del sistema operativo: su RHEL, il comando yum
; su SLES, il
comando zypper
. Il comando di gestione dei pacchetti completa le seguenti attività:
- Scarica l'ultima versione dell'agente di Google Cloud per SAP.
- Crea l'agente come servizio
systemd
Linux, denominatogoogle-cloud-sap-agent
. - Abilita e avvia il servizio,
google-cloud-sap-agent
.
Installa l'agente
Per installare l'agente Google Cloud per SAP su un server Bare Metal Solution, segui questi passaggi:
Stabilisci una connessione SSH al server Bare Metal Solution.
Nel terminale, installa l'agente eseguendo il comando specifico per il tuo sistema operativo:
- (Consigliato) Per installare la versione 3.3 (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 esempio3.1-606637668
. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni disponibili dell'agente.
- (Consigliato) Per installare la versione 3.3 (più recente) dell'agente:
Apri il seguente file di configurazione:
/etc/google-cloud-sap-agent/configuration.json
In alternativa, puoi anche eseguire questa configurazione con i comandi. Per maggiori informazioni, consulta Comandi di configurazione per l'agente di Google Cloud per SAP.
Modifica o aggiungi i seguenti parametri al file di configurazione:
- Nella prima sezione:
bare_metal
: impostata sutrue
.
- Aggiungi la sezione
cloud_properties
e specifica i seguenti parametri:project_id
: specifica il tuo progetto Google Cloudinstance_name
: specifica il nome del server Bare Metal Solutionregion
: specifica la regione del server Bare Metal Solution
- Nella prima sezione:
Salva il file di configurazione.
Riavvia l'agente:
sudo systemctl restart google-cloud-sap-agent
Dopo aver installato l'agente di Google Cloud per SAP e l'agente host SAP, convalida l'installazione dell'agente di Google Cloud per SAP, come descritto in Convalidare l'installazione dell'agente.
Convalida l'installazione dell'agente
Stabilisci una connessione SSH con il server Bare Metal Solution.
Esegui questo comando:
systemctl status google-cloud-sap-agent
Se l'agente funziona correttamente, l'output contiene
active (running)
. Ad esempio:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled) Active: active (running) since Fri 2022-12-02 07:21:42 UTC; 4 days ago Main PID: 1337673 (google-cloud-sa) Tasks: 9 (limit: 100427) Memory: 22.4 M (max: 1.0G limit: 1.0G) CGroup: /system.slice/google-cloud-sap-agent.service └─1337673 /usr/bin/google-cloud-sap-agent
Se l'agente non è in esecuzione, riavvialo.
Verifica che l'agente host SAP stia ricevendo le metriche
Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente di Google Cloud per SAP e inviate correttamente all'agente host SAP, segui questi passaggi:
- Nel sistema SAP, inserisci la transazione
ST06
. Nel riquadro Panoramica, verifica la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Provider cloud:
Google Cloud Platform
- Accesso a monitoraggio avanzato:
TRUE
- Dettagli sul monitoraggio avanzato:
ACTIVE
- Provider cloud:
Configura l'agente Google Cloud per SAP su Linux
Dopo aver installato l'agente per SAP di Google Cloud, facoltativamente, puoi abilitare altre funzionalità dell'agente eseguendo le seguenti configurazioni. Per impostazione predefinita, è abilitata la raccolta delle metriche di SAP Host Agent e delle metriche di valutazione di Workload Manager.
Prerequisiti
Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente Bare Metal Solution, devi completare i seguenti prerequisiti:
- Crea un account di servizio IAM per consentire all'agente di accedere alle risorse Google Cloud e poi concedi i ruoli IAM richiesti all'account di servizio. Per maggiori dettagli, consulta Configurare un account di servizio.
- Installa gcloud CLI sul server Bare Metal Solution. Per maggiori dettagli, consulta Installare gcloud CLI.
- Per accedere a Google Cloud, autorizza gcloud CLI. Per maggiori dettagli, consulta Autorizzare gcloud CLI.
- Stabilisci una connessione alle API Google Cloud. Per i dettagli, consulta Configurare l'accesso privato Google per gli host on-premise.
Configurare un account di servizio
Per consentire all'agente di accedere alle risorse Google Cloud da un ambiente Bare Metal Solution, devi configurare un account di servizio IAM.
Come minimo, l'account di servizio utilizzato dall'agente deve includere il ruolo Workload Manager Insights Writer (roles/workloadmanager.insightWriter
).
Per creare un account di servizio, segui questi passaggi:
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Workload Manager > Workload Manager Insights Writer role to the service account.
To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights Writer.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
Dopo aver creato l'account di servizio, assicurati di caricare il relativo file di chiave JSON in una posizione sicura sul server Bare Metal Solution accessibile all'agente.
Abilita le funzionalità
Dopo aver configurato un account di servizio per la soluzione Bare Metal Solution e avergli concesso i ruoli richiesti, puoi abilitare altre funzionalità dell'agente Google Cloud per SAP eseguendo le seguenti configurazioni:
- Configura la raccolta delle metriche di Process Monitoring
- Configura la raccolta delle metriche di valutazione del Gestore carichi di lavoro
- Configura la raccolta delle metriche di monitoraggio di SAP HANA.
- Configura il backup e il ripristino basati su Backint per SAP HANA.
File di configurazione predefinito
Lo snippet seguente è un esempio della configurazione predefinita della versione 3.3 (più recente) dell'agente Google Cloud per SAP:
{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Per visualizzare esempi di file di configurazione specifici per le funzionalità, consulta la guida alla configurazione per la funzionalità in questione.
Parametri di configurazione
La tabella seguente descrive i parametri di configurazione dell'Agente per SAP di Google Cloud in esecuzione su un server Bare Metal Solution, inclusi i parametri relativi alla raccolta delle metriche. Per informazioni sui parametri di configurazione relativi alla funzionalità Backint dell'agente, consulta Parametri di configurazione.
Parametri | |
---|---|
provide_sap_host_agent_metrics |
Per abilitare la raccolta delle metriche richieste da SAP Host Agent, specifica |
bare_metal |
Quando l'agente è installato su un server Bare Metal Solution, specifica
|
log_level |
Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti:
Il valore predefinito è |
log_to_cloud |
Per reindirizzare i log dell'agente a
Cloud Logging, specifica
|
cloud_properties.project_id |
Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica l'ID del progetto Google Cloud che stai utilizzando con Bare Metal Solution. |
cloud_properties.instance_name
|
Specifica il nome del server Bare Metal Solution su cui hai installato l'agente. |
cloud_properties.region |
Se il tuo sistema SAP è in esecuzione su un server Bare Metal Solution, specifica la regione del server Bare Metal Solution. |
cloud_properties.zone |
Per impostazione predefinita, quando l'agente viene eseguito su un'istanza VM utilizza la zona dell'istanza VM in cui è installato. |
cloud_properties.image |
Specifica il nome dell'immagine del sistema operativo dell'istanza. |
cloud_properties.numeric_project_id |
Specifica l'ID numerico del progetto Google Cloud in cui è in esecuzione il sistema SAP. |
discovery_configuration.enable_workload_discovery |
Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP
in esecuzione sull'host, specifica Per maggiori informazioni, consulta il codebase dell'agente nel repository GitHub di |
discovery_configuration.enable_discovery |
Per inviare a Cloud Logging le informazioni raccolte dall'agente sui prodotti SAP in esecuzione sull'host, specifica Se specifichi il valore |
collection_configuration.collect_process_metrics |
Per abilitare la raccolta delle metriche di Process Monitoring, specifica |
collection_configuration.process_metrics_frequency |
A partire dalla versione 2.6, questo parametro determina la frequenza di raccolta in secondi delle
metriche di Process Monitoring in rapida evoluzione. Le metriche di monitoraggio dei processi in rapida evoluzione sono: Il valore predefinito di questo parametro è Tutte le altre metriche di Process Monitoring (in lento cambiamento) vengono raccolte con una frequenza predefinita di 30 secondi. Per modificare la frequenza di raccolta delle metriche di Process Monitoring che cambiano lentamente, utilizza il parametro |
collection_configuration.slow_process_metrics_frequency |
Specifica la frequenza di raccolta delle metriche di Process Monitoring che cambiano lentamente, in secondi. Il valore predefinito di questo parametro è |
collection_configuration.process_metrics_to_skip |
Specifica le metriche di monitoraggio dei processi che non vuoi che l'agente raccolga. Questo parametro accetta un
valore separato da virgole dei nomi delle metriche di Process Monitoring. Ad esempio:
|
collection_configuration.hana_metrics_config.hana_db_user |
Specifica l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. Il valore predefinito è |
collection_configuration.hana_metrics_config.hana_db_password |
Specifica la password in testo normale per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA. Anziché specificare una password in testo normale, ti consigliamo di utilizzare una delle seguenti opzioni:
|
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
Per fornire in modo sicuro la password per l'account utente del database che l'agente utilizza per eseguire query su SAP HANA, specifica il nome del secret che contiene le credenziali di sicurezza per l'account utente del database. L'agente raccoglie le metriche correlate a SAP HANA solo se specifichi |
collection_configuration.hana_metrics_config.hdbuserstore_key
|
Per autenticare l'utente SAP HANA specificato per Per utilizzare una chiave
|
collection_configuration.hana_metrics_config.sid |
Specifica il SID della tua istanza SAP HANA. |
collection_configuration.collect_workload_validation_metrics |
Per abilitare la raccolta delle metriche di valutazione del Gestore carichi di lavoro,
specifica |
collection_configuration.workload_validation_metrics_frequency |
La frequenza di raccolta delle metriche di valutazione del Gestore carichi di lavoro
in secondi. Il valore predefinito è Se devi modificare la frequenza di raccolta delle metriche di Gestore carichi di lavoro, aggiungi il parametro |
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Facoltativo. Il valore predefinito è |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. L'account utente deve disporre dell'autorizzazione di lettura per il database SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. In alternativa, puoi specificare il parametro di configurazione |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Per autenticare l'utente SAP HANA specificato per Per utilizzare una chiave
Se specifichi |
collection_configuration.workload_validation_db_metrics_config.sid |
Specifica il SID della tua istanza SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:
|
collection_configuration.workload_validation_db_metrics_config.port |
Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è |
collection_configuration.workload_validation_db_metrics_frequency |
La frequenza di raccolta delle metriche del database SAP HANA, in secondi, per la valutazione di Workload Manager.
Il valore predefinito è |
hana_monitoring_configuration.enabled |
Facoltativo. Per consentire all'agente di Google Cloud per SAP di raccogliere le metriche di monitoraggio SAP HANA, specifica hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio, in secondi, che determina la frequenza con cui l'Agente per SAP di Google Cloud esegue query sulle tue istanze SAP HANA per raccogliere le metriche di monitoraggio SAP HANA. Il valore predefinito è 300 secondi. Per ogni query definita nel file di configurazione dell'agente per SAP di Google Cloud, puoi sovrascrivere l'intervallo di campionamento globale specificando l'intervallo richiesto per il parametro |
hana_monitoring_configuration.query_timeout_sec |
Facoltativo. Specifica il timeout per ogni query effettuata sulle istanze SAP HANA. Il valore predefinito è 300 secondi. |
hana_monitoring_configuration.execution_threads |
Facoltativo. Specifica il numero di thread utilizzati per inviare query alle istanze SAP HANA. Ogni query viene eseguita sul proprio thread. Il valore predefinito è 10. |
hana_monitoring_configuration.hana_instances.name |
Specifica l'identificatore del nome per la tua istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
Specifica il SID della tua istanza SAP HANA. Questa stringa viene aggiunta come etichetta a tutte le metriche risultanti dalle query sulle tue istanze SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
Specifica l'identificatore della macchina, locale o remota, che ospita l'istanza SAP HANA. Di seguito sono riportati i valori supportati:
|
hana_monitoring_configuration.hana_instances.port |
Specifica la porta su cui la tua istanza SAP HANA accetta le query. Per la prima o unica istanza di database tenant, la porta è |
hana_monitoring_configuration.hana_instances.user |
Specifica l'account utente utilizzato per eseguire query sull'istanza SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
Facoltativo. Specifica la password, come testo normale, che autentica l'account utente per eseguire query sull'istanza SAP HANA. Per l'autenticazione, devi specificare una delle seguenti opzioni:
|
hana_monitoring_configuration.hana_instances.secret_name |
Facoltativo. Specifica il nome del secret in Secret Manager in cui è archiviata la password dell'account utente. |
hana_monitoring_configuration.hana_instances.hdbuserstore_key
|
Per autenticare l'utente SAP HANA specificato per Per utilizzare una chiave
Se specifichi |
hana_monitoring_configuration.hana_instances.enable_ssl |
Facoltativo. Specifica se SSL è abilitato o meno nella tua istanza SAP HANA. Il valore predefinito è |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Se specifichi |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Se specifichi |
hana_monitoring_configuration.queries.enabled |
Facoltativo. Per abilitare una query SQL per tutte le tue istanze SAP HANA, specifica il valore |
hana_monitoring_configuration.queries.name |
Se hai definito query personalizzate nel file di configurazione, devi specificare un nome univoco per ciascuna. Il nome della query deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.sql |
Specifica l'istruzione SQL che l'agente emette alle tue istanze SAP HANA. L'istruzione SQL deve essere conforme alla sintassi SQL definita da SAP in SAP HANA SQL e System views (Riferimento sulle visualizzazioni di sistema e SAP HANA). |
hana_monitoring_configuration.queries.sample_interval_sec |
Facoltativo. Specifica l'intervallo di esempio per la query SQL. Questa operazione sostituisce l'intervallo di campionamento globale. Il valore deve essere di almeno 5 secondi. |
hana_monitoring_configuration.queries.columns.name |
Specifica un nome che identifichi in modo univoco ogni colonna. Il nome colonna deve essere univoco perché viene utilizzato per creare l'URL predefinito della metrica in Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Per la gestione tramite Monitoring, specifica uno dei seguenti
tipi di metriche: Le metriche di tipo |
hana_monitoring_configuration.queries.columns.value_type |
Per la gestione da parte di Monitoring, specifica un tipo di dati supportato dal tipo di metrica. I tipi di dati supportati sono i seguenti: |
hana_monitoring_configuration.queries.columns.name_override |
Facoltativo. Per la gestione da parte di Monitoring, specifica il percorso che vuoi mostrare nell'URL della metrica anziché i nomi delle query e delle colonne. Ad esempio:
|
Risoluzione dei problemi
Per informazioni su come diagnosticare e risolvere i problemi che potresti riscontrare durante l'installazione e la configurazione dell'agente di Google Cloud per SAP, consulta la guida alla risoluzione dei problemi di Agent for SAP di Google Cloud.
Richiedi assistenza
Se hai bisogno di aiuto per risolvere i problemi con l'agente di Google Cloud per SAP, raccogli tutte le informazioni diagnostiche disponibili e contatta l'assistenza clienti Google Cloud. Per informazioni su come contattare l'assistenza clienti, vedi Ottenere assistenza per SAP su Google Cloud.