Neste guia, abordamos considerações e procedimentos operacionais para executar a versão 3.6 (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 comandosaposcol
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 do Compute Engine.
Execute este comando:
systemctl status google-cloud-sap-agent
Se o agente estiver funcionando corretamente, a saída conterá
active (running)
. Por 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 do Compute Engine.
Como administrador, emita o seguinte comando no PowerShell:
Se o agente estiver em execução, o status mostrará$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
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
- Provedor de nuvem:
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 do host do Compute Engine ou o 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. Por 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 do Compute Engine.
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. Por 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.
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.
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, emita o seguinte comando no PowerShell:
Restart-Service -Name 'google-cloud-sap-agent' -Force
Ativar ou desativar o agente
Para ativar o monitoramento adequado, o serviço systemd
do agente do Google Cloud para SAP
na sua instância de computação precisa estar sempre em execução. No entanto, se você precisar desativar ou interromper o agente na sua instância de computação baseada em Linux, execute o seguinte comando:
sudo /usr/bin/google_cloud_sap_agent service -disable
Para ativar e iniciar o serviço systemd
do agente na instância de computação baseada em Linux:
sudo /usr/bin/google_cloud_sap_agent service -enable
Quando você desativa ou ativa o serviço systemd
do agente no Linux, a ação é
registrada no seguinte arquivo: /var/log/google-cloud-sap-agent/service.log
.
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.6 (mais recente) do Agente para 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.6 (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 comono
. 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 arquivoPARAMETERS.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 comoyes
. Para instruções, consulte o documento Ativar e desativar o Backup automático de registros do SAP HANA.
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 parabackint-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, comoPARAMETERS.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.6 (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 propriedadeenabled
comotrue
.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:Especifique o parâmetro
enable_ssl
e defina o valor dele comotrue
.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.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.6 (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 a instância do host do Compute Engine.
- 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.6 (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, como3.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.
- (Recomendado) Para atualizar para a versão 3.6 (mais recente)
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.6 (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, como3.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.
- (Recomendado) Para atualizar para a versão 3.6 (mais recente)
do agente:
Windows
- Estabeleça uma conexão RDP com a instância do host do Compute Engine.
- Para atualizar para a versão 3.6 (mais recente) do agente, como
administrador, execute o seguinte comando no PowerShell:
googet install google-cloud-sap-agent
Fazer downgrade do agente do Google Cloud para SAP
Embora a gente recomende que você sempre use a versão mais recente do Agent para SAP do Google Cloud, é possível fazer downgrade da versão mais recente para qualquer outra com suporte do agente executando o seguinte 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 downgrade 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.
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.6 (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 SAPTIMESTAMP
: 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:
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 o parâmetroenabled
comofalse
.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
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:
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 o parâmetroenabled
comofalse
.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
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.
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 parafalse
.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
.