En esta guía, se abordan las consideraciones operativas y los procedimientos para ejecutar la versión 3.2 (más reciente) del agente de Google Cloud para SAP en instancias de VM de Compute Engine y servidores de la solución Bare Metal.
Comprende el ciclo de vida del agente
Cuando administras las operaciones del agente de Google Cloud para SAP, es útil comprender lo que hace el agente. En general, funciona de la siguiente manera:
- Debes instalar el agente de Google Cloud para SAP en cada instancia de VM de Compute Engine o servidor de solución Bare Metal que aloja sistemas SAP. El agente se ejecuta como un servicio de Linux o Windows.
- En las instancias de VM de Compute Engine, el agente combina los datos de supervisión de Monitoring y las APIs de Compute Engine.
- En los servidores de la solución Bare Metal, el agente no accede a las APIs de Google Cloud para recopilar solo las métricas de SAP Host Agent.
- SAP Host Agent solicita al agente de Google Cloud para SAP sus datos almacenados en caché a través de HTTP. Agrega las métricas de SAP Host Agent, las informa y las almacena en la base de datos de SAP NetWeaver.
- La transacción
ST06
de SAP o la interfaz de línea de comandossaposcol
muestran las métricas agregadas de SAP Host Agent. - Puedes ver las métricas de SAP Host Agent del agente de Google Cloud para SAP si ejecutas un comando en una ventana de la terminal.
Verifica que el agente esté en ejecución
Después de instalar o reiniciar el agente, puedes verificar que el agente se ejecute como se espera.
Para verificar si el agente está en ejecución, sigue estos pasos:
Linux
Establece una conexión SSH con el servidor de la solución Bare Metal o la instancia de VM.
Ejecuta el siguiente comando:
systemctl status google-cloud-sap-agent
Si el agente funciona de forma correcta, el resultado contendrá
active (running)
. Por ejemplo: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
Usa RDP para conectarte a la instancia de VM.
Como administrador, ejecuta el siguiente comando desde PowerShell:
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Si el agente está en ejecución, el estado muestraRunning
.
Si el agente de Google Cloud para SAP no está en ejecución, reinicia el agente.
Verifica la versión del agente
Después de instalar o reiniciar el agente de Google Cloud para SAP, puedes verificar la versión del agente.
Para ver la versión de tu agente, completa los siguientes pasos:
Linux
Para RHEL, sigue estos pasos:
- Usa SSH para conectarte a la máquina anfitrión.
- Ejecuta el siguiente comando:
yum info google-cloud-sap-agent
Para SLES, sigue estos pasos:
- Usa SSH para conectarte a la máquina anfitrión.
- Ejecuta el siguiente comando:
zypper info google-cloud-sap-agent
Windows
- Usa RDP para conectarte a la máquina anfitrión.
- Como administrador, ejecuta el siguiente comando desde PowerShell:
googet installed google-cloud-sap-agent
Obtén una lista de todas las versiones disponibles del agente
Si deseas obtener una lista de todas las versiones disponibles del agente de Google Cloud para SAP, haz lo siguiente:
RHEL
Establece una conexión SSH con tu host.
Ejecuta el siguiente comando:
sudo yum list --showduplicates google-cloud-sap-agent
SLES
Establece una conexión SSH con tu host.
Ejecuta el siguiente comando:
sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent
Verifica que SAP Host Agent reciba métricas
Para verificar que el Agente de Google Cloud para SAP recopile las métricas de infraestructura y que se envíen de forma correcta al agente de host SAP, sigue estos pasos:
- En el sistema SAP, ingresa la transacción
ST06
. En el panel de descripción general, revisa la disponibilidad y el contenido de los siguientes campos para verificar la configuración completa y correcta de la infraestructura de supervisión de SAP y Google:
- Proveedor de servicios en la nube:
Google Cloud Platform
- Acceso de supervisión mejorada:
TRUE
- Detalles de supervisión mejorada:
ACTIVE
- Proveedor de servicios en la nube:
Visualiza las métricas de SAP Host Agent
Después de instalar o actualizar la configuración del agente de Google Cloud para SAP, puedes ver las métricas recopiladas de SAP Host Agent.
Si deseas ver las métricas de SAP Host Agent que recopila el agente de Google Cloud para SAP, sigue estos pasos:
Linux
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Ejecuta el siguiente comando:
curl http://localhost:18181
Si las métricas están disponibles, deberías recibir un resultado XML que contenga información sobre tu sistema. Por ejemplo:
<?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
Usa RDP para conectarte a la instancia de VM.
Como administrador, ejecuta el siguiente comando desde PowerShell:
(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent
Si las métricas están disponibles, deberías ver un resultado de XML que contenga información sobre tu sistema. Por ejemplo:
<?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>
Visualiza las otras métricas
Después de actualizar la configuración del agente de Google Cloud para SAP con el fin de recopilar las métricas de Process Monitoring o las métricas de supervisión de SAP HANA, recomendamos verlas para verificar que el agente esté recopilando las métricas como se esperaba.
Si completas estos pasos, puedes ver las métricas y la información que recopila el agente de Google Cloud para SAP en Cloud Monitoring:
En la consola de Google Cloud, ve a la página Explorador de métricas de Cloud Monitoring.
Selecciona la pestaña Configuración.
Expande el menú Seleccionar una métrica.
En el menú Recursos activos, selecciona Instancia de VM.
En el menú Categoría de métrica, selecciona sap.
En el menú Métrica, selecciona
metric: workload.googleapis.com/sap/service/active
o cualquiera de las métricas nuevas para representar.Haz clic en Aplicar.
Deberías ver un gráfico con los valores de la métrica de series temporales.
Valida la función de Backint
Después de habilitar la función de Backint del agente, debes validarla mediante la creación y el restablecimiento de una copia de seguridad.
Para obtener instrucciones, consulta Valida la copia de seguridad y recuperación.
Reinicia el agente
Si el agente de Google Cloud para SAP deja de funcionar o actualizas su configuración, reinicia el agente.
Selecciona tu sistema operativo y, luego, sigue estos pasos:
Linux
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Ejecuta el siguiente comando:
sudo systemctl restart google-cloud-sap-agent
Windows
Establece una conexión RDP con la VM del host.
Como administrador, ejecuta el siguiente comando desde PowerShell:
Restart-Service -Name 'google-cloud-sap-agent' -Force
Actualiza al agente de Google Cloud para SAP desde otros agentes de Google Cloud
El agente de Google Cloud para SAP es el sucesor de otros agentes de Google Cloud. En las siguientes secciones, se proporciona información para actualizar de estos agentes a la versión 3.2 (más reciente) del agente de Google Cloud para SAP.
Si quieres obtener instrucciones para instalar y configurar el agente de Google Cloud para SAP, consulta la Guía de instalación y configuración del agente de Google Cloud para SAP.
Actualiza desde el agente de Backint de Cloud Storage para SAP HANA
Para actualizar el agente de Backint de Cloud Storage para SAP HANA a la versión 3.2 (más reciente), completa los siguientes pasos:
Asegúrate de que no haya copias de seguridad de datos en curso ni programadas para el período que se superpone con la actualización.
Para inhabilitar las copias de seguridad automáticas de registros, establece el parámetro
enable_auto_log_backup
de SAP HANA enno
. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.Instala el agente de Google Cloud para SAP Para obtener instrucciones, consulta la guía de instalación de tu situación.
Habilita la función de Backint del agente de Google Cloud para SAP. Para obtener instrucciones, consulta Configura la copia de seguridad y recuperación basadas en Backint.
Si habilitas la función de Backint del agente de Google Cloud para SAP, se detecta de forma automática el agente de Backint en tu host y lo inhabilita desde la máquina anfitriona.
Para crear una versión JSON de tu archivo de texto de configuración de Backint existente, ejecuta el siguiente comando para cada uno de tus archivos de texto:
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
Reemplaza
PATH_TO_PARAMETERS_FILE
por la ruta de acceso a tu archivoPARAMETERS.txt
.Los archivos JSON se crean en la misma ubicación del sistema de archivos que los archivos de texto, siempre que el agente de Google Cloud para SAP tenga permiso para acceder a esas ubicaciones. Si bien el agente de Google Cloud para SAP puede interpretar los parámetros relacionados de Backint especificados en el archivo de texto, te recomendamos que uses los archivos JSON para actualizar cualquier configuración.
Para habilitar las copias de seguridad automáticas de registros, establece el parámetro
enable_auto_log_backup
de SAP HANA enyes
. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.
Cuando realizas esta actualización, sucede lo siguiente:
- Para fines de copia de seguridad y referencia, todos los archivos de instalación en el directorio
backint-gcs
del agente de Backint se copian enbackint-gcs-old-TIMESTAMP/
. Estos son obligatorios en caso de que necesites volver a usar el agente de Backint. - La carpeta
backint-gcs
se limpia luego para que contenga solo los archivos necesarios a fin de ejecutar el agente de Google Cloud para SAP, que incluye su archivo de configuración,parameters.json
, y los archivos de configuración de Backint, comoPARAMETERS.txt
.
Si quieres obtener información sobre la asignación de los parámetros de configuración entre el agente de Backint y el agente de Google Cloud para SAP, expande la siguiente sección.
Asignación de parámetros de configuración
Nombre del parámetro en el agente de Backint | Nombre del parámetro en el agente de Google Cloud para SAP |
---|---|
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 |
Esto no está disponible en el agente de Google Cloud para SAP. |
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 |
Esto no está disponible en el agente de Google Cloud para SAP. |
Actualiza desde el agente de supervisión para SAP HANA
Cuando se instala la versión 3.2 (más reciente) del agente de Google Cloud para SAP, se detectan automáticamente las versiones del agente de supervisión para SAP HANA, se inhabilitan y, luego, quitan de tus máquinas anfitrión durante la instalación.
Si se detecta este agente, su configuración se migra al agente de Google Cloud para SAP durante la instalación. Con fines de copia de seguridad y referencia, la configuración del agente de supervisión para SAP HANA se copia en el siguiente archivo:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Actualiza instancias habilitadas para SSL
Si configuraste el agente de supervisión para SAP HANA a fin de usar certificados SSL para comunicarse con tus instancias de SAP HANA, cuando instales el agente de Google Cloud para SAP, toda la configuración de supervisión de SAP HANA, excepto la configuración de SSL, se migra al agente de Google Cloud para SAP. En ese caso, debes usar el agente de Google Cloud para SAP a fin de supervisar tus instancias de SAP HANA, debes completar los siguientes pasos:
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Abre el archivo de configuración del agente de Google Cloud para SAP:
/etc/google-cloud-sap-agent/configuration.json
En la sección
hana_monitoring_configuration
, configura el parámetroenabled
comotrue
.En la sección
hana_monitoring_configuration.hana_instances
, realiza lo siguiente para cada instancia de SAP HANA que usa el protocolo TLS/SSL a fin de lograr una comunicación segura:Especifica el parámetro
enable_ssl
y establece su valor entrue
.Especifica el parámetro
host_name_in_certificate
y establece el nombre de host de SAP HANA, como se especifica en el certificado TLS/SSL, como su valor.Especifica el parámetro
tls_root_ca_file
y establece la ruta de acceso, en la que se almacena el certificado TLS/SSL, como su valor.
Guarda el archivo de configuración.
Reinicia el agente para que se aplique la configuración nueva:
sudo systemctl restart google-cloud-sap-agent
Verifica que el agente recopile las métricas de supervisión de SAP HANA. Para obtener instrucciones, consulta Visualiza las otras métricas.
Desinstala el agente de supervisión para SAP HANA.
Si tienes problemas de conexión con tus instancias de SAP HANA después de esta actualización, puedes ver los registros del agente en Logging y usar la guía de solución de problemas para resolver el problema.
Actualiza desde el agente de supervisión para SAP NetWeaver
La instalación de la versión 3.2 (más reciente) del agente de Google Cloud para SAP detecta automáticamente las versiones del agente de supervisión para SAP NetWeaver.
Si se detecta este agente, su configuración se migra al agente de Google Cloud para SAP durante la instalación.
Actualiza el agente de Google Cloud para SAP
A fin de asegurarte de tener la última versión del agente de Google Cloud para SAP, debes verificar si hay actualizaciones periódicamente y actualizar el agente.
Comprueba actualizaciones
Selecciona tu sistema operativo y, luego, sigue estos pasos:
RHEL
- Establece una conexión SSH con tu instancia.
- Ejecuta el siguiente comando:
sudo yum check-update google-cloud-sap-agent
SLES
- Establece una conexión SSH con tu instancia.
- Ejecuta el siguiente comando:
sudo zypper list-updates -r google-cloud-sap-agent
Windows
- Establece una conexión RDP con la VM del host.
- Como administrador, ejecuta el siguiente comando desde PowerShell:
googet latest google-cloud-sap-agent
Instala una actualización
Selecciona tu sistema operativo y, luego, sigue estos pasos:
RHEL
- Establece una conexión SSH con tu instancia.
- Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.2 (más reciente) del
agente, haz lo siguiente:
sudo yum --nogpgcheck update google-cloud-sap-agent
- Para actualizar a una versión específica del agente, sigue estos pasos:
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Reemplaza
VERSION_NUMBER
por el número de versión del agente que deseas instalar, como3.1-606637668
. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.
- (Recomendado) Para actualizar a la versión 3.2 (más reciente) del
agente, haz lo siguiente:
SLES
- Establece una conexión SSH con tu instancia.
- Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.2 (más reciente) del
agente, haz lo siguiente:
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- Para actualizar a una versión específica del agente, sigue estos pasos:
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Reemplaza
VERSION_NUMBER
por el número de versión del agente que deseas instalar, como3.1-606637668
. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.
- (Recomendado) Para actualizar a la versión 3.2 (más reciente) del
agente, haz lo siguiente:
Windows
- Establece una conexión RDP con la VM del host.
- Para actualizar a la versión 3.2 (más reciente) del agente, como
administrador, ejecuta el siguiente comando desde PowerShell:
googet install google-cloud-sap-agent
Revierte al uso de los otros agentes de Google Cloud
En esta sección, se proporciona información sobre cómo revertir el uso de la versión 3.2 (más reciente) del agente de Google Cloud para SAP y el uso de sus agentes antecesores.
Revierte al uso del agente de Backint
Si deseas revertir al agente de Backint y dejar de usar la función de Backint del agente de Google Cloud para SAP, sigue estos pasos:
Borra todos los archivos relacionados con la función de Backint del agente de Google Cloud para SAP:
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
Reemplaza
SID
por el SID de tu sistema SAP.Restablece los archivos del agente de Backint que se almacenaron como una copia de seguridad cuando actualizaste al agente de Google Cloud para SAP. Para ello, cópialos en el directorio
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
Reemplaza lo siguiente:
SID
: el SID de tu sistema SAPTIMESTAMP
: el valor de marca de tiempo en el nombre de la carpeta que se creó cuando actualizaste del agente de Backint al agente de Google Cloud para SAP.
Usa SAP HANA Studio o SAP HANA Cockpit para editar el archivo
global.ini
y actualiza las rutas de acceso a los archivos de configuración.txt
. Si deseas obtener información sobre los parámetros para los que debes especificar la ruta de acceso a los archivos.txt
, consulta Configura SAP HANA para la función de Backint.Guarda los cambios que realizaste en el archivo
global.ini
.
Revierte al uso del agente de supervisión para SAP HANA
Si deseas revertir al uso del agente de supervisión para SAP HANA y dejar de usar la función de supervisión de SAP HANA del agente de Google Cloud para SAP, sigue estos pasos:
RHEL
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:
Abre el archivo de configuración del agente de Google Cloud para SAP:
/etc/google-cloud-sap-agent/configuration.json
En la sección
hana_monitoring_configuration
, configura el parámetroenabled
comofalse
.Guarda el archivo de configuración.
Reinicia el agente para que se aplique la configuración nueva:
sudo systemctl restart google-cloud-sap-agent
Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.
En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Reinicia el agente de supervisión para SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
SLES
Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:
Abre el archivo de configuración del agente de Google Cloud para SAP:
/etc/google-cloud-sap-agent/configuration.json
En la sección
hana_monitoring_configuration
, configura el parámetroenabled
comofalse
.Guarda el archivo de configuración.
Reinicia el agente para que se aplique la configuración nueva:
sudo systemctl restart google-cloud-sap-agent
Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.
En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Reinicia el agente de supervisión para SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
Desinstala el agente
Para desinstalar o quitar el agente del host, sigue estos pasos:
RHEL
Establece una conexión SSH con tu host.
Ejecuta el siguiente comando:
sudo yum remove google-cloud-sap-agent
SLES
Establece una conexión SSH con tu host.
Ejecuta el siguiente comando:
sudo zypper remove google-cloud-sap-agent
Windows
Establece una conexión RDP con la VM del host.
Como administrador, ejecuta el siguiente comando desde PowerShell:
Remove-Service -Name 'google-cloud-sap-agent'
Visualiza los registros del agente en Cloud Logging
De forma predeterminada, los registros para el agente de Google Cloud para SAP se redireccionan de tus instancias de VM y los servidores de la solución Bare Metal a Cloud Logging.
Para ver los registros del agente en Logging, sigue estos pasos:
En la consola de Google Cloud, ve a la página Explorador de registros.
Ve al panel Consulta.
En el menú desplegable Recursos, selecciona Global y, luego, haz clic en Aplicar.
En el Editor de consultas, ingresa
google-cloud-sap-agent
.Haz clic en Ejecutar consulta.
Deberías ver los registros que generaron las instancias de agente que se ejecutan en todas tus instancias de VM o servidores de la solución Bare Metal. Para filtrar los registros de una máquina específica, usa los filtros disponibles en la interfaz.
Puedes inhabilitar el redireccionamiento predeterminado de los registros del agente que se relacionan con la recopilación de métricas. Para ello, completa los siguientes pasos:
Establece una conexión SSH con la instancia de VM del host o el servidor de la solución Bare Metal.
Abre el siguiente archivo de configuración:
/etc/google-cloud-sap-agent/configuration.json
Para el parámetro
log_to_cloud
, actualiza el valor afalse
.Guarda el archivo de configuración.
Reinicia el agente para que se aplique este cambio.
Para inhabilitar el redireccionamiento predeterminado de los registros relacionados con la función de Backint del agente de Google Cloud para SAP, edita tu archivo de configuración de Backint y configura el parámetro log_to_cloud
como false