Configura el agente de Google Cloud para SAP

Las soluciones de Workload Manager para SAP usan el Agente deGoogle Cloudpara SAP para detectar y recopilar metadatos para evaluar las configuraciones de tu sistema SAP. El Agente para SAP, junto con el Agente de host de SAP, son obligatorios en todas las instancias de VM que ejecutan sistemas SAP para la asistencia y supervisión de los sistemas SAP que se ejecutan en Google Cloud, incluidos SAP NetWeaver, SAP HANA, SAP ASE y SAP MaxDB.

En la siguiente lista de tareas, se resumen las tareas que debes realizar para asegurarte de que el Agente para SAP esté configurado correctamente:

  1. Otorga roles necesarios a la cuenta de servicio
  2. Instala el agente para SAP
  3. Verifica la versión del agente y, si hay actualizaciones, instálalas
  4. Habilita la recopilación de métricas de evaluación

Roles de IAM obligatorios

El agente deGoogle Cloudpara SAP requiere una cuenta de servicio de Identity and Access Management (IAM) para la autenticación con Google Cloud y para obtener permiso de acceso a los recursos de Google Cloud . Para la recopilación de métricas de evaluación de Workload Manager, ya sea que uses una cuenta de servicio nueva, existente o predeterminada, la cuenta de servicio debe incluir los siguientes roles de IAM:

Instala el agente

Si aún no lo hiciste, instala el Agente de Google Cloudpara SAP en la VM que aloja tu sistema SAP:

Para instalar el agente en una instancia de Compute Engine, sigue estos pasos:

  1. Establece una conexión SSH a tu instancia de procesamiento.
  2. En tu terminal, instala el agente mediante la ejecución del comando específico de tu sistema operativo:
    • (Recomendado) Para instalar la versión 3.6 (más reciente) del agente, sigue estos pasos:

      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
    • Para instalar una versión específica del agente, ejecuta este comando:

      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

      Reemplaza VERSION_NUMBER por el número de versión del agente que deseas instalar, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

      Si deseas obtener información para cambiar el agente a una versión específica, consulta Cambia a una versión inferior del agente de Google Cloudpara SAP.

Una vez que se complete la instalación, continúa con la configuración del agente para la recopilación de las métricas de evaluación de Workload Manager.

Verifica la versión del agente

Google Cloud recomienda que instales la versión más reciente del Agente para SAP para obtener una evaluación precisa de tus cargas de trabajo de SAP, ya que las versiones periódicas del Agente para SAP podrían agregar o cambiar métricas que se usan en la evaluación.

Para asegurarte de tener la versión más reciente del agente de Google Cloudpara SAP, debes verificar si hay actualizaciones periódicamente y actualizar el agente.

Comprueba actualizaciones

Selecciona tu sistema operativo y, luego, sigue estos pasos:

RHEL

  1. Establece una conexión SSH con tu instancia.
  2. Ejecuta el siguiente comando:
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Establece una conexión SSH con tu instancia.
  2. Ejecuta el siguiente comando:
    sudo zypper list-updates -r google-cloud-sap-agent

Instala una actualización

Selecciona tu sistema operativo y, luego, sigue estos pasos:

RHEL

  1. Establece una conexión SSH con tu instancia.
  2. Actualiza la instancia del agente:
    • (Recomendado) Para actualizar a la versión 3.6 (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, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

SLES

  1. Establece una conexión SSH con tu instancia.
  2. Actualiza la instancia del agente:
    • (Recomendado) Para actualizar a la versión 3.6 (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, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

Configura la recopilación de métricas de evaluación de Workload Manager

Para configurar el agente de Google Cloudpara SAP, completa los siguientes pasos:

  1. Para permitir que el agente recopile las métricas de evaluación del Administrador de cargas de trabajo, haz lo siguiente:

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

  2. Opcional: Para habilitar la recopilación de las métricas “Estadísticas de SAP HANA” y “Prácticas recomendadas de seguridad de SAP HANA” en Workload Manager, agrega la sección workload_validation_db_metrics_config después de collect_workload_validation_metrics en el archivo de configuración del agente y, luego, especifica los siguientes parámetros:

    • hana_db_user: especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA.
    • hostname: especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA.
    • port: especifica el puerto en el que la instancia de SAP HANA acepta consultas.
    • hana_db_password_secret_name: especifica el nombre del objeto Secret en Secret Manager que almacena la contraseña de la cuenta de usuario

      Como alternativa al objeto Secret, puedes usar el parámetro de configuración hdbuserstore_key.

    • hdbuserstore_key: Especifica la clave hdbuserstore que autentica al usuario que especificaste para hana_db_user.

      Si especificas hdbuserstore_key, omites la especificación de los parámetros hostname y port.

    Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.

    Los siguientes ejemplos son archivos de configuración completos del agente deGoogle Cloudpara SAP que se ejecuta en unainstancia de Compute Engine, en el que está habilitada la recopilación de las métricas de evaluación de Workload Manager.

    Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

    • En el siguiente ejemplo, se usa una clave de almacenamiento seguro de usuario (hdbuserstore) para la autenticación de 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
        }
      }
    • En el siguiente ejemplo, se usa un nombre de usuario y un secreto de Secret Manager para la autenticación de 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
        }
      }
    • En el siguiente ejemplo, se usa un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses un secreto de Secret Manager o una clave de almacenamiento seguro de usuario (hdbuserstore) para la autenticación de 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. Reinicia el agente para que se aplique la configuración nueva:

    sudo systemctl restart google-cloud-sap-agent

    Después de que el agente se reinicie correctamente, comenzará a enviar las métricas de evaluación de Workload Manager a Workload Manager.

¿Qué sigue?