Configurar o agente para cargas de trabalho SAP

O Workload Manager para soluções SAP usa o Agente doGoogle Cloudpara SAP para detectar e coletar metadados para avaliar as configurações do sistema SAP. O agente do Google Cloud para SAP e o SAP Host Agent são necessários em todas as instâncias de VM que executam sistemas SAP para suporte e monitoramento dos sistemas SAP em execução no Google Cloud, incluindo SAP NetWeaver, SAP HANA, SAP ASE e SAP MaxDB.

Antes de começar

Antes de instalar e configurar o agente do Google Cloudpara SAP, verifique se os seguintes pré-requisitos foram atendidos:

Papéis do IAM necessários para o agente

O agente para SAP usa a conta de serviço anexada à instância de computação para autenticação e acesso a recursos do Google Cloud .

Para melhorar a segurança, recomendamos que você use uma conta de serviço de uso único em vez da conta de serviço padrão do Compute Engine.

Para garantir que a conta de serviço tenha as permissões necessárias para permitir que o agente para SAP se autentique com Google Cloud e acesse recursos do Google Cloud , peça ao administrador para conceder os seguintes papéis do IAM à conta de serviço no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à conta de serviço as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Ativar o acesso às APIs do Cloud

O Compute Engine recomenda configurar as instâncias para permitir todos os escopos de acesso a todas as APIs do Cloud. Para controlar o acesso aos recursos do Google Cloud, use apenas as permissões do IAM da conta de serviço da instância. Para mais informações, consulte Criar uma VM que usa uma conta serviço gerenciado pelo usuário.

Se você limitar o acesso às APIs do Cloud, o agente para SAP vai exigir, no mínimo, os seguintes escopos de acesso às APIs do Cloud na instância de computação do host:

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

Para mais informações, consulte Práticas recomendadas de escopos.

Se você estiver executando aplicativos SAP em uma instância de computação que não tenha um endereço IP externo, ative o Acesso privado do Google na sub-rede da instância para que o Agente para cargas de trabalho computacionais possa acessar as APIs e os serviços do Google. Para informações sobre como ativar o Acesso privado do Google, consulte Configurar o Acesso privado do Google.

Instalar e configurar o agente usando o gerenciador de pacotes

Nesta seção, mostramos como instalar o agente para SAP na sua instância de computação e configurá-lo para se conectar à sua carga de trabalho do SAP usando um gerenciador de pacotes.

Se você quiser instalar e configurar o agente em uma frota de VMs, use uma política do Gerenciador de extensões de VM. Para mais informações, consulte Instalar e gerenciar o agente em uma frota de VMs usando o Gerenciador de extensões de VM.

Instalar o agente

Se ainda não tiver feito isso, instale o agente do Google Cloudpara SAP em todas as instâncias de computação que executam sua carga de trabalho do SAP:

Para instalar o agente em uma instância do Compute Engine, siga estas etapas:

  1. Estabeleça uma conexão SSH com a instância de computação.
  2. No terminal, instale o agente executando o comando específico para seu sistema operacional:
    • (Recomendado) Para instalar a versão 3.14 (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 você quer instalar, como 3.1-606637668. Para informações sobre as versões do agente que podem ser instaladas, consulte Listar todas as versões disponíveis do agente.

      Para informações sobre como fazer downgrade do agente para uma versão específica, consulte Fazer downgrade do agente para SAP do Google Cloud.

Configurar a coleta de métricas de avaliação do Workload Manager

Depois de instalar o Agent para SAP, é necessário configurar o agente para a coleta das métricas de avaliação do Workload Manager.

Para configurar o agente do Google Cloudpara SAP, siga estas etapas:

  1. Para permitir que o agente colete 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 coleta das métricas "Insights do SAP HANA" e "Práticas recomendadas de segurança do SAP HANA" no Workload Manager, adicione a seção workload_validation_db_metrics_config depois de collect_workload_validation_metrics no arquivo de configuração do agente e especifique os seguintes parâmetros:

    • hana_db_user: especifique a conta de usuário usada para consultar a instância do SAP HANA.
    • hostname: especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA.
    • port: especifique a porta em que a instância do SAP HANA aceita consultas.

    • hana_db_password_secret_name: especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário

      Como alternativa ao secret, use o parâmetro de configuração hdbuserstore_key.

    • hdbuserstore_key: especifique a chave hdbuserstore que autentica o usuário especificado para hana_db_user.

      Se você especificar hdbuserstore_key, a especificação dos parâmetros hostname e port será ignorada.

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

    Os exemplos a seguir são arquivos de configuração completos do agente doGoogle Cloudpara SAP em execução em um servidor da Solução Bare Metal, em que a coleta de métricas de avaliação do Workload Manager está ativada.

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

    • O exemplo a seguir usa uma chave de repositório de usuários seguro (hdbuserstore) para 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",
      "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 a seguir usa um nome de usuário e um secret do Secret Manager para 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 a seguir usa um nome de usuário e uma senha para autenticação do SAP HANA. Recomendamos que você use um secret do Secret Manager ou uma chave Secure user store (hdbuserstore) para 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 configurações entrem em vigor.

    sudo systemctl restart google-cloud-sap-agent

    Depois que o agente for reiniciado, ele começará a enviar as métricas de avaliação do Workload Manager para o serviço.

Instalar e gerenciar o agente em uma frota de VMs usando o Gerenciador de extensões de VM

Nesta seção, mostramos como instalar e gerenciar o agente para SAP em uma frota de VMs usando o Gerenciador de extensões de VM.

Com a política do Gerenciador de extensões de VM, é possível realizar tarefas como as seguintes:

  • Instalação em toda a frota: instale o agente para SAP nos seguintes itens:
    • Todas as VMs no seu projeto Google Cloud ou um subconjunto de VMs identificadas por rótulos.
    • Todas as VMs em uma zona ou um subconjunto de VMs identificadas por rótulos.
  • Gerenciamento de configuração: aplique uma configuração personalizada ao agente em todas as VMs gerenciadas por uma política.

Configurar o Gerenciador de extensões de VM

Para configurar o Gerenciador de extensões de VM, siga estas etapas:

Instalar e configurar o agente em uma frota de VMs

Para instalar a versão mais recente do agente para SAP na sua frota de VMs usando uma política do Gerenciador de extensões de VM, consulte a seção apropriada:

Instale e configure o agente nas VMs do seu Google Cloud projeto

Para instalar o agente em todas as VMs do seu projeto Google Cloud ou em um subconjunto de VMs identificadas por rótulos usando uma política do Gerenciador de extensões de VM, siga estas etapas:

  • No terminal ou no Cloud Shell, execute o comando gcloud beta compute global-vm-extension-policies create:

    gcloud beta compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

    Substitua:

    • POLICY_NAME: um nome exclusivo para a política de extensão de VM.
    • PROJECT_ID: o ID do projeto do projetoGoogle Cloud para o qual você está criando a política

    • ROLLOUT_PLAN_OPTION: a opção de lançamento que você quer aplicar à sua política global. Os valores aceitos são slow_rollout (recomendado) e fast_rollout.

    • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.

    • É possível usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

    • DESCRIPTION: uma descrição opcional da política.

    • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração do agente para SAP.

    • Como alternativa, para fornecer a configuração como uma string inline, use a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-sap-extension="CONFIG".

    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.

    • Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

    • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.

    • Se você especificar --inclusion-labels várias vezes, a política vai segmentar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai segmentar todas as VMs no projeto.

    • PRIORITY: um número inteiro de 0 a 65535 que define a prioridade da política. Números menores indicam maior prioridade. O valor padrão é 1000. Para mais informações, consulte Prioridade e resolução de conflitos de políticas.

Instalar e configurar o agente em uma frota de VMs em uma zona específica

Para instalar a versão mais recente do agente para SAP na sua frota de VMs em uma zona específica usando uma política do Gerenciador de extensões de VM, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique em Criar política de extensão.

  3. No campo Nome, digite um nome para a política.

  4. Opcional: no campo Descrição, insira uma descrição para a política.

  5. No campo Prioridade, especifique um número para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Nas listas Região e Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seção Extensões, clique em Adicionar extensão e faça o seguinte:

    1. Na lista Extensão, selecione Extensão do Google Cloud para cargas de trabalho de computação.

    2. Deixe o campo Versão em branco.

      Isso direciona a política para instalar a versão mais recente do agente do Google Cloudpara SAP.

    3. No campo Conteúdo do arquivo de configuração, insira a configuração que você quer aplicar ao agente.

      Para informações sobre os parâmetros de configuração aceitos pelo agente da sua carga de trabalho do SAP, consulte Parâmetros de configuração.

    4. Clique em Concluído.

  8. Opcional: para limitar o lançamento da política às VMs necessárias, faça o seguinte:

    1. Clique em Adicionar rótulos e inclua os rótulos que identificam as VMs necessárias.
    2. Clique em Concluído.

  9. Clique em Criar.

gcloud 

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Substitua:

  • POLICY_NAME: um nome para a política de extensão de VM.

    O comando falha se já existir uma política com o nome especificado na zona.

  • ZONE: a zona em que você quer aplicar essa política.

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração para o agente para SAP se conectar à sua carga de trabalho do SAP.

    • Como alternativa, para fornecer a configuração como uma string inline, use a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-sap-extension="CONFIG". OGoogle Cloud recomenda que você use --config-from-file.
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente da sua carga de trabalho do SAP, consulte Parâmetros de configuração.

  • DESCRIPTION: uma descrição opcional da política.

  • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai segmentar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai segmentar todas as VMs na zona especificada.

  • PRIORITY: um número inteiro de 0 a 65535 que define a prioridade da política. Números menores indicam maior prioridade. O valor padrão é 1000.

Exemplo:

O comando a seguir cria uma política chamada test-agent-policy no projetoGoogle Cloud chamado test-project, que instala a versão mais recente do Agente para cargas de trabalho computacionais em todas as VMs implantadas na zona us-centrail-f. A configuração especificada em agent-config.json é aplicada ao agente.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension="/usr/agent-config.json"

Gerenciar o agente em uma frota de VMs

Para mudar como uma política do Gerenciador de extensões de VM gerencia o agente para SAP, atualize a política. Quando você atualiza uma política, o Gerenciador de extensões de VM implanta as mudanças em todas as VMs aplicáveis, normalmente em um minuto. Se você modificar os rótulos de inclusão, o agente para SAP poderá ser instalado em novas VMs ou desinstalado de VMs atuais, dependendo se as VMs corresponderem aos rótulos atualizados.

As seções a seguir mostram como gerenciar o Agent for SAP para fazer o seguinte:

Modificar a configuração do agente em uma frota de VMs

Para modificar a configuração das instâncias do agente para SAP que você instalou na sua frota de VMs usando uma política do Gerenciador de extensões de VM, edite essa política.

Para modificar a configuração do agente na sua frota de VMs, siga estas etapas:

Console

Para atualizar uma política zonal, siga estas etapas. Para atualizar uma política global, consulte a guia gcloud.

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique na política que você quer modificar.

  3. Na página Detalhes da política de extensão, clique em Editar.

  4. Na seção Gerenciar extensões, ative a opção Extensão do Google Cloud para SAP.

  5. No campo Conteúdo do arquivo de configuração, insira a configuração que você quer aplicar ao agente.

    Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  6. Clique em Concluído.

  7. Clique em Salvar.

gcloud

Zonal

Para modificar a configuração do agente para SAP em VMs em uma zona específica, execute o comando gcloud compute zone-vm-extension-policies update. Quando você atualiza uma política usando a gcloud, a solicitação age como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores atuais da política modificada.

Para modificar a configuração do agente:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --zone=ZONE \
  --extensions=google-cloud-sap-extension \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Substitua:

  • POLICY_NAME: o nome da política de extensão de VM que você quer modificar.
  • ZONE: a Google Cloud zona em que a política é aplicada.

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração do agente para SAP.

    • Também é possível fornecer a configuração do agente como uma string inline usando a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-sap-extension="CONFIG". OGoogle Cloud recomenda que você use --config-from-file.
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai segmentar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai segmentar todas as VMs na zona especificada.

  • PRIORITY_NUMBER: a prioridade que você quer definir para sua política. É possível especificar um número inteiro de 0 a 65535.

  • DESCRIPTION: uma descrição da política de extensão de VM.

Global

Para modificar a configuração do Agente para SAP em VMs no seu projetoGoogle Cloud , execute o comando gcloud beta compute global-vm-extension-policies update. Ao atualizar uma política usando o gcloud, a solicitação age como uma substituição completa. Todos os campos opcionais omitidos voltam aos valores padrão em vez de manter os valores atuais da política modificada.

Para modificar a configuração do agente:

gcloud beta compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=google-cloud-sap-extension \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

Substitua:

  • POLICY_NAME: o nome da política de extensão de VM que você quer modificar.
  • PROJECT_ID: o ID do Google Cloud projeto em que a política está localizada.

  • ROLLOUT_PLAN_OPTION: a opção de lançamento que você quer aplicar à sua política global. Os valores aceitos são slow_rollout (recomendado) e fast_rollout.

    • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.
    • É possível usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração do agente para SAP.

    • Também é possível fornecer a configuração do agente como uma string inline usando a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-sap-extension="CONFIG". OGoogle Cloud recomenda que você use --config-from-file.
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai segmentar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai segmentar todas as VMs no projeto.

  • PRIORITY_NUMBER: a prioridade que você quer definir para sua política. É possível especificar um número inteiro de 0 a 65535.

  • DESCRIPTION: uma descrição da política de extensão de VM.

Atualizar uma política global para incluir novas zonas

Quando você cria VMs em uma nova zona depois de criar e lançar uma política global, o Gerenciador de extensões de VM não aplica automaticamente a política às VMs nas novas zonas. Para incluir as VMs em novas zonas, reinicie o lançamento da política global.

Para reiniciar o lançamento de uma política global, siga estas etapas:

  • No terminal ou no Cloud Shell, execute o comando gcloud beta compute global-vm-extension-policies update e forneça a opção --rollout-entry-uuid da seguinte maneira:

    gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID

    Substitua:

    • UUID: um identificador universal exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Tentar novamente um lançamento.

    • ROLLOUT_PLAN_OPTION: a opção de lançamento que você quer aplicar à sua política global. Os valores aceitos são slow_rollout (recomendado) e fast_rollout.

    • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.

    • É possível usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

Atualizar uma política global para excluir zonas

Para atualizar uma política global e excluir zonas, siga estas etapas:

  • No terminal ou no Cloud Shell, execute o comando gcloud beta compute global-vm-extension-policies update e forneça um plano de lançamento personalizado que especifique as zonas em que a política será aplicada:

    gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID

    Substitua:

    • NEW_CUSTOM_PLAN_NAME: o nome do novo plano de lançamento personalizado que identifica as zonas em que a política será aplicada. Para mais informações sobre a criação de planos de lançamento personalizados, consulte Sobre planos de lançamento.
    • UUID: um identificador universal exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Tentar novamente um lançamento.

Desinstalar o agente de uma frota de VMs

Para desinstalar o agente para SAP da sua frota de VMs, exclua a política do Gerenciador de extensões de VM que gerencia a frota.

Ao excluir uma política, se outra política ativa de menor prioridade for aplicada a uma VM e declarar o agente para SAP, ele vai permanecer instalado nessa VM com base na política de menor prioridade.

O Gerenciador de extensões de VM remove o agente de todas as VMs acessíveis em até um minuto após a exclusão da política. Se uma VM estiver inacessível porque o agente convidado foi removido ou a VM foi excluída, o Gerenciador de extensões de VM vai pular a exclusão do agente para SAP. Se uma VM assim ficar disponível novamente, o Gerenciador de extensões de VM vai remover o agente para SAP.

Para desinstalar o agente para SAP da sua frota de VMs, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique na política que gerencia o agente para SAP na sua frota de VMs.

  3. Na página Detalhes da política de extensão, clique em Excluir e confirme a exclusão.

gcloud

Zonal

Para excluir uma política zonal do Gerenciador de extensões de VM, use o comando gcloud beta compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Substitua:

  • POLICY_NAME: o nome da política zonal que você quer excluir.
  • PROJECT_ID: o ID do Google Cloud projeto em que a política está localizada.
  • ZONE: a Google Cloud zona em que a política está localizada.

Global

Para excluir uma política global do Gerenciador de extensões de VM, use o comando gcloud beta compute global-vm-extension-policies delete):

gcloud beta compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION

Substitua:

  • POLICY_NAME: o nome da política zonal que você quer excluir.
  • PROJECT_ID: o ID do Google Cloud projeto em que a política está localizada.

  • ROLLOUT_PLAN_OPTION: a opção de lançamento que você quer aplicar à sua política global. Os valores aceitos são slow_rollout (recomendado) e fast_rollout.

    • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.
    • É possível usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

Verificar a versão do agente

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

Para garantir que você tenha a versão mais recente do agente do Google Cloud para SAP, verifique se há atualizações periodicamente e atualize o agente.

Verificar se há atualizações

Selecione seu sistema operacional e siga estas etapas:

RHEL

  1. Estabeleça uma conexão SSH com sua instância.
  2. Execute este comando: 
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Estabeleça uma conexão SSH com sua instância.
  2. Execute este comando: 
    sudo zypper list-updates -r google-cloud-sap-agent

Instalar uma atualização

Selecione seu sistema operacional e siga estas etapas:

RHEL

  1. Estabeleça uma conexão SSH com sua instância.
  2. Atualize a instância do agente:
    • (Recomendado) Para atualizar para a versão 3.14 (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 você quer instalar, como 3.1-606637668. Para informações sobre as versões do agente que podem ser instaladas, consulte Listar todas as versões disponíveis do agente.

SLES

  1. Estabeleça uma conexão SSH com sua instância.
  2. Atualize a instância do agente:
    • (Recomendado) Para atualizar para a versão 3.14 (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 você quer instalar, como 3.1-606637668. Para informações sobre as versões do agente que podem ser instaladas, consulte Listar todas as versões disponíveis do agente.

Validar a configuração da coleta de métricas de avaliação do Workload Manager

Para validar se você tem a configuração Google Cloud correta para a coleta das métricas de avaliação do Workload Manager, execute o comando status do agente. Esse comando é compatível com a versão 3.7 do agente.

Para validar a configuração do Google Cloud , siga estas etapas:

  1. Estabeleça uma conexão SSH com a instância do Compute Engine.
  2. Execute este comando: 
    sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

    Se a configuração do Google Cloud para a coleta de métricas de avaliação do Workload Manager estiver correta, a saída vai incluir o seguinte. Sua configuração pode ter valores diferentes dos de 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 a saída indicar que falta alguma configuração, revise as informações fornecidas nas seções anteriores, execute as ações necessárias e execute o comando status novamente para validar a configuração.

Exemplo: arquivo de configuração

Os exemplos a seguir são arquivos de configuração completos do agente doGoogle Cloudpara SAP em execução em um servidor da Solução Bare Metal, em que a coleta de métricas de avaliação do Workload Manager está ativada.

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

  • O exemplo a seguir usa uma chave de repositório de usuários seguro (hdbuserstore) para 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",
      "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 a seguir usa um nome de usuário e um secret do Secret Manager para 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 a seguir usa um nome de usuário e uma senha para autenticação do SAP HANA. Recomendamos que você use um secret do Secret Manager ou uma chave Secure user store (hdbuserstore) para 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
  }
}

Para informações sobre os parâmetros de configuração compatíveis com o agente para SAP, consulte Parâmetros de configuração.

A seguir