Configure o agente da Google Cloud para o SAP

O Workload Manager para soluções SAP usa o agente da Google Cloud para SAP para detetar e recolher metadados para avaliar as configurações do seu sistema SAP.Google CloudO agente para SAP, juntamente com o agente do anfitrião SAP, são necessários em todas as instâncias de VM que executam sistemas SAP para apoio técnico e monitorização dos seus sistemas SAP em execução no Google Cloud, incluindo SAP NetWeaver, SAP HANA, SAP ASE e SAP MaxDB.

Nota: a recolha de métricas de avaliação do Workload Manager pelo agente para SAP é suportada apenas no Linux. Google CloudNão é suportado no Windows.

A seguinte lista de verificação resume as tarefas que tem de realizar para garantir que o agente para SAP está configurado corretamente:

1. Conceda as funções necessárias à conta de serviço
2. Instale o agente para SAP
3. Verifique a versão do agente e instale as atualizações, se existirem
4. Ative a recolha de métricas de avaliação

Funções de IAM necessárias

O agente doGoogle Cloudpara SAP requer uma conta de serviço de gestão de identidade e de acesso (IAM) para autenticação com o Google Cloud e para autorização de acesso a recursos Google Cloud . Para a recolha de métricas de avaliação do Workload Manager, quer use uma conta de serviço nova, existente ou predefinida, a conta de serviço tem de incluir as seguintes funções do IAM:

• Compute Viewer (roles/compute.viewer)
• Workload Manager Insights Writer (roles/workloadmanager.insightWriter)
• Secret Manager Secret Accessor (roles/secretmanager.secretAccessor), se usar o Secret Manager para armazenar a palavra-passe da base de dados SAP HANA.

Instale o agente

Se ainda não o fez, instale o agente do Google Cloud's Agent for SAP na VM que aloja o seu sistema SAP: Google Cloud

Para instalar o agente numa instância do Compute Engine, siga estes passos:

1. Estabeleça uma ligação SSH à sua instância de computação.
2. No terminal, instale o agente executando o comando específico do seu sistema operativo:
   • (Recomendado) Para instalar a versão 3.9 (mais recente) do 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

   • Para instalar uma versão específica do 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

     Substitua VERSION_NUMBER pelo número da versão do agente que quer instalar, como 3.1-606637668. Para informações sobre as versões do agente que pode instalar, consulte Liste todas as versões disponíveis do agente.

     Para obter informações sobre como alterar o agente para uma versão específica, consulte o artigo Altere para a versão anterior do agente Google Cloudpara SAP.

Após a conclusão da instalação, avance para a configuração do agente para a recolha das métricas de avaliação do Workload Manager.

Valide a versão do agente

Google Cloud recomenda que instale a versão mais recente do agente para SAP para uma avaliação precisa das suas cargas de trabalho SAP, uma vez que as versões periódicas do agente para SAP podem adicionar ou alterar métricas usadas para a avaliação.

Para garantir que tem a versão mais recente do agente para SAP, tem de verificar periodicamente se existem atualizações e atualizar o agente. Google Cloud

Procure atualizações

Selecione o seu sistema operativo e, em seguida, siga estes passos:

RHEL

1. Estabeleça uma ligação SSH com a sua instância.
2. Execute o seguinte comando:

   sudo yum check-update google-cloud-sap-agent

SLES

1. Estabeleça uma ligação SSH com a sua instância.
2. Execute o seguinte comando:

   sudo zypper list-updates -r google-cloud-sap-agent

Instale uma atualização

Selecione o seu sistema operativo e, em seguida, siga os passos:

RHEL

1. Estabeleça uma ligação SSH com a sua instância.
2. Atualize a instância do agente:
   • (Recomendado) Para atualizar para a versão 3.9 (mais recente) do agente:

     sudo yum --nogpgcheck update google-cloud-sap-agent

   • Para atualizar para uma versão específica do agente:

     sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     Substitua VERSION_NUMBER pelo número da versão do agente que quer instalar, como 3.1-606637668. Para obter informações sobre as versões do agente que pode instalar, consulte o artigo Liste todas as versões disponíveis do agente.

SLES

1. Estabeleça uma ligação SSH com a sua instância.
2. Atualize a instância do agente:
   • (Recomendado) Para atualizar para a versão 3.9 (mais recente) do agente:

     sudo zypper --no-gpg-checks update google-cloud-sap-agent

   • Para atualizar para uma versão específica do agente:

     sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

     Substitua VERSION_NUMBER pelo número da versão do agente que quer instalar, como 3.1-606637668. Para obter informações sobre as versões do agente que pode instalar, consulte o artigo Liste todas as versões disponíveis do agente.

Configure a recolha de métricas de avaliação do Workload Manager

Para configurar o agente do Google CloudSAP, conclua os seguintes passos:

1. Para permitir que o agente recolha as métricas de avaliação do Workload Manager:

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

2. Opcional: para ativar a recolha das métricas "SAP HANA Insights" e "SAP HANA Security Best Practices" no Workload Manager, adicione a secção workload_validation_db_metrics_config após collect_workload_validation_metrics no ficheiro de configuração do agente e, em seguida, especifique os seguintes parâmetros:

   • hana_db_user: especifique a conta de utilizador que é usada para consultar a instância do SAP HANA.
   • hostname: especifique o identificador da máquina, local ou remota, que aloja a sua instância do SAP HANA.
   • port: especifique a porta na qual a sua instância do SAP HANA aceita consultas.

   • hana_db_password_secret_name: especifique o nome do segredo no Secret Manager que armazena a palavra-passe da conta de utilizador

     Em alternativa ao segredo, pode usar o parâmetro de configuração hdbuserstore_key.

   • hdbuserstore_key: especifique a chave hdbuserstore que autentica o utilizador especificado para hana_db_user

     Se especificar hdbuserstore_key, omite a especificação dos parâmetros hostname e port.

   Para informações sobre estes parâmetros, consulte o artigo Parâmetros de configuração.

   Os exemplos seguintes são ficheiros de configuração concluídos do Google Cloudagente do Google Cloud para SAP em execução num instância do Compute Engine, onde a recolha de métricas de avaliação do Workload Manager está ativada.

   Para a autenticação SAP HANA, o agente usa a seguinte ordem de preferência: se especificado, o parâmetro de configuração hdbuserstore_key é preferível ao parâmetro hana_db_password, que é preferível ao parâmetro hana_db_password_secret_name. Recomendamos que defina apenas uma opção de autenticação no ficheiro de configuração.

   • O exemplo seguinte usa uma chave do repositório de utilizadores seguro (hdbuserstore) para a autenticação 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
       }
     }

   • O exemplo seguinte usa um nome de utilizador e um segredo do Secret Manager para a autenticação do 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
       }
     }

   • O exemplo seguinte usa um nome de utilizador e uma palavra-passe para a autenticação do SAP HANA. Em alternativa, recomendamos que use um segredo do Secret Manager ou uma chave do armazenamento de utilizadores seguro (hdbuserstore) para a autenticação do 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. Reinicie o agente para que as novas definições entrem em vigor:

   Nota: a partir da versão 3.7, não precisa de reiniciar o agente, porque todas as alterações à configuração do agente são aplicadas automaticamente nos 30 segundos seguintes.

   sudo systemctl restart google-cloud-sap-agent

   Depois de o agente ser reiniciado com êxito, começa a enviar as métricas de avaliação do Workload Manager para o Workload Manager.

Valide a configuração da recolha de métricas de avaliação do Workload Manager

Pode validar se tem a Google Cloud configuração correta para a recolha das métricas de avaliação do Workload Manager executando o comando status do agente. Este comando é suportado a partir da versão 3.7 do agente.

Para validar a Google Cloud configuração, conclua os seguintes passos:

1. Estabeleça uma ligação SSH com a sua instância do Compute Engine.
2. Execute o seguinte comando:

   sudo /usr/bin/google_cloud_sap_agent status

   Se a Google Cloud configuração da recolha de métricas de avaliação do Workload Manager estiver correta, o resultado inclui o seguinte. A sua configuração pode ter valores diferentes dos default.

       Agent Status:
           ...
           Systemd Service Enabled: True
           Systemd Service Running: True
           Cloud API Full Scopes: True
           Configuration File: /etc/google-cloud-sap-agent/configuration.json
           Configuration Valid: True
       ...
       ----------------------------------------------------------------------------
       System Discovery: Enabled
           Status: Fully Functional
           IAM Permissions: All granted
           Configuration:
               enable_discovery:                  true  (default)
               enable_workload_discovery:         true  (default)
               sap_instances_update_frequency:    60    (default)
               system_discovery_update_frequency: 14400 (default)
       ----------------------------------------------------------------------------
       Workload Manager Evaluation: Enabled
           Status: Fully Functional
           IAM Permissions: All granted
           Configuration:
               collect_workload_validation_metrics:      true       (default)
               config_target_environment:                PRODUCTION (default)
               fetch_latest_config:                      true       (default)
               workload_validation_db_metrics_frequency: 3600       (default)
               workload_validation_metrics_frequency:    300        (default)
       ...
       

3. Se o resultado indicar que falta alguma configuração, reveja as informações fornecidas nas secções anteriores, execute as ações necessárias e, em seguida, volte a executar o comando status para validar novamente a configuração.

O que se segue?

• Saiba mais acerca das avaliações da carga de trabalho