Questa guida illustra le considerazioni operative e le procedure per l'esecuzione della versione 3.2 (più recente) dell'agente per SAP di Google Cloud su istanze VM di Compute Engine e server Bare Metal Solution.
Informazioni sul ciclo di vita dell'agente
Quando si gestiscono le operazioni dell'agente di Google Cloud per SAP, è utile capire cosa fa l'agente. Ecco come funziona in generale:
- Devi installare l'agente Google Cloud per SAP su ogni istanza VM di Compute Engine o server Bare Metal Solution che ospita sistemi SAP. L'agente viene eseguito come servizio Linux o Windows.
- Nelle istanze VM di Compute Engine, l'agente combina i dati di monitoraggio di Monitoring e delle API Compute Engine.
- Sui server Bare Metal Solution, per la raccolta solo delle metriche dell'agente host SAP, l'agente non accede alle API Google Cloud.
- L'agente host SAP esegue il polling dell'agente di Google Cloud per SAP in cerca dei dati memorizzati nella cache tramite HTTP. Aggrega le metriche dell'agente host SAP, le segnala e le archivia nel database SAP NetWeaver.
- La transazione SAP
ST06
o l'interfaccia a riga di comandosaposcol
mostra le metriche aggregate dell'agente host SAP. - Puoi visualizzare le metriche dell'agente host SAP dall'agente per SAP di Google Cloud eseguendo un comando in una finestra del terminale.
Verifica che l'agente sia in esecuzione
Dopo aver installato l'agente o averlo riavviato, puoi verificare che l'agente funzioni come previsto.
Per verificare se l'agente è in esecuzione:
Linux
Stabilisci una connessione SSH con il server o l'istanza VM di 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
Windows
Utilizza RDP per la connessione all'istanza VM.
In qualità di amministratore, esegui questo comando da PowerShell:
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Se l'agente è in esecuzione, lo stato mostraRunning
.
Se l'agente per SAP di Google Cloud non è in esecuzione, riavvia l'agente.
Controlla la versione dell'agente
Dopo aver installato o riavviato l'agente Google Cloud per SAP, puoi verificare la versione dell'agente.
Per controllare la versione dell'agente, completa i seguenti passaggi:
Linux
Per RHEL, procedi nel seguente modo:
- Utilizza SSH per connetterti alla macchina host.
- Esegui questo comando:
yum info google-cloud-sap-agent
Per SLES, segui questi passaggi:
- Utilizza SSH per connetterti alla macchina host.
- Esegui questo comando:
zypper info google-cloud-sap-agent
Windows
- Utilizza RDP per la connessione alla macchina host.
- In qualità di amministratore, esegui questo comando da PowerShell:
googet installed google-cloud-sap-agent
Elenco di tutte le versioni disponibili dell'agente
Per elencare tutte le versioni disponibili dell'agente per SAP di Google Cloud:
RHEL
Stabilisci una connessione SSH con l'host.
Esegui questo comando:
sudo yum list --showduplicates google-cloud-sap-agent
SLES
Stabilisci una connessione SSH con l'host.
Esegui questo comando:
sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent
Verificare che l'agente host SAP stia ricevendo le metriche
Per verificare che le metriche dell'infrastruttura vengano raccolte dall'agente per SAP di Google Cloud e inviate correttamente all'agente host SAP, segui questi passaggi:
- Nel tuo sistema SAP, inserisci la transazione
ST06
. Nel riquadro Panoramica, controlla la disponibilità e il contenuto dei seguenti campi per la corretta configurazione end-to-end dell'infrastruttura di monitoraggio SAP e Google:
- Cloud Provider:
Google Cloud Platform
- Accesso a Monitoring avanzato:
TRUE
- Dettagli sul monitoraggio avanzato:
ACTIVE
- Cloud Provider:
Visualizza le metriche dell'agente host SAP
Dopo aver installato o aggiornato la configurazione dell'agente di Google Cloud per SAP, puoi visualizzare le metriche raccolte dell'agente host SAP.
Per visualizzare le metriche dell'agente host SAP raccolte dall'agente di Google Cloud per SAP, segui questi passaggi:
Linux
Stabilisci una connessione SSH con l'istanza VM host del server Bare Metal Solution.
Esegui questo comando:
curl http://localhost:18181
Se le metriche sono disponibili, dovresti ricevere un output XML contenente informazioni sul tuo sistema. Ad esempio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <metrics> <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60"> <name>VM Processing Power Consumption</name> <value>0.0</value> </metric>
Windows
Utilizza RDP per la connessione all'istanza VM.
In qualità di amministratore, esegui questo comando da PowerShell:
(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent
Se le metriche sono disponibili, dovresti visualizzare un output XML contenente informazioni sul tuo sistema. Ad esempio:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <metrics> <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60"> <name>VM Processing Power Consumption</name> <value>10.0</value> </metric>
Visualizza le altre metriche
Dopo aver aggiornato la configurazione dell'agente Google Cloud per SAP per raccogliere le metriche di monitoraggio dei processi o di monitoraggio di SAP HANA, ti consigliamo di visualizzarle per verificare che l'agente stia raccogliendo le metriche come previsto.
Puoi visualizzare le metriche e le informazioni raccolte dall'agente per SAP di Google Cloud in Cloud Monitoring seguendo questi passaggi:
Nella console Google Cloud, vai alla pagina Metrics Explorer di Monitoring.
Seleziona la scheda Configurazione.
Espandi il menu Seleziona una metrica.
Nel menu Risorse, seleziona Istanza VM.
Nel menu Categoria metrica, seleziona sap.
Nel menu Metrica, seleziona
metric: workload.googleapis.com/sap/service/active
o una delle nuove metriche da tracciare.Fai clic su Applica.
Dovresti vedere un grafico con i valori delle metriche delle serie temporali.
Convalida la funzionalità Backint
Dopo aver attivato la funzionalità Backint dell'agente, devi convalidarla creando e ripristinando un backup.
Per le istruzioni, consulta Convalidare backup e ripristino.
Riavvia l'agente
Se l'agente Google Cloud per SAP smette di funzionare o ne aggiorni la configurazione, riavvia l'agente.
Seleziona il tuo sistema operativo, quindi segui i passaggi:
Linux
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Esegui questo comando:
sudo systemctl restart google-cloud-sap-agent
Windows
Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
Restart-Service -Name 'google-cloud-sap-agent' -Force
Esegui l'upgrade all'agente di Google Cloud per SAP da altri agenti Google Cloud
L'agente Google Cloud per SAP è il successore di altri agenti Google Cloud. Le sezioni seguenti forniscono informazioni per l'upgrade da questi agenti alla versione 3.2 (più recente) dell'agente per SAP di Google Cloud.
Per istruzioni sull'installazione e la configurazione dell'agente Google Cloud per SAP, consulta la guida alla scelta dell'agente Google Cloud per la configurazione SAP.
Upgrade dall'agente Backint Cloud Storage per SAP HANA
Per eseguire l'upgrade dall'agente Backint Cloud Storage per SAP HANA alla versione 3.2 (più recente), completa questi passaggi:
Assicurati che nessun backup dei dati sia in corso o pianificato per il periodo che si sovrappone all'upgrade.
Disabilita i backup automatici dei log impostando il parametro
enable_auto_log_backup
SAP HANA suno
. Per le istruzioni, consulta il documento SAP HANA Abilitare e disabilitare il backup automatico dei log.Installare l'agente Google Cloud per SAP. Per istruzioni, consulta la guida all'installazione per il tuo scenario.
Abilita la funzionalità Backint dell'agente per SAP di Google Cloud. Per le istruzioni, consulta Configurare il backup e il ripristino basati su Backint.
L'abilitazione della funzionalità Backint dell'agente per SAP di Google Cloud rileva automaticamente l'agente Backint sull'host e lo disabilita dalla macchina host.
Per creare una versione JSON del file di testo di configurazione Backint esistente, esegui questo comando per ognuno dei file di testo:
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
Sostituisci
PATH_TO_PARAMETERS_FILE
con il percorso del filePARAMETERS.txt
.I file JSON vengono creati nella stessa posizione nel file system dei file di testo, a condizione che l'agente per SAP di Google Cloud disponga dell'autorizzazione per accedere a queste posizioni. Sebbene l'agente per SAP di Google Cloud sia in grado di interpretare i parametri relativi a Backint specificati nel file di testo, ti consigliamo di utilizzare i file JSON per aggiornare qualsiasi configurazione.
Abilita i backup automatici dei log impostando il parametro
enable_auto_log_backup
per SAP HANA suyes
. Per le istruzioni, consulta il documento SAP HANA Abilitare e disabilitare il backup automatico dei log.
Quando esegui questo upgrade, si verifica quanto segue:
- A scopo di backup e riferimento, tutti i file di installazione nella directory
backint-gcs
dell'agente Backint vengono copiati inbackint-gcs-old-TIMESTAMP/
. Questi campi sono obbligatori nel caso in cui sia necessario tornare a utilizzare l'agente Backint. - La cartella
backint-gcs
viene quindi ripulita per contenere solo i file necessari per eseguire l'agente per SAP di Google Cloud, che include il file di configurazioneparameters.json
e i file di configurazione Backint, ad esempioPARAMETERS.txt
.
Per informazioni sulla mappatura dei parametri di configurazione tra l'agente Backint e l'agente per SAP di Google Cloud, espandi la sezione seguente.
Mappatura dei parametri di configurazione
Nome parametro nell'agente Backint | Nome parametro nell'agente per SAP di Google Cloud |
---|---|
BUCKET |
bucket |
DISABLE_COMPRESSION |
compress |
ENCRYPTION_KEY |
encryption_key |
KMS_KEY_NAME |
kms_key |
MAX_GCS_RETRY |
retries |
PARALLEL_FACTOR |
parallel_streams |
PARALLEL_PART_SIZE |
Questa azione non è disponibile nell'agente per SAP di Google Cloud. |
RATE_LIMIT_MB |
rate_limit_mb |
SERVICE_ACCOUNT |
service_account_key |
THREADS |
thread |
READ_IDLE_TIMEOUT |
file_read_timeout_ms |
CHUNK_SIZE_MB |
buffer_size_mb |
HTTP_READ_TIMEOUT |
Questa azione non è disponibile nell'agente per SAP di Google Cloud. |
Upgrade dall'agente di monitoraggio per SAP HANA
L'installazione della versione 3.2 (più recente) dell'agente per SAP di Google Cloud rileva automaticamente le versioni dell'agente di monitoraggio per SAP HANA, le disattiva e quindi le rimuove dalle macchine host durante l'installazione.
Se questo agente viene rilevato, la sua configurazione viene migrata all'agente per SAP di Google Cloud durante l'installazione. A fini di backup e riferimento, la configurazione dell'agente di monitoraggio per SAP HANA viene copiata nel seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Upgrade delle istanze abilitate per SSL
Se hai configurato l'agente di monitoraggio per SAP HANA in modo che utilizzi i certificati SSL per la comunicazione con le tue istanze SAP HANA, quando installi l'agente di Google Cloud per SAP viene eseguita la migrazione di tutta la configurazione di monitoraggio di SAP HANA, ad eccezione della configurazione SSL, all'agente per SAP di Google Cloud. In questo caso, per utilizzare l'agente per SAP di Google Cloud per il monitoraggio delle istanze SAP HANA, devi completare i seguenti passaggi:
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Apri il file di configurazione dell'agente per SAP di Google Cloud:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sutrue
.Nella sezione
hana_monitoring_configuration.hana_instances
, esegui le operazioni seguenti per ogni istanza SAP HANA che utilizza il protocollo TLS/SSL per le comunicazioni sicure:Specifica il parametro
enable_ssl
e impostane il valore sutrue
.Specifica il parametro
host_name_in_certificate
e imposta come valore il nome host SAP HANA, come specificato nel certificato TLS/SSL.Specifica il parametro
tls_root_ca_file
e imposta il percorso in cui è archiviato il certificato TLS/SSL.
Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Verifica che l'agente stia raccogliendo le metriche di monitoraggio SAP HANA. Per istruzioni, consulta Visualizzare le altre metriche.
Disinstalla l'agente di monitoraggio per SAP HANA.
Se riscontri problemi di connessione con le tue istanze SAP HANA dopo questo upgrade, puoi visualizzare i log dell'agente in Logging e utilizzare la guida alla risoluzione dei problemi per risolvere il problema.
Upgrade dall'agente di monitoraggio per SAP NetWeaver
L'installazione della versione 3.2 (più recente) dell'agente per SAP di Google Cloud rileva automaticamente le versioni dell'agente di monitoraggio per SAP NetWeaver.
Se questo agente viene rilevato, la sua configurazione viene migrata all'agente per SAP di Google Cloud durante l'installazione.
Aggiorna l'agente Google Cloud per SAP
Per assicurarti di disporre della versione più recente dell'agente Google Cloud per SAP, devi verificare periodicamente la disponibilità di aggiornamenti e aggiornare l'agente.
Verifica la disponibilità di aggiornamenti
Seleziona il tuo sistema operativo, quindi 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
Windows
- Stabilisci una connessione RDP con l'istanza VM host.
- In qualità di amministratore, esegui questo comando da PowerShell:
googet latest google-cloud-sap-agent
Installa un aggiornamento
Seleziona il tuo sistema operativo, quindi segui i passaggi:
RHEL
- Stabilisci una connessione SSH con l'istanza.
- Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (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 esempio3.1-606637668
. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni disponibili dell'agente.
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (più recente) dell'agente:
SLES
- Stabilisci una connessione SSH con l'istanza.
- Aggiorna l'istanza dell'agente:
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (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 esempio3.1-606637668
. Per informazioni sulle versioni dell'agente che puoi installare, consulta Elenco di tutte le versioni disponibili dell'agente.
- (Consigliato) Per eseguire l'aggiornamento alla versione 3.2 (più recente) dell'agente:
Windows
- Stabilisci una connessione RDP con l'istanza VM host.
- Per eseguire l'aggiornamento alla versione 3.2 (più recente) dell'agente, in qualità di amministratore, esegui questo comando da PowerShell:
googet install google-cloud-sap-agent
Esegui il rollback all'utilizzo degli altri agenti Google Cloud
Questa sezione fornisce informazioni sul rollback dall'utilizzo della versione 3.2 (più recente) dell'agente per SAP di Google Cloud e sull'utilizzo degli agenti precedenti.
Esegui il rollback all'utilizzo dell'agente Backint
Se vuoi eseguire il rollback all'agente Backint e interrompere l'utilizzo della funzionalità Backint dell'agente per SAP di Google Cloud, segui questi passaggi:
Elimina tutti i file relativi alla funzionalità Backint dell'agente per SAP di Google Cloud:
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
Sostituisci
SID
con il SID del tuo sistema SAP.Ripristina i file dell'agente Backint archiviati come backup quando hai eseguito l'upgrade all'utilizzo dell'agente di Google Cloud per SAP copiandoli nella directory
backint-gcs
:cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
Sostituisci quanto segue:
SID
: il SID del tuo sistema SAPTIMESTAMP
: il valore del timestamp nel nome della cartella creata quando hai eseguito l'upgrade dall'agente Backint all'agente per SAP di Google Cloud
Utilizza SAP HANA Studio o SAP HANA Cockpit per modificare il file
global.ini
e aggiornare i percorsi dei file di configurazione.txt
. Per informazioni sui parametri per i quali devi specificare il percorso dei file.txt
, consulta Configurare SAP HANA per la funzionalità Backint.Salva le modifiche apportate al file
global.ini
.
Esegui il rollback all'utilizzo dell'agente di monitoraggio per SAP HANA
Se vuoi eseguire il rollback all'agente di monitoraggio per SAP HANA e interrompere l'utilizzo della funzionalità di monitoraggio SAP HANA dell'agente per SAP di Google Cloud, segui questi passaggi:
RHEL
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente per SAP di Google Cloud:
Apri il file di configurazione dell'agente per SAP di Google Cloud:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sufalse
.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Installare l'agente di monitoraggio per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e al funzionamento dell'agente Monitoring per SAP HANA V2.0.
Nel file seguente, incolla la configurazione dell'agente di monitoraggio per SAP HANA che hai copiato in un passaggio precedente:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Riavvia l'agente di monitoraggio per SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
SLES
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Per impedire la raccolta di metriche duplicate, disabilita la raccolta delle metriche di monitoraggio SAP HANA da parte dell'agente per SAP di Google Cloud:
Apri il file di configurazione dell'agente per SAP di Google Cloud:
/etc/google-cloud-sap-agent/configuration.json
Nella sezione
hana_monitoring_configuration
, imposta il parametroenabled
sufalse
.Salva il file di configurazione.
Riavvia l'agente per applicare le nuove impostazioni:
sudo systemctl restart google-cloud-sap-agent
Copia la configurazione dell'agente di monitoraggio per SAP HANA dal seguente file:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Installare l'agente di monitoraggio per SAP HANA versione 2. Per le istruzioni di installazione, consulta la guida all'installazione e al funzionamento dell'agente Monitoring per SAP HANA V2.0.
Nel file seguente, incolla la configurazione dell'agente di monitoraggio per SAP HANA che hai copiato in un passaggio precedente:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Riavvia l'agente di monitoraggio per SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
Disinstalla l'agente
Per disinstallare o rimuovere l'agente dall'host:
RHEL
Stabilisci una connessione SSH con l'host.
Esegui questo comando:
sudo yum remove google-cloud-sap-agent
SLES
Stabilisci una connessione SSH con l'host.
Esegui questo comando:
sudo zypper remove google-cloud-sap-agent
Windows
Stabilisci una connessione RDP con l'istanza VM host.
In qualità di amministratore, esegui questo comando da PowerShell:
Remove-Service -Name 'google-cloud-sap-agent'
Visualizza i log dell'agente in Cloud Logging
Per impostazione predefinita, i log dell'agente di Google Cloud per SAP vengono reindirizzati dalle istanze VM e dai server Bare Metal Solution a Cloud Logging.
Per visualizzare i log dell'agente in Logging, segui questi passaggi:
Nella console Google Cloud, vai alla pagina Esplora log.
Vai al riquadro Query.
Dal menu a discesa Risorse, seleziona Globale e fai clic su Applica.
Nell'editor query, inserisci
google-cloud-sap-agent
.Fai clic su Esegui query.
Dovresti visualizzare i log generati dalle istanze dell'agente in esecuzione su tutte le istanze VM o sui server Bare Metal Solution. Per filtrare i log da una macchina specifica, utilizza i filtri disponibili nell'interfaccia.
Puoi disabilitare il reindirizzamento predefinito dei log dell'agente interessati dalla raccolta delle metriche. Per farlo, segui questa procedura.
Stabilisci una connessione SSH con l'istanza VM host o il server Bare Metal Solution.
Apri il file di configurazione seguente:
/etc/google-cloud-sap-agent/configuration.json
Per il parametro
log_to_cloud
, aggiorna il valore infalse
.Salva il file di configurazione.
Riavvia l'agente per applicare la modifica.
Per disattivare il reindirizzamento predefinito dei log relativi alla funzionalità Backint dell'agente per SAP di Google Cloud, modifica il file di configurazione Backint e imposta il parametro log_to_cloud
su false
.