Como solucionar problemas com o agente Backint para SAP HANA

Importante: para novas instalações, em vez de usar o agente Backint do Cloud Storage para SAP HANA, recomendamos usar o sucessor dele: o agente do Google Cloud para SAP. A partir da versão 3.0, o Agente do Google Cloud para SAP combina a coleta de métricas do SAP Host Agent com outros recursos, como backup e recuperação baseados no Backint para o SAP HANA.

Se você usa o agente Backint, recomendamos que comece a usar a versão 3.2 (mais recente) do agente do Google Cloud para SAP assim que possível, idealmente antes que o suporte ao agente Backint seja desativado. Para instruções de upgrade, consulte Fazer upgrade do agente do Google Cloud para SAP de outros agentes do Google Cloud.

O suporte ao agente Backint se encerrará em fevereiro de 2025. Esse agente não é compatível com os tipos de máquina do Compute Engine que ficaram em disponibilidade geral (GA) após fevereiro de 2024.

Se ocorrerem erros durante a execução de um backup ou de uma recuperação, serão exibidas mensagens de erro no SAP HANA Studio ou SAP HANA Cockpit, portanto, verifique primeiro as informações sobre a causa desses erros. Essas informações podem ser exibidas nos arquivos de rastreamento backup.log e backint.log. Quando forem usados contêineres de banco de dados multilocação (MDC, na sigla em inglês), certifique-se de selecionar o nome do banco de dados relevante.

Verifique se você instalou o agente do Backint como o usuário sidadm.

Arquivos de registros

Se aparecer algum erro, analise os seguintes registros:

SAP HANA backup.log, que contém informações sobre as operações de backup e recuperação do SAP HANA.
SAP HANA backint.log, que contém as chamadas para a interface de backup usada pelo agente do Backint e outras ferramentas de backup externo.
Arquivos de registro do agente do Backint, que contêm eventos operacionais e de instalação do agente do Backint. Os arquivos de registro do agente do Backint estão localizados em /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. Os registros do agente do Backint podem incluir indicações de erros de comunicação com o Cloud Storage e problemas de configuração ou permissões relacionados.
Os registros do Google Cloud, que podem conter erros relacionados à conta de serviço usada pelo agente do Backint. Para analisar os registros do Google Cloud, consulte a página Visualizador de Explorer no console do Google Cloud.

Além disso, verifique as informações de E/S de disco e de rede no host do SAP HANA para verificar a atividade.

Para mais informações sobre a geração de registros do agente do Backint, consulte Como gerar registros do agente do Backint.

Problemas de conectividade

Se o agente do Backint não puder se conectar ao bucket do Cloud Storage, revise as etapas de configuração. Verifique especificamente os seguintes itens:

Tente fazer o backup novamente ou restaurar para garantir que o erro não foi apenas um problema de conectividade momentâneo.
Se você estiver usando a conta de serviço da VM do host com o agente do Backint, o escopo do acesso do Armazenamento estará listado como Leitura e gravação em Escopos de acesso da API Cloud na página Detalhes da instância de VM do console do Google Cloud. Se não estiver, interrompa a instância e edite o escopo de acesso.
Se você criou uma conta de serviço para o agente do Backint:
- Na guia Permissões da página Detalhes do bucket no console do Google Cloud, confirme se a conta de serviço do agente do Backint está listada e se tem o papel Administrador de objetos do Storage.
- Confirme se você criou uma chave privada, armazenou-a no host do SAP HANA e especificou corretamente o caminho para o arquivo de chave JSON no arquivo de configuração do agente do Backint /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
Todos os parâmetros foram especificados corretamente no arquivo de configuração do agente do Backint (parameters.txt) e no arquivo do SAP HANA (global.ini).

É possível testar o acesso ao bucket do Cloud Storage pelo host do SAP HANA usando a ferramenta gsutil do Cloud Storage incluída na Google Cloud CLI. Usando a ferramenta gsutil, salve e acesse um arquivo de texto no bucket do Cloud Storage:

Se você não estiver usando a conta de serviço padrão, autentique com o Google Cloud como um usuário autorizado ao bucket do Cloud Storage ou à conta de serviço do agente do Backint:
```
gcloud auth login user-account
```
Ou:
```
gcloud auth activate-service-account --key-file=/path/key-file-name.json
```
Para mais informações sobre a autenticação do Cloud Storage de uma conta de serviço, consulte Autenticação do gsutil.
Siga as instruções a seguir para confirmar se você pode listar os objetos armazenados no bucket:
```
gsutil ls gs://bucket/
```
Crie um arquivo de teste:
```
touch test.txt
```
Confirme se é possível gravar o arquivo de teste no bucket:
```
gsutil cp test.txt gs://bucket/test.txt
```
Confirme se é possível ler o arquivo de teste no bucket:
```
gsutil cp gs://bucket/test.txt
```

Baixa capacidade

Se a capacidade estiver abaixo do esperado, verifique se a compactação está desativada.

Para desativar a compactação, adicione a sinalização #DISABLE_COMPRESSION ao arquivo parameters.txt do agente do Backint.

Erros de multistreaming

Se ocorrerem erros durante o multistreaming, altere o número de fluxos para um (1) e veja se o erro está relacionado à quantidade de fluxos.

Para mais informações sobre a geração de registros do agente do Backint, consulte Backups de dados multistreaming com o agente do Backint.