Guia de instalação do agente do Backint do Cloud Storage para SAP HANA

Nestas instruções, mostramos como instalar e configurar o agente do Backint do Cloud Storage para SAP HANA (agente do Backint).

Para informações sobre as opções de configuração do agente do Backint, consulte a Visão geral do agente do Backint do Cloud Storage para SAP HANA.

Pré-requisitos

Antes de instalar o agente do Backint, primeiro você precisa instalar o SAP HANA. Para instalar o SAP HANA no Google Cloud, consulte o Guia de implantação do SAP HANA.

Para informações sobre como instalar o SAP HANA na solução Bare Metal, consulte o guia de planejamento do SAP HANA na solução Bare Metal.

Como criar um bucket do Cloud Storage para backups

Antes de poder configurar o agente do Backint, você precisa criar um bucket do Cloud Storage para armazenar os backups.

Para criar um bucket do Cloud Storage, use o Console do Cloud.

Para informações sobre as opções de bucket, consulte Como armazenar backups em buckets do Cloud Storage.

  1. Abra o navegador do Cloud Storage no Console do Cloud.

    Abra o navegador do Cloud Storage

  2. Clique em CRIAR BUCKET.

  3. Nomeie seu bucket e clique em Continuar.

  4. Siga as instruções para selecionar as opções de bucket.

  5. Clique em Criar.

  6. Para configurar permissões do bucket, clique na guia "Permissões". Por padrão, como proprietário do bucket, você tem acesso de leitura/gravação a ele. Também é possível permitir que outros membros do seu grupo ou usuários individuais acessem seu bucket.

Como instalar o agente do Backint no host do SAP HANA

O agente do Backint e o banco de dados do SAP HANA são instalados no mesmo sistema de arquivos compartilhado.

Em uma implantação de escalonamento horizontal do SAP HANA, instale o agente do Backint em cada nó do sistema SAP HANA. Para simplificar a administração, armazene os arquivos de configuração em um local compartilhado que seja acessível a todos os nós da implantação, como /hana/shared.

  1. Conecte-se ao host do SAP HANA usando SSH. Se o host for uma VM do Compute Engine, da página de instâncias de VM, clique no botão SSH da instância de VM ou use o método de SSH que preferir.

  2. Mude para administrador do sistema do SAP HANA.

    sudo su - sidadm
    
  3. Faça o download e instale o agente do Backint.

    curl https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh | bash
    

    O script install.sh executa as seguintes ações:

    • Instala o agente do Backint como um arquivo JAR em /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
    • faz o download de uma versão compatível do Java Runtime Environment;
    • Configura o script backint que invoca o agente do Backint. Não modifique o script backint, a menos que seja instruído pelo Cloud Customer Care.
    • Depois de concluído, a mensagem será enviada para que você atualize o arquivo parameters.txt e configure a autenticação. Para mais detalhes, consulte Como configurar o agente do Backint e o SAP HANA.
  4. Se algum dos cenários a seguir se aplicar a você, será necessário criar uma conta de serviço para o agente do Backint:

    • Você precisa do agente do Backint para usar um conjunto diferente de permissões de recursos do usado pela VM do Compute Engine do host.
    • O SAP HANA está sendo executado na solução Bare Metal.
    • O SAP HANA não está sendo executado no Google Cloud.

    Para criar uma conta de serviço para o agente do Backint:

    1. Abra a página "Contas de serviço" em "IAM e administrador" no Console do Google Cloud.

      Acessar a página "Contas de serviço"

    2. Clique em + CRIAR CONTA DE SERVIÇO.

    3. Especifique um nome para a conta de serviço e, opcionalmente, uma descrição.

    4. Clique em CRIAR.

    5. No painel Permissões de conta de serviço, clique em Continuar para criar a conta de serviço sem permissões.

    6. Conceda aos usuários acesso à conta de serviço, conforme adequado.

    7. Clique em Concluído.

    8. Na página Contas de serviço no Console do Cloud, clique na conta de serviço que você acabou de criar.

    9. Na página Detalhes da conta de serviço, em Chaves, clique em ADICIONAR CHAVE > Criar nova chave para criar uma chave de conta de serviço.

    10. Aceite o JSON como tipo de chave e clique em CRIAR. Uma chave privada é salva em seu computador.

  5. Faça upload do arquivo de chave JSON para o host do SAP HANA.

    • Armazene o arquivo .json em um diretório que o usuário sidadm possa acessar, como /usr/sap/SID/home
    • Verifique se o usuário sidadm está autorizado a ler o arquivo.
  6. Atualize o bucket do Cloud Storage para conceder permissão à conta de serviço para usar o bucket:

    1. Clique no nome do bucket no navegador do Cloud Storage.

      Abra o navegador do Cloud Storage

    2. Clique na guia Permissões..

    3. Clique em Adicionar membros.

    4. No campo Novos membros, insira o endereço de e-mail completo da conta de serviço. Exemplo:

      backint-test@my-project.iam.gserviceaccount.com

    5. Clique na lista suspensa Selecionar um papel e insira "Administrador de objetos do Storage".

    6. Clique em Save.

Como configurar o agente do Backint e o SAP HANA

Para configurar o agente do Backint, especifique parâmetros em um arquivo de configuração de texto simples.

É possível usar a mesma configuração única para todos os tipos de backup (dados, registro e catálogo) ou usar uma configuração diferente para cada tipo de backup criando um arquivo de configuração separado para cada um.

Você especifica o caminho para cada arquivo de configuração do agente do Backint no SAP HANA, especificando parâmetros no arquivo global.ini.

  1. Configure o agente do Backint especificando os parâmetros no arquivo parameters.txt. É possível renomear o arquivo conforme apropriado.

    1. Use o método que preferir para editar o arquivo parameters.txt. O arquivo é instalado no diretório a seguir.

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      

      É possível renomear o arquivo parameters.txt e usar arquivos de configuração diferentes para backups de dados, registros e catálogos.

      Para descrições dos parâmetros de configuração e recomendações de desempenho, consulte Opções de configuração do agente do Backint.

    2. Especifique o nome do bucket do Cloud Storage a ser usado para os backups.

      #BUCKET bucket-name
      
    3. Se você tiver criado uma conta de serviço e uma chave privada para o agente do Backint, especifique o caminho para o arquivo de chave JSON.

      #SERVICE_ACCOUNT /path/key-file-name.json

    O exemplo a seguir mostra o conteúdo de um arquivo parameters.txt válido.

    #BUCKET hana-backups
    #DISABLE_COMPRESSION
    #SERVICE_ACCOUNT #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json
  2. Configure o SAP HANA para usar o agente do Backint:

    1. Use o SAP HANA Studio ou o cockpit do SAP HANA para definir os seguintes parâmetros na seção backup do arquivo de configuração global.ini para os valores mostrados na tabela. Não é necessário reiniciar o SAP HANA depois de fazer essas alterações.

      Se você estiver usando um arquivo de configuração diferente para cada tipo diferente de backup, especifique os diferentes arquivos de configuração, conforme mostrado na tabela a seguir. Caso contrário, especifique o mesmo arquivo de configuração para todos os tipos.

      Parâmetro Valor
      catalog_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint true
      data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint true
    2. Use o SAP HANA Studio para especificar o mesmo valor para basepath_catalogbackup e basepath_logbackup na seção persistence do arquivo global.ini. Exemplo:

      basepath_catalogbackup e basepath_logbackup mostram o mesmo valor na seção de permanência do arquivo global.ini

  3. Teste a instalação criando um backup no bucket do Cloud Storage e fazendo a restauração pelo backup.

  4. Para fins de compatibilidade com a função de atualização automática do agente do Backint, ative solicitações HTTP remotas da VM do SAP HANA para https://www.googleapis.com/.

  5. Como opção, ative o Cloud Logging.

    • Se o SAP HANA estiver em execução em uma VM do Compute Engine, adicione o gerenciador com.google.cloud.logging.LoggingHandler à propriedade com.google.cloud.partners.handlers no arquivo /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties.
    • Se o SAP HANA estiver em execução fora do Google Cloud, instale o SDK do Cloud e configure o login padrão do aplicativo usando o comando gcloud auth application-default login.

Como atualizar o agente do Backint para uma nova versão

Para atualizar o agente do Backint para uma nova versão, siga estas instruções:

  1. Ative as solicitações HTTP remotas do host do SAP HANA para https://www.googleapis.com/.

  2. Como sidadm no host do SAP HANA, instale a nova versão:

    curl https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh | bash

O script update.sh executa as seguintes ações:

  • Instala a nova versão do agente do Backint em /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
  • Atualiza o script backint para invocar a nova versão do agente do Backint.
  • Atualiza o número da versão em VERSION.txt.
  • Armazena o script update.sh localmente em /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
  • Emite uma mensagem quando é concluído.

O processo de atualização não modifica nem substitui seu arquivo parameters.txt existente. Para usar qualquer nova opção introduzida na versão mais recente, você precisa adicionar os parâmetros correspondentes ao seu arquivo parameters.txt existente.

O processo de atualização deixa a versão antiga do agente do Backint no diretório /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs, para que seja possível retornar à versão antiga, se necessário.

Como reverter para uma versão anterior

Se você encontrar problemas com uma nova versão do agente do Backint e do Google Cloud ou do SAP oferecer suporte para voltar à sua versão anterior, edite o arquivo de script backint para fazer isso.

Não é necessário remover nenhum parâmetro adicionado à nova versão no arquivo parameters.txt. A versão anterior do agente do Backint ignora os parâmetros da versão mais recente.

Para substituir uma versão anterior:

  1. Como sidadm, abra o script backint para edição. Exemplo:

    vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint
  2. Altere o nome do arquivo JAR do agente do Backint para o nome do arquivo JAR da versão anterior.

    Por exemplo, se você estiver voltando da versão 1.0.6 para a versão 1.0.4, altere:

    -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar
    to:

    -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

  3. Abra o arquivo VERSION.txt para edição e especifique o número da versão anterior. É necessário fazer isso para que o mecanismo de atualização saiba qual versão você está executando.

    vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt
  4. Teste o agente do Backint acionando um backup.

Solução de problemas

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 de um erro. 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 registros no Console do 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 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 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 no host do SAP HANA usando a ferramenta gsutil do Cloud Storage incluída no SDK do Cloud. 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.

Como receber suporte para o agente do Backint

Se você precisar de ajuda para resolver um problema com backups do SAP HANA que usam o agente do Backint, crie um incidente no sistema de processamento de incidentes da SAP usando o componente HAN-DB-BAC, conforme indicado pela Nota 2705632 da SAP.

Se a SAP determinar que a causa raiz está no software do Google Cloud, o suporte de desenvolvimento da SAP transfere o incidente para o componente BC-OP-LNX-GOOGLE, que o Google Cloud monitora o tempo todo.

Além das informações de diagnóstico solicitadas nao Nota 2705632 da SAP, colete as seguintes informações de diagnóstico adicionais:

  • Extratos relevantes de /var/log/messages no sistema HANA afetado durante o momento do problema.
  • Os arquivos backup.log e backint.log do SAP HANA. A menos que o problema também ocorra com o banco de dados SYSTEM, você precisa dos arquivos apenas para o banco de dados de locatário.
  • O arquivo parameters.txt do agente do Backint e os arquivos de registro no diretório backint-gcs ou uma exportação de registros do Cloud Logging, se você tiver ativado o Logging.
  • Entradas global.ini para backup:
    • backint_response_timeout
    • data_backup_buffer_size
    • parallel_data_backup_backint_channels
  • As versões de software do SAP HANA, do sistema operacional e do agente do Backint que você está usando. A versão do agente do Backint está listada no arquivo installation.log.
  • O tamanho do seu backup.
  • Informações sobre a conta de serviço do IAM que o agente do Backint usa para acessar o Cloud Storage, incluindo o nome da conta e os papéis que foram concedidos.
  • Informações sobre as tentativas anteriores de backup ou restauração dessa VM do host.
  • Uma descrição da paisagem do SAP HANA, incluindo os hosts e os papéis deles.

Para mais informações da SAP, sobre como receber suporte para o SAP HANA, consulte a seção “Conseguir suporte”, no Guia de administração do SAP HANA.