Como solucionar problemas com o agente Backint para SAP HANA

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:

  1. 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.

  2. Siga as instruções a seguir para confirmar se você pode listar os objetos armazenados no bucket:

    gsutil ls gs://bucket/

  3. Crie um arquivo de teste:

    touch test.txt

  4. Confirme se é possível gravar o arquivo de teste no bucket:

    gsutil cp test.txt gs://bucket/test.txt

  5. 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.