Guía de solución de problemas del Agente de Google Cloud para SAP

En esta guía, se muestra cómo resolver problemas de la versión 3.2 (más reciente) del agente de Google Cloud para SAP.

Para obtener información de solución de problemas y asistencia de SAP, consulta las siguientes Notas de SAP:

Logging

Revisa los registros del directorio que son específicos de tu sistema operativo.

Si deseas ver los registros del Agente de Google Cloud para SAP, navega a las siguientes rutas:

Linux

/var/log/google-cloud-sap-agent.log

Windows

C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log

Si habilitaste la función de Backint del agente de Google Cloud para SAP, revisa los siguientes registros:

  • El archivo backup.log de SAP HANA, que contiene información sobre las operaciones de copia de seguridad y recuperación de SAP HANA.
  • El archivo backint.log de SAP HANA, que contiene las llamadas a la interfaz de la copia de seguridad que usa la función de Backint del agente y otras herramientas de copia de seguridad externas.
  • El archivo de registro de Backint del agente de Google Cloud para SAP: /var/log/google-cloud-sap-agent/backint.log. En este archivo, se incluye información sobre cuándo se habilitó la función de Backint, eventos operativos relacionados y, también, indicaciones de errores de comunicación con Cloud Storage y problemas relacionados de configuración o permisos.
  • Los registros de Google Cloud en Cloud Logging, que pueden contener errores relacionados con la cuenta de servicio que usa el agente de Google Cloud para SAP Para ver estos registros, ve a la página Explorador de registros en la consola de Google Cloud.

Problemas habituales

En las siguientes secciones, se proporciona información sobre problemas habituales relacionados con el uso del agente de Google Cloud para SAP, sus causas y la resolución.

Problema: Permisos de IAM insuficientes

Problema: Los registros del Agente de Google Cloud para SAP muestran un error de permisos de IAM insuficiente.

Causa: La cuenta de servicio que usa el agente no tiene los permisos de IAM necesarios para acceder a la API de Cloud Monitoring o si usas la función de Backint del agente, no tienes permisos suficientes para acceder al bucket de Cloud Storage.

Resolución: Para resolver este problema, realiza los siguientes pasos:

  1. En la consola de Google Cloud, en la página de detalles de la instancia de VM, anota el nombre de la cuenta de servicio de la VM. Por ejemplo: sap-example@example-project-123456.iam.gserviceaccount.com.

  2. Ve a la página IAM y administración y, para la cuenta de servicio mencionada, asegúrate de que incluya los siguientes roles de IAM:

    Característica Roles de IAM obligatorios
    Recopilación de métricas de SAP Host Agent
    Recopilación de métricas de supervisión de procesos
    Recopilación de métricas de evaluación de Workload Manager
    Recopilación de métricas de supervisión de SAP HANA
    Copia de seguridad y recuperación basadas en Backint para SAP HANA
    • Administrador de objetos de almacenamiento (roles/storage.objectAdmin)
    • Encriptador y desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter), si usaste una clave de encriptación administrada por el cliente para encriptar tus copias de seguridad de SAP HANA en Cloud Storage. Para obtener más información sobre esta función, consulta Opciones de encriptación para copias de seguridad.

    Para obtener más información, consulta Permisos necesarios de Cloud Storage.

Si deseas obtener más información sobre la autenticación requerida para el agente de Google Cloud para SAP, consulta Autenticación y acceso.

Para confirmar los permisos que requiere el agente de Cloud Monitoring, consulta la siguiente documentación de Monitoring:

Problema: Permisos de acceso incorrectos para la cuenta de servicio de VM

Problema: Si limitas los permisos de acceso en la instancia de VM de host, los registros del Agente de Google Cloud para SAP pueden mostrar un error de permisos de IAM insuficiente.

Causa: El Agente de Google Cloud para SAP requiere permisos de acceso mínimos a la API de Cloud en la instancia de VM del host. Este error se produce cuando la cuenta de servicio no tiene los permisos de acceso necesarios.

Resolución: Los permisos de acceso son el método heredado de especificar permisos para tu instancia de VM. Compute Engine recomienda configurar las instancias de VM para permitir los permisos de acceso completo a todas las APIs de Cloud y usar solo los permisos de IAM de la cuenta de servicio de la instancia de VM para controlar el acceso a los recursos de Google Cloud.

Para resolver este problema, se recomienda configurar todo el nivel de acceso cloud-platform en la instancia de VM y, luego, limitar de forma segura el acceso a la API de la cuenta de servicio con roles de IAM. Por ejemplo:

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

Si limitas los permisos de acceso de la instancia de VM, debes asegurarte de que la instancia de VM del host tenga los siguientes permisos de acceso:

  • https://www.googleapis.com/auth/source.read_write
  • https://www.googleapis.com/auth/compute
  • https://www.googleapis.com/auth/servicecontrol
  • https://www.googleapis.com/auth/service.management.readonly
  • https://www.googleapis.com/auth/logging.admin
  • https://www.googleapis.com/auth/monitoring
  • https://www.googleapis.com/auth/trace.append
  • https://www.googleapis.com/auth/devstorage.full_control

Si habilitaste la recopilación de las métricas de Process Monitoring o las métricas de supervisión de SAP HANA, los permisos de acceso de la instancia de VM del host también deben tener acceso de escritura para publicar datos de métrica a tu proyecto de Google Cloud:

  • https://www.googleapis.com/auth/monitoring.write

Para cambiar los permisos de acceso, debes detener tu instancia de VM, realizar los cambios y, luego, reiniciar la instancia de VM. Para obtener instrucciones, consulta la documentación de Compute Engine. No es necesario realizar ningún cambio en los permisos de los roles de IAM para este problema.

Problema: SAP Host Agent falta o es incorrecto

Problema: Los registros de agente de Google Cloud para SAP muestran errores faltantes o incorrectos de SAP Host Agent.

Causa: SAP Host Agent o el nivel de parche mínimo requerido para SAP Host Agent no están instalados. Para que el Agente de Google Cloud para SAP funcione, tu sistema SAP debe tener instalado SAP Host Agent y mantener el nivel de parche mínimo que este requiere.

Resolución: Para resolver este problema, instala la versión requerida de SAP Host Agent. A fin de obtener instrucciones para instalar SAP Host Agent, consulta la documentación de SAP.

Para conocer los requisitos de versión para SAP Host Agent, consulta las siguientes notas de SAP:

Problema: Instalación del Agente de Google Cloud para SAP

Problema: La instalación del agente falla cuando se ejecuta el comando de instalación del administrador de paquetes (yum, zypper o googet).

Causa: La instalación del agente falla porque el servidor host que ejecuta el agente se creó sin una dirección IP externa.

Resolución: Para resolver este problema, configura una puerta de enlace NAT que otorgue al servidor host acceso de salida a Internet. Para obtener información sobre cómo configurar una puerta de enlace NAT, consulta la guía de implementación de tu sistema SAP. Por ejemplo, para SAP NetWeaver, consulta lo siguiente:

Problema: Recopilación de las métricas de supervisión de SAP HANA con errores

Problema: Mientras actualizas del agente de supervisión para SAP HANA, después de instalar el agente de Google Cloud para SAP, verás un mensaje de error similar al siguiente:

tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead

Causa: El agente de Google Cloud para SAP no puede iniciar la recopilación de las métricas de supervisión de SAP HANA porque las instancias de SAP HANA de destino usan certificados SSL que se especifican con Common Name (CN).

Resolución: Para resolver este problema, realiza los siguientes pasos:

  1. Para las instancias de SAP HANA que deseas supervisar mediante el agente de Google Cloud para SAP, debes cambiar y usar un certificado SSL de Subject Alternate Name (SAN) en lugar de los certificados SSL que se especifican con Common Name (CN).

  2. Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

  3. Abre el archivo de configuración del agente de Google Cloud para SAP:

    /etc/google-cloud-sap-agent/configuration.json

  4. En la sección hana_monitoring_configuration, configura el parámetro enabled como true.

  5. 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:

    1. Especifica el parámetro enable_ssl y establece su valor en true.

    2. 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.

    3. 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.

  6. Guarda el archivo de configuración.

  7. Reinicia el agente de Google Cloud para SAP a fin de que se aplique la nueva configuración:

    sudo systemctl restart google-cloud-sap-agent

  8. Verifica que el agente recopile las métricas de supervisión de SAP HANA. Para obtener instrucciones, consulta Visualiza las otras métricas.

  9. Desinstala el agente de supervisión para SAP HANA.

Problema: Error de conexión rechazada

Problema: Los registros de SAP Host Agent muestran el error de conexión rechazada.

Causa: El Agente de Google Cloud para SAP no se puede iniciar porque el puerto 18181 no está disponible. El agente de Google Cloud para SAP escucha las solicitudes en el puerto 18181. Este puerto debe estar disponible para que el agente se inicie.

Resolución: A fin de resolver este problema, asegúrate de que el puerto 18181 esté disponible para el agente de Google Cloud para SAP. Si otro servicio usa el puerto 18181, es posible que debas reiniciar ese otro servicio o volver a configurarlo para usar otro puerto.

Problema: Para las imágenes de SO SLES 15 SP4 para SAP y versiones posteriores, el agente de Google Cloud para SAP no se está ejecutando.

Problema: Cuando usas imágenes de SO de SLES “para SAP”, el agente de Google Cloud para SAP está preinstalado. Sin embargo, en el caso de las imágenes de SO SLES 15 SP4 para SAP y versiones posteriores, el agente preinstalado para SAP no se inicia por sí solo.

Para verificar que el agente esté en ejecución o no, realiza los siguientes pasos:

  1. Conéctate a la instancia de VM del host o al servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando: 

    systemctl status google-cloud-sap-agent

    Si el agente no está en ejecución, el resultado contiene inactive (dead). Por ejemplo: 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
 Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
 Active: inactive (dead)

Causa: El agente para SAP no se inicia por sí solo debido a un problema con el empaquetado del SO.

Resolución: Para resolver el problema, realiza los siguientes pasos:

  1. Conéctate a la instancia de VM del host o al servidor de la solución Bare Metal.

  2. Ejecute los siguientes comandos:

    sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service
sudo systemctl restart google-cloud-sap-agent

  3. Verifica que el agente esté en ejecución: 

    systemctl status google-cloud-sap-agent

    Deberías ver un resultado similar al siguiente:

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
  Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled)
  Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago
Main PID: 6117 (google_cloud_sa)
   Tasks: 6
  Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M)
  CGroup: /system.slice/google-cloud-sap-agent.service
           └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon

Problema: Capacidad de procesamiento baja

Problema: La capacidad de procesamiento es más baja de lo esperado.

Causa: Para la función Backint del agente de Google Cloud para SAP, es posible que hayas habilitado la compresión mediante el parámetro de configuración compress.

Resolución: Para resolver este problema, verifica que la compresión no esté habilitada. Para hacerlo, sigue estos pasos:

  1. Conéctate a tu host de SAP HANA mediante SSH.

  2. Abre tu archivo de configuración de Backint.

    /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

    Reemplaza SID por el SID del sistema en el que instalaste los archivos relacionados con Backint.

  3. Verifica que el parámetro compress esté configurado como false.

  4. Si realizas algún cambio, guarda el archivo de configuración.

Problema: Errores de transmisión múltiple

Problema: Recibes errores mientras copias de seguridad de datos de transmisión múltiple.

Causa: Para la función de Backint del agente de Google Cloud para SAP, es posible que hayas especificado una mayor cantidad de transmisiones paralelas.

Resolución: Para resolver este problema, realiza los siguientes pasos:

  1. Conéctate a tu host de SAP HANA mediante SSH.

  2. Abre tu archivo de configuración de Backint.

    /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

    Reemplaza SID por el SID del sistema en el que instalaste los archivos relacionados con Backint.

  3. Si configuraste un valor para el parámetro parallel_streams, cámbialo a 1.

    Si esto no resuelve el error, comunícate con el servicio de atención al cliente.

Problema con la conexión a Cloud Storage

Problema: Tienes un problema de conectividad con tu bucket de Cloud Storage.

Causa: Esto puede deberse a lo siguiente:

  • Un problema de conectividad temporal.
  • La cuenta de servicio que usa el agente de Google Cloud para SAP no tiene los permisos necesarios para acceder a Cloud Storage.
  • Hay un problema con tu configuración

Resolución: Para solucionar un problema de conectividad con el bucket de Cloud Storage, verifica lo siguiente:

  • Reintenta la copia de seguridad o la recuperación con errores para asegurarte de que el error no fue solo un problema de conectividad momentáneo.
  • Si el agente de Google Cloud para SAP usa la cuenta de servicio de tu VM, asegúrate de que la VM tenga acceso a todos los permisos de la nube o si limitas el acceso, asegúrate de que la VM tenga acceso a storage.googleapis.com. Para obtener más información, consulta Habilita el acceso a las APIs de Cloud y los servidores de metadatos.
  • Si creaste una cuenta de servicio para usar con el agente de Google Cloud para SAP, asegúrate de lo siguiente:
    • A la cuenta de servicio se le asigna el rol de administrador de objetos de almacenamiento.
    • A la cuenta de servicio se le asigna el rol de Encriptador/Desencriptador de CryptoKey de Cloud KMS si usas una clave de encriptación administrada por el cliente para encriptar copias de seguridad en Cloud Storage. Para obtener más información, consulta Encriptación de copias de seguridad.
  • Asegúrate de haber especificado correctamente los parámetros en el archivo de configuración de Backint, PARAMETERS.json, y el archivo global.ini de SAP HANA.

Puedes probar el acceso a tu bucket de Cloud Storage con la función de autodiagnóstico integrada en el agente de Google Cloud para SAP. Para obtener más información, consulta Autodiagnóstico.

Problema con una operación de recuperación o copia de seguridad basada en una instantánea de disco

Problema: Una operación de copia de seguridad o recuperación realizada para SAP HANA mediante el comando hanadiskbackup o hanadiskrestore del agente no se realiza de forma correcta.

Causa: Este problema puede ocurrir debido a cualquiera de los siguientes motivos:

  • El agente experimenta un error y sale de la operación de copia de seguridad o recuperación.
  • El agente tarda más del tiempo esperado en crear la instantánea de disco o subirla a Cloud Storage debido a un problema con un servicio subyacente de Google Cloud.
  • El agente falla sin un error o mensaje de éxito claro.
  • La operación de copia de seguridad o recuperación falla debido a un problema a nivel del sistema operativo.
  • El agente está diseñado para esperar más tiempo del esperado por tu base de datos de SAP HANA, lo que podría deberse a que la base de datos experimenta una carga de trabajo muy pesada

Resolución: Para resolver este problema, usa la siguiente información:

  • Si se trata de una operación de copia de seguridad que no se realizó de forma correcta, haz lo siguiente:

    1. Verifica que el agente esté en ejecución:. Si no es así, reinicia el agente y vuelve a intentar la operación de la copia de seguridad.

    2. Si el agente se ejecuta como se espera, entonces el estado de la creación de la instantánea:

      gcloud compute snapshots list
  --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE_ID/disks/DISK_NAME"

      Reemplaza lo siguiente:

      • PROJECT_ID: Es el proyecto de Google Cloud en el que se implementa el disco de origen.
      • ZONE_ID: Es la zona de Compute Engine en la que se implementa el disco de origen, por ejemplo, us-central1-a
      • DISK_NAME: Es el nombre del disco de origen.

      El estado de salida puede ser uno de los siguientes: CREATING, UPLOADING o READY.

    3. Si el estado de creación de la instantánea es CREATING o UPLOADING, te recomendamos que esperes a que se complete esta operación, en especial si esta es la primera instantánea que creas para la disco que aloja tu volumen /hana/data.

      S i e sta operación falla, el agente sale de forma automática del procedimiento y actualiza los registros. Puedes volver a crear la copia de seguridad si ejecutas el comando hanadiskbackup. El agente se encarga de finalizar la operación de copia de seguridad incorrecta en la base de datos de SAP HANA y crea una nueva copia de seguridad basada en instantáneas.

    4. Si el estado de la creación de la instantánea es READY, pero el comando hanadiskbackup aún parece estar en ejecución, esto indica que el agente espera a SAP HANA para realizar su parte del procedimiento de copia de seguridad.

    5. Si el comando hanadiskbackup parece ejecutarse más tiempo del esperado, haz lo siguiente para reanudar las operaciones normales de la base de datos de SAP HANA:

      1. Desbloquea el sistema de archivos XFS que contiene el volumen /hana/data:

        xfs_freeze -u PATH_TO_HANA_DATA_VOLUME

      2. Desde tu base de datos de SAP HANA, obtén el ID de copia de seguridad de la instantánea de almacenamiento con errores:

        SELECT BACKUP_ID, STATE_NAME, COMMENT FROM M_BACKUP_CATALOG WHERE ENTRY_TYPE_NAME = 'data snapshot' and STATE_NAME = 'prepared'

      3. En SAP HANA, actualiza la entrada de la instantánea con errores como incorrecta:

        BACKUP DATA FOR FULL SYSTEM CLOSE SNAPSHOT BACKUP_ID UNSUCCESSFUL 'Do not use - manually terminated';

      Reemplaza BACKUP_ID por el BACKUP_ID que recuperaste en el paso anterior.

    6. Para resolver el problema de la operación de copia de seguridad incorrecta, comunícate con Atención al cliente con el paquete de asistencia del agente.

  • Si es una operación de recuperación que no se ejecuta de forma correcta, completa los siguientes pasos:

    1. Verifica que el disco original que aloja el volumen /hana/data esté conectado a tu VM host. Si no es así, conéctalo mediante el comando gcloud compute instances attach-disk.

    2. Vuelve a analizar los grupos de volúmenes y los volúmenes lógicos:

      sudo /sbin/dmsetup remove_all
sudo /sbin/vgscan -v --mknodes
sudo /sbin/vgchange -ay
sudo /sbin/lvscan
sudo mount -av

    3. Si el nuevo análisis no se realiza correctamente, reinicia la VM host. Esto hace que el sistema operativo vuelva a analizar los grupos de volúmenes.

    4. En SAP HANA, verifica que el volumen /hana/data esté activo.

    5. Si el volumen /hana/data aún no está publicado, comunícate con Atención al cliente con el paquete de asistencia del agente para resolver el problema.

Obtén asistencia para el Agente de Google Cloud para SAP

Si necesitas ayuda para resolver un problema con el Agente de Google Cloud para SAP, recopila la información de diagnóstico requerida y comunícate con el servicio de atención al cliente de Cloud. Si deseas obtener más información, consulta Información de diagnóstico de los agentes de Google Cloud para SAP.