Guia de instalação do agente do Backint do Cloud Storage 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.

Nestas instruções, mostramos como instalar e configurar o agente Backint do Cloud Storage para SAP HANA (agente 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.

Se a VM do host não tiver acesso à Internet, será necessário configurar o Acesso privado do Google para que o agente do Backint possa acessar as APIs do Google Cloud. Consulte Como configurar o Acesso privado do Google para mais informações sobre esse processo.

Observação: se você precisar instalar o agente do Backint em um host que não seja uma máquina virtual (VM, na sigla em inglês) do Compute Engine ou uma máquina da solução Bare Metal, crie um incidente com o suporte do SAP no componente BC-OP-LNX-GOOGLE para que a SAP e o Google Cloud possam avaliar a configuração.

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 Google 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 Google Cloud.

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

   Observação: as opções de criptografia apresentadas no console do Google Cloud durante a criação do bucket geralmente se aplicam a objetos em repouso nele. O agente do Backint fornece outras opções de criptografia para seus backups que são independentes das opções de criptografia do 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 principais acessem o 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 - SID_LCadm
   

3. Faça o download e instale o agente do Backint.

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Observação: se você estiver atualizando uma instância atual do agente do Backint para uma nova versão, siga as instruções em Como atualizar o agente do Backint para uma nova versão.

   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 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. No console do Google Cloud, acesse a página Contas de serviço.

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

   2. Selecione seu projeto do Google Cloud.

   3. Clique em Criar conta de serviço.

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

   5. Clique em Criar e continuar.

   6. Clique em Continuar para criar a conta de serviço sem permissões.

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

   8. Clique em Concluído.

   9. Na página Contas de serviço no console do Google Cloud, clique no endereço de e-mail da conta de serviço que você acabou de criar.

   10. No nome da conta de serviço, clique na guia Chaves.

   11. Clique no menu suspenso Adicionar chave e selecione Criar nova chave para criar uma chave de conta de serviço.

   12. Aceite JSON como o 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 SID_LCadm possa acessar, como /usr/sap/SID/home
   • Verifique se o usuário SID_LCadm 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 participantes.

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

      [e-mail]

   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. O # no exemplo faz parte da sintaxe e não significa que a linha seja um comentário.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. Opcional: configure o agente do Backint para ignorar ou usar um proxy para backups e recuperações. Por padrão, o agente do Backint ignora proxies HTTP.

   Aviso: o roteamento de backups por meio de um proxy afeta negativamente o desempenho e a confiabilidade de todo o tráfego de proxy durante o envio ou a recuperação de backups do Cloud Storage. O Google Cloud recomenda que o agente do Backint ignore proxies HTTP.

   As consultas ao servidor de metadados da instância sempre precisam ignorar o servidor proxy HTTP. Use os parâmetros de proxy http ou https conforme exigido pelo seu servidor proxy.

   Para especificar as configurações do servidor proxy para o agente do Backint, edite o arquivo /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

   Por exemplo, a configuração a seguir especifica um servidor proxy HTTPS:

   http.proxyHost=proxy-host
   http.proxyPort=proxy-port
   http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
   https.proxyHost=proxy-host
   https.proxyPort=proxy-port
   

   Para mais informações sobre como usar o agente do Backint com um proxy, consulte Proxies e o agente do Backint.

3. 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:

      

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

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

6. 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 a Google Cloud CLI 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

Antes de atualizar o agente do Backint para uma nova versão no ambiente de produção, teste a nova versão em um ambiente de não produção. Para ver mais informações sobre o que uma versão do agente do Backint oferece, consulte as notas de lançamento para essa versão.

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

1. Verifique se nenhum backup de dados está em andamento ou programado para o período sobreposto à atualização.

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

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

4. Como SID_LCadm no host do SAP HANA, instale a nova versão:

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   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 anterior 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 anterior, se necessário.

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

6. Monitore o sistema para garantir que os backups foram feitos corretamente.

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 é preciso remover parâmetros que você possa ter 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 SID_LCadm, 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

Para resolver problemas com o agente Backint para SAP HANA, consulte Solução de problemas do agente Backint para SAP HANA.

Como receber suporte para o agente do Backint

Se você precisar de ajuda para resolver um problema com o agente do Backint para SAP HANA, reúna as informações de diagnóstico necessárias e entre em contato com o Cloud Customer Care. Para mais informações, consulte o Agente do Backint para informações de diagnóstico do SAP HANA.