Instalar o agente de monitoramento para SAP NetWeaver em uma VM do Compute Engine

Aviso: o suporte ao agente de monitoramento do Google Cloud para SAP NetWeaver foi encerrado em 14 de fevereiro de 2024.

Se você estiver usando o agente de monitoramento para SAP NetWeaver, recomendamos instalar o sucessor dele, o agente do Google Cloud para SAP, assim que possível. O agente para SAP combina o agente de monitoramento para SAP NetWeaver com novos recursos, como avaliação do gerenciador de cargas de trabalho e monitoramento de processos.

O agente de monitoramento do Google Cloud para SAP NetWeaver é necessário para a compatibilidade da SAP com sistemas SAP em execução no Google Cloud, incluindo SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB e outros.

Ao instalar o agente em uma instância do VM do Compute Engine, o agente de monitoramento do SAP NetWeaver combina os dados de monitoramento do Monitoring e as APIs do Compute Engine e fornece esses dados ao agente de host da SAP.

Para instalar o agente de monitoramento para SAP NetWeaver em um servidor da Solução Bare Metal, consulte Instalar o agente de monitoramento para SAP Outline em um servidor da Solução Bare Metal.

Visão geral da instalação

No Linux, você instala o agente de monitoramento para o SAP NetWeaver usando comandos padrão de gerenciamento de pacotes do sistema operacional, yum ou zypper. O comando de gerenciamento de pacotes conclui as seguintes tarefas:

• Download da versão mais recente do agente de monitoramento do SAP NetWeaver.
• Cria o agente como um serviço systemd do Linux, chamado google-sapnetweavermonitoring-agent.

No Windows, quando você emite o comando de instalação, o script de instalação fornecido conclui as seguintes tarefas:

• Download da versão mais recente do agente de monitoramento do SAP NetWeaver.
• Cria um serviço do Windows chamado google-sapnetweavermonitoring-agent e uma tarefa programada que é executada a cada minuto para verificar se o serviço ainda está em execução e, se necessário, reiniciá-lo.

Aviso: não interrompa manualmente o serviço do Windows ou exclua a tarefa programada.

Pré-requisitos do agente de monitoramento do SAP NetWeaver

Antes de instalar o agente de monitoramento para SAP NetWeaver, é necessário garantir o acesso às APIs do Google Cloud e garantir que o JRE adequado esteja disponível.

Acesso às APIs do Google Cloud

Quando o agente de monitoramento do SAP NetWeaver está em execução em uma VM do Compute Engine, ele lê dados do Monitoring.

O acesso às APIs do Monitoring pode ser controlado pelas permissões do IAM concedidas à conta de serviço da VM do host, pelos escopos de acesso da API Google Cloud concedidos à VM ou pelos dois.

O Compute Engine recomenda usar apenas as permissões do IAM da conta de serviço da VM para controlar o acesso aos recursos do Google Cloud e definir os escopos de acesso da VM para permitir acesso total a todas as APIs do Cloud. Para mais informações, consulte Práticas recomendadas.

O agente de monitoramento do SAP NetWeaver usa a conta de serviço da VM host para recuperar métricas do Cloud Monitoring. Consequentemente, o agente de monitoramento exige que a VM do host tenha uma conta de serviço e que ela inclua a permissão monitoring.timeSeries.list, que está contida no papel predefinido Visualizador do Monitoring.

Se você limitar o acesso às APIs do Cloud, o agente de monitoramento do SAP NetWeaver exigirá os seguintes escopos mínimos de acesso da API Cloud na instância da VM do host:

• Compute Engine: somente leitura
• API Stackdriver Monitoring: somente leitura

Se você estiver executando o SAP NetWeaver em uma VM que não tem um endereço IP externo, será necessário ativar o acesso às APIs e aos serviços do Google Cloud para o agente de monitoramento do SAP NetWeaver.

Para ativar o acesso particular do Google em uma VM do Compute Engine em uma sub-rede, consulte Como configurar o acesso particular do Google.

Java Runtime Environment

O agente de monitoramento do SAP NetWeaver versão 2 requer uma versão específica do Java Runtime Environment (JRE).

Se o servidor em que você estiver instalando o agente tiver acesso à Internet, o agente fará o download dos arquivos automaticamente durante a instalação.

Caso o servidor não tenha acesso à Internet, você mesmo poderá fazer upload dos arquivos para o servidor por conta própria.

Linux

Se você mesmo precisar fazer o upload deles, antes de instalar o agente, faça upload do arquivo a seguir para o diretório /tmp/gcpsapdeps/:

https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_linux-x64_bin.tar.gz

Windows

Se você mesmo precisar fazer o upload deles, antes de instalar o agente, faça upload do arquivo a seguir para o diretório C:\gcpsapdeps:

https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_windows-x64_bin.zip

Como instalar o agente de monitoramento para SAP NetWeaver

Para instalar o agente de monitoramento do SAP NetWeaver, selecione seu sistema operacional e siga estas etapas:

Linux

Adicionar o repositório RPM do Google Cloud à lista de repositórios do SO

É preciso adicionar o URL do repositório do RPM do Google Cloud para o agente de monitoramento do SAP NetWeaver à lista de repositórios de pacotes do sistema operacional. A maneira como você adiciona um repositório é diferente se está usando um sistema operacional Red Hat ou SLES.

RHEL

Para adicionar o repositório do Google Cloud RPM ao RHEL, siga estas etapas:

1. Estabeleça uma conexão SSH com sua VM do host.

2. Execute o comando a seguir depois de substituir RHEL_VERSION pelo número da versão do sistema operacional. Por exemplo, substitua RHEL_VERSION por 7 no RHEL 7 ou 8 no RHEL 8. Talvez seja necessário rolar para ver RHEL_VERSION.

   sudo tee /etc/yum.repos.d/google-sapnetweavermonitoring-agent.repo << EOM
   [google-sapnetweavermonitoring-agent]
   name=Google Cloud monitoring agent for SAP NetWeaver
   baseurl=https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-elRHEL_VERSION-\$basearch
   enabled=1
   gpgcheck=0
   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

SLES

Para adicionar o repositório do Google Cloud RPM ao SLES, siga estas etapas:

1. Estabeleça uma conexão SSH com sua VM do host.

2. Execute o comando a seguir depois de substituir SLES_VERSION pelo número da versão do sistema operacional. Por exemplo, substitua SLES_VERSION por 12 para SLES 12 ou 15 para SLES 15. Talvez seja necessário rolar para ver SLES_VERSION.

   zypper addrepo --gpgcheck-allow-unsigned-package --refresh \
   https://packages.cloud.google.com/yum/repos/google-sapnetweavermonitoring-agent-slesSLES_VERSION-\$basearch google-sapnetweavermonitoring-agent

Instalar o agente

Para instalar o agente de monitoramento do SAP NetWeaver, use o gerenciador de pacotes do SO.

Para instalar o agente, selecione seu sistema operacional e siga estas etapas:

RHEL

1. Estabeleça uma conexão SSH com sua VM do host.

2. Execute este comando:

   sudo yum install google-sapnetweavermonitoring-agent

SLES

1. Estabeleça uma conexão SSH com sua VM do host.

2. Execute este comando:

   sudo zypper --no-gpg-checks install google-sapnetweavermonitoring-agent

Windows

Para instalar o agente de monitoramento para SAP NetWeaver como administrador na VM do host, execute o seguinte comando:

. { Invoke-WebRequest -useb https://storage.googleapis.com/cloudsapdeploy/netweaver-agent-windows/install.ps1 } | iex

Depois de instalar o agente de monitoramento para SAP NetWeaver e o SAP Host Agent, valide a instalação do agente de monitoramento para SAP NetWeaver, conforme descrito em Validar a instalação do agente

Validar a instalação do agente de monitoramento para SAP NetWeaver

Para verificar se o agente de monitoramento do SAP NetWeaver está em execução, selecione o sistema operacional e siga estas etapas:

Linux

1. Estabeleça uma conexão SSH com a instância de VM do host.

2. Execute este comando:

   sudo systemctl status google-sapnetweavermonitoring-agent

   Se o agente de monitoramento do SAP NetWeaver estiver funcionando corretamente, a saída conterá active (running). Exemplo:

   google-sapnetweavermonitoring-agent.service - Google Cloud monitoring agent for SAP NetWeaver
   Loaded: loaded (/usr/lib/systemd/system/google-sapnetweavermonitoring-agent.service; enabled; vendor preset: disabled)
   Active:  active (running)  since Thu 2021-09-02 07:21:42 UTC; 742ms ago
   Main PID: 10723 (java)
   Tasks: 26 (limit: 512)
   CGroup: /system.slice/google-sapnetweavermonitoring-agent.service
          └─10723 /usr/sap/google-sapnetweavermonitoring-agent/jre/bin/java -Xms32m -Xmx64m -cp /usr/sap/google-sapnetweavermonitoring-age...
   

Windows

1. Use o RDP para se conectar à instância de VM a ser monitorada.

2. Execute este comando:

   Get-Service -Name google-sapnetweavermonitoring-agent

   Se o agente de monitoramento do SAP NetWeaver estiver funcionando corretamente, a coluna Status mostrará Running. Exemplo:

       Status   Name               DisplayName
       ------   ----               -----------
       Running  google-sapnetwe... Google Cloud monitoring agent for S...
   

Se o agente de monitoramento não estiver em execução, consulte a seção "Guia de operações" sobre como reiniciar o agente.

Verificar se o SAP Host Agent está recebendo métricas

Para verificar se as métricas de infraestrutura são coletadas pelo agente do Google Cloud para SAP e enviadas corretamente ao agente de host da SAP, siga estas etapas:

1. No sistema SAP, insira a transação ST06.

2. No painel de visão geral, verifique a disponibilidade e o conteúdo dos seguintes campos para a configuração completa da infraestrutura de monitoramento da SAP e do Google:

   • Provedor de nuvem: Google Cloud Platform
   • Acesso ao monitoramento avançado: TRUE
   • Detalhes do monitoramento avançado: ACTIVE