Guia de operações do agente do Google Cloud para SAP

Neste guia, abordamos considerações e procedimentos operacionais para executar a versão 3.2 (mais recente) do agente do Google Cloud para SAP em instâncias de VM do Compute Engine e servidores da Solução Bare Metal.

Entenda o ciclo de vida do agente

Ao gerenciar as operações do agente do Google Cloud para SAP, é útil entender o que o agente faz. Veja como isso funciona:

Você precisa instalar o agente do Google Cloud para SAP em cada instância de VM do Compute Engine ou no servidor da Solução Bare Metal que hospeda sistemas SAP. O agente é executado como um serviço do Linux ou do Windows.
Nas instâncias de VM do Compute Engine, o agente combina dados de monitoramento do Monitoring e das APIs Compute Engine.
Em servidores da Solução Bare Metal, para a coleta apenas de métricas do Agente de Host da SAP, o agente não acessa as APIs do Google Cloud.
O Agente de Host da SAP pesquisa o Agente do Google Cloud para SAP em busca de dados em cache, por HTTP. Ele agrega as métricas do agente de host do SAP, relata-as e as armazena no banco de dados SAP NetWeaver.
A transação ST06 ou a interface de linha de comando saposcol do SAP exibe as métricas agregadas do SAP Host Agent.
É possível conferir as métricas do Agente de Host da SAP no Agente do Google Cloud para SAP executando um comando em uma janela de terminal.

Verificar se o agente está em execução

Depois de instalar ou reiniciar o agente, é possível verificar se ele está sendo executado conforme o esperado.

Para verificar se o agente está em execução, siga estas etapas:

Linux

Estabeleça uma conexão SSH com o servidor da Solução Bare Metal ou a instância de VM.

Execute este comando:

systemctl status google-cloud-sap-agent

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

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

Use o RDP para se conectar à instância de VM.
Como administrador, execute o seguinte comando no PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Se o agente estiver em execução, o status mostrará Running.

Se o agente do Google Cloud para SAP não estiver em execução, reinicie o agente.

Verificar a versão do agente

Depois de instalar ou reiniciar o agente do Google Cloud para SAP, é possível verificar a versão do agente.

Para acessar a versão do agente, siga estas etapas:

Linux

Para o RHEL, siga estas etapas:

Use o SSH para se conectar à máquina host.
Execute este comando:
```
yum info google-cloud-sap-agent
```

Para SLES, siga estas etapas:

Use o SSH para se conectar à máquina host.
Execute este comando:
```
zypper info google-cloud-sap-agent
```

Windows

Use o RDP para se conectar à máquina host.
Como administrador, emita o seguinte comando no PowerShell:
```
googet installed google-cloud-sap-agent
```

Listar todas as versões disponíveis do agente

Para listar todas as versões disponíveis do agente do Google Cloud para SAP, siga as etapas a seguir:

RHEL

Estabeleça uma conexão SSH com seu host.

Execute este comando:

sudo yum list --showduplicates google-cloud-sap-agent

SLES

Estabeleça uma conexão SSH com seu host.

Execute este comando:

sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent

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:

No sistema SAP, insira a transação ST06.
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

Conferir as métricas do SAP Host Agent

Depois de instalar ou atualizar a configuração do agente do Google Cloud para SAP, é possível conferir as métricas coletadas do agente SAP Host.

Para conferir as métricas do agente SAP Host coletadas pelo agente do Google Cloud para SAP, siga estas etapas:

Linux

Estabeleça uma conexão SSH com a instância de VM do host do servidor da Solução Bare Metal.

Execute este comando:

curl http://localhost:18181

Se as métricas estiverem disponíveis, você receberá uma saída XML com informações sobre o sistema. Exemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

Use o RDP para se conectar à instância de VM.

Como administrador, emita o seguinte comando no PowerShell:

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

Se as métricas estiverem disponíveis, uma saída XML será exibida com informações sobre o sistema. Exemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Conferir as outras métricas

Depois de atualizar a configuração do agente do Google Cloud para SAP a fim de coletar as métricas de monitoramento do processo ou as métricas de monitoramento do SAP HANA, visualize-as para verificar se o agente está coletando as métricas como esperado.

Para ver as métricas e informações coletadas pelo agente do Google Cloud para SAP no Cloud Monitoring, siga estas etapas:

No console do Google Cloud, acesse a página do Metrics Explorer do Monitoring.

Acessar o Metrics Explorer
Selecione a guia Configuração.
Abra o menu Selecionar uma métrica.
No menu Recursos, selecione Instância de VM.
No menu Categoria da métrica, selecione sap.
No menu Métrica, selecione metric: workload.googleapis.com/sap/service/active ou qualquer uma das novas métricas para criar um gráfico.
Clique em Aplicar.

Um gráfico será exibido com os valores das métricas de série temporal.

Validar o recurso do Backint

Depois de ativar o recurso Backint do agente, é preciso validá-lo criando e restaurando um backup.

Para instruções, consulte Validar backup e recuperação.

Reinicie o agente.

Se o agente do Google Cloud para SAP parar de funcionar ou você atualizar a configuração, reinicie o agente.

Selecione seu sistema operacional e siga estas etapas:

Linux

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.

Execute este comando:

sudo systemctl restart google-cloud-sap-agent

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, execute o seguinte comando no PowerShell:
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

Faça upgrade para o agente do Google Cloud para SAP de outros agentes do Google Cloud

O agente do Google Cloud para SAP é o sucessor de outros agentes do Google Cloud. As seções a seguir fornecem informações para fazer upgrade desses agentes para a versão 3.2 (mais recente) do Agent for SAP do Google Cloud.

Para instruções sobre como instalar e configurar o agente do Google Cloud para SAP, consulte Escolher o guia de instalação e configuração do agente do Google Cloud para SAP.

Como fazer upgrade do agente Backint do Cloud Storage para SAP HANA

Para fazer upgrade do agente do Backint do Cloud Storage para SAP HANA para a versão 3.2 (mais recente), conclua as seguintes etapas:

Verifique se nenhum backup de dados está em andamento ou programado para o período sobreposto ao upgrade.
Desative os backups automáticos de registros definindo o parâmetro enable_auto_log_backup do SAP HANA como no. Para instruções, consulte o documento Ativar e desativar o Backup automático de registros do SAP HANA.
Instale o agente do Google Cloud para SAP. Para instruções, consulte o guia de instalação para seu cenário.
Ativar o recurso do Backint do agente do Google Cloud para SAP. Para ver instruções, consulte Configurar backup e recuperação baseados no Backint.

A ativação do recurso do Backint do agente do Google Cloud para SAP detecta automaticamente o agente do Backint no host e o desativa da máquina host.
Para criar uma versão JSON do arquivo de texto de configuração do Backint, execute o seguinte comando para cada um dos arquivos de texto:
```
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
```
Substitua PATH_TO_PARAMETERS_FILE pelo caminho do seu arquivo PARAMETERS.txt.

Os arquivos JSON são criados no mesmo local do sistema de arquivos que os arquivos , desde que o agente para SAP do Google Cloud tenha permissão de acesso a esses locais. Embora o agente para SAP do Google Cloud seja capaz de interpretar os parâmetros relacionados ao Backint especificados no formato , recomendamos que você use os arquivos JSON para atualizar qualquer configuração.
Ative os backups automáticos de registros definindo o parâmetro enable_auto_log_backup do SAP HANA como yes. Para instruções, consulte o documento Ativar e desativar o Backup automático de registros do SAP HANA.
Validar o backup e a recuperação

Quando você faz esse upgrade, acontece o seguinte:

Para fins de backup e referência, todos os arquivos de instalação no diretório backint-gcs do agente do Backint são copiados para backint-gcs-old-TIMESTAMP/. Eles são necessários caso você precise voltar a usar o agente do Backint.
A pasta backint-gcs é limpa para conter apenas os arquivos necessários para executar o agente para SAP do Google Cloud, que inclui o arquivo de configuração, parameters.json, e os arquivos de configuração do Backint, como PARAMETERS.txt.

Para informações sobre o mapeamento dos parâmetros de configuração entre o agente do Backint e o agente para SAP do Google Cloud, abra a seção a seguir.

Mapeamento de parâmetros de configuração

Nome do parâmetro no agente do Backint	Nome do parâmetro no agente do Google Cloud para SAP
`BUCKET`	`bucket`
`DISABLE_COMPRESSION`	`compress`
`ENCRYPTION_KEY`	`encryption_key`
`KMS_KEY_NAME`	`kms_key`
`MAX_GCS_RETRY`	`retries`
`PARALLEL_FACTOR`	`parallel_streams`
`PARALLEL_PART_SIZE`	Não está disponível no agente do Google Cloud para SAP.
`RATE_LIMIT_MB`	`rate_limit_mb`
`SERVICE_ACCOUNT`	`service_account_key`
`THREADS`	`thread`
`READ_IDLE_TIMEOUT`	`file_read_timeout_ms`
`CHUNK_SIZE_MB`	`buffer_size_mb`
`HTTP_READ_TIMEOUT`	Não está disponível no agente do Google Cloud para SAP.

Como fazer upgrade do agente de monitoramento para SAP HANA

A instalação da versão 3.2 (mais recente) do agente do Google Cloud para SAP detecta automaticamente versões do agente de monitoramento para SAP HANA, desativa-as e, em seguida, remove-as das máquinas host durante a instalação.

Se esse agente for detectado, a configuração dele será migrada para o Agente para SAP do Google Cloud durante a instalação. Para fins de backup e referência, a configuração do agente de monitoramento para SAP HANA é copiada para o seguinte arquivo:

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

Como fazer upgrade de instâncias com SSL ativado

Se você tiver configurado o agente de monitoramento do SAP HANA para usar certificados SSL para comunicação com as instâncias do SAP HANA, ao instalar o agente do Google Cloud para SAP, toda a configuração de monitoramento do SAP HANA, exceto o SSL, são migradas para o agente do Google Cloud para SAP. Nesse caso, para usar o agente do Google Cloud para SAP a fim de monitorar as instâncias do SAP HANA, é preciso concluir as seguintes etapas:

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
Na seção hana_monitoring_configuration, defina a propriedade enabled como true.
Na seção hana_monitoring_configuration.hana_instances, faça o seguinte para cada instância do SAP HANA que usa o protocolo TLS/SSL para comunicação segura:
1. Especifique o parâmetro enable_ssl e defina o valor dele como true.
2. Especifique o parâmetro host_name_in_certificate e defina o nome do host do SAP HANA, conforme especificado no certificado TLS/SSL, como o valor.
3. Especifique o parâmetro tls_root_ca_file e defina o caminho em que o certificado TLS/SSL está armazenado, bem como o valor dele.
Salve o arquivo de configuração.
Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Verifique se o agente está coletando as métricas de monitoramento do SAP HANA. Para mais instruções, consulte Acessar as outras métricas.
Desinstalar o agente de monitoramento para SAP HANA.

Se você tiver problemas de conexão com as instâncias do SAP HANA após esse upgrade, será possível visualizar os registros do agente na geração de registros e usar a guia de solução de problemas para resolvê-los.

Como fazer upgrade do agente de monitoramento para SAP NetWeaver

A instalação da versão 3.2 (mais recente) do agente do Google Cloud para SAP detecta automaticamente as versões do agente de monitoramento para SAP NetWeaver.

Se esse agente for detectado, a configuração dele será migrada para o Agente para SAP do Google Cloud durante a instalação.

Atualizar o agente do Google Cloud para SAP

Para garantir que você tenha a versão mais recente do agente do Google Cloud para SAP, é preciso verificar as atualizações periodicamente e atualizar o agente.

Verificar se há atualizações

Selecione seu sistema operacional e siga estas etapas:

RHEL

Estabeleça uma conexão SSH com sua instância.

Execute este comando:

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

SLES

Estabeleça uma conexão SSH com sua instância.

Execute este comando:

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

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, emita o seguinte comando no PowerShell:
```
googet latest google-cloud-sap-agent
```

Instalar uma atualização

Selecione seu sistema operacional e siga estas etapas:

RHEL

Estabeleça uma conexão SSH com sua instância.
Atualize a instância do agente:
- (Recomendado) Para atualizar para a versão 3.2 (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

Estabeleça uma conexão SSH com sua instância.
Atualize a instância do agente:
- (Recomendado) Para atualizar para a versão 3.2 (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.

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Para atualizar para a versão 3.2 (mais recente) do agente, como administrador, execute o seguinte comando no PowerShell:
```
googet install google-cloud-sap-agent
```

Reverter para usar os outros agentes do Google Cloud

Nesta seção, você encontra informações sobre como reverter o uso da versão 3.2 (mais recente) do agente do Google Cloud para SAP e usar os agentes antecessores.

Reverter para o uso do agente do Backint

Se você quiser reverter para usar o agente do Backint e parar de usar o recurso do Backint do agente do Google Cloud para SAP, siga estas etapas:

Exclua todos os arquivos relacionados ao recurso Backint do agente para SAP do Google Cloud:
```
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
Substitua SID pelo SID do seu sistema SAP.
Restaure os arquivos do agente do Backint que foram armazenados como backup quando você fez upgrade para usar o agente do Google Cloud para SAP, copiando-os para o diretório backint-gcs:
```
cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
Substitua:
- SID: o SID do seu sistema SAP
- TIMESTAMP: o valor do carimbo de data/hora no nome da pasta criada quando você fez upgrade do agente do Backint para o agente do Google Cloud para SAP
Use o SAP HANA Studio ou o SAP HANA Cockpit para editar o arquivo global.ini e atualizar os caminhos para seus arquivos de configuração .txt. Para informações sobre os parâmetros para os quais é preciso especificar o caminho para os arquivos .txt, consulte Configurar SAP HANA para o recurso Backint.
Salve as alterações que você fez no arquivo global.ini.

Reverter para o uso do agente de monitoramento do SAP HANA

Se você quiser reverter para usar o agente de monitoramento para SAP HANA e parar de usar o recurso de monitoramento do SAP HANA do agente do Google Cloud para SAP, siga estas etapas:

RHEL

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Para evitar a coleta de métricas duplicadas, desative a coleta de métricas de monitoramento do SAP HANA pelo agente do Google Cloud para SAP:
1. Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. Na seção hana_monitoring_configuration, defina o parâmetro enabled como false.
3. Salve o arquivo de configuração.
4. Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Copie a configuração do agente de monitoramento do SAP HANA deste arquivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instale o agente de monitoramento para SAP HANA versão 2. Para instruções de instalação, consulte o Guia de instalação e operação do agente de monitoramento para SAP HANA V2.0.
No arquivo a seguir, cole a configuração do agente de monitoramento para SAP HANA que você copiou em uma etapa anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicie o agente de monitoramento do SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

SLES

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
Para evitar a coleta de métricas duplicadas, desative a coleta de métricas de monitoramento do SAP HANA pelo agente do Google Cloud para SAP:
1. Abra o arquivo de configuração do agente do Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. Na seção hana_monitoring_configuration, defina o parâmetro enabled como false.
3. Salve o arquivo de configuração.
4. Reinicie o agente para que as novas configurações entrem em vigor.
```
sudo systemctl restart google-cloud-sap-agent
```
Copie a configuração do agente de monitoramento do SAP HANA deste arquivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instale o agente de monitoramento para SAP HANA versão 2. Para instruções de instalação, consulte o Guia de instalação e operação do agente de monitoramento para SAP HANA V2.0.
No arquivo a seguir, cole a configuração do agente de monitoramento para SAP HANA que você copiou em uma etapa anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicie o agente de monitoramento do SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

Desinstalar o agente

Para desinstalar ou remover o agente do host, siga as etapas a seguir:

RHEL

Estabeleça uma conexão SSH com seu host.
Execute este comando:
```
sudo yum remove google-cloud-sap-agent
```

SLES

Estabeleça uma conexão SSH com seu host.

Execute este comando:

sudo zypper remove google-cloud-sap-agent

Windows

Estabeleça uma conexão RDP com sua instância de VM do host.
Como administrador, emita o seguinte comando no PowerShell:
```
Remove-Service -Name 'google-cloud-sap-agent'
```

Ver os registros do agente no Cloud Logging

Por padrão, os registros do agente do Google Cloud para SAP são redirecionados das instâncias de VM e dos servidores da Solução Bare Metal para o Cloud Logging.

Para ver os registros do agente no Logging, siga estas etapas:

No console do Google Cloud, acesse a página do Explorador de registros.

Acessar o "Explorador de registros"
Acesse o painel Consulta.
No menu suspenso Recursos, selecione Global e clique em Aplicar.
No editor de consultas, insira google-cloud-sap-agent.
Clique em Executar consulta.

Você verá os registros gerados pelas instâncias do agente em execução em todas as instâncias de VM ou nos servidores da Solução Bare Metal. Para filtrar os registros de uma máquina específica, use os filtros disponíveis na interface.

É possível desativar o redirecionamento padrão dos registros do agente relacionados à coleta de métricas. Para isso, siga as etapas abaixo:

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.

Abra o seguinte arquivo de configuração:

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

Para o parâmetro log_to_cloud, atualize o valor para false.
Salve o arquivo de configuração.
Reinicie o agente para que essa alteração entre em vigor.

Para desativar o redirecionamento padrão dos registros relacionados ao recurso Backint do Agente do Google Cloud para SAP, edite o arquivo de configuração do Backint e defina o parâmetro log_to_cloud como false.