Esta página foi traduzida pela API Cloud Translation.

Configurar backup e recuperação baseados no Backint para SAP HANA

Neste guia, mostramos como configurar o agente do Google Cloud para SAP para realizar backup e recuperação baseados no Backint para SAP HANA.

Para informações conceituais sobre esse recurso, que podem ajudar no planejamento da implementação, consulte Backup e recuperação para SAP HANA usando o Backint.

Para informações sobre como criar backups baseados em Backint e recuperar o SAP HANA usando esses backups, consulte Fazer backup e recuperar o SAP HANA usando o Backint.

Antes de começar

Valide sua instalação da versão 3.6 (mais recente) do agente do Google Cloud para SAP. Para instruções, consulte o guia de instalação para seu cenário.
Ao instalar o agente em um servidor da Solução Bare Metal, verifique se você concluiu os pré-requisitos e configurou uma conta de serviço. Para instruções, consulte Configurar o agente do Google Cloud para SAP no Linux.
Se o banco de dados do SAP HANA estiver em execução em um ambiente local, configure uma conta de serviço e a chave dela. Para informações sobre como fazer isso, consulte Configurar o agente do Google Cloud para SAP no Linux.
Se você precisar ativar esse recurso para uma instância do agente do Google Cloud para SAP em execução em um host que não seja uma instância do Compute Engine ou um servidor 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 sua configuração.
Instale o SAP HANA:
- Para informações sobre como automatizar a instalação do SAP HANA no Google Cloud usando o Terraform, consulte o guia de implantação para seu cenário.
- Para informações sobre como instalar o SAP HANA na solução Bare Metal, consulte guia de planejamento do SAP HANA na solução Bare Metal.

Criar um bucket do Cloud Storage

Antes de ativar o recurso Backint do agente do Google Cloud para SAP, verifique se existe um bucket do Cloud Storage para armazenar os backups. Se você tiver um bucket do Cloud Storage, pule esta seção.

Para informações sobre como armazenar backups em buckets do Cloud Storage, consulte Como armazenar backups em buckets do Cloud Storage.

Para criar um bucket do Cloud Storage:

Console do Google Cloud

In the Google Cloud console, go to the Cloud Storage Buckets page.
Go to Buckets page
Click Create bucket.
On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
- For Name your bucket, enter a name that meets the bucket naming requirements.
- For Choose where to store your data, do the following:
  - Select a Location type option.
  - Select a Location option.
- For Choose a default storage class for your data, select a storage class.
- For Choose how to control access to objects, select an Access control option.
- For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
Click Create.

Linha de comando

Substitua STORAGE_CLASS pela classe de armazenamento de sua preferência.
Substitua LOCATION pelo local de sua preferência (ASIA, EU, ou US)
Substitua BUCKET_NAME por um nome de bucket exclusivo um nome de bucket que atenda aos requisitos de nome de bucket.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Defina papéis do IAM

Para permitir que o agente do Google Cloud para SAP realize operações de backup e recuperação para o SAP HANA, verifique se a conta de serviço usada pela instância do Compute Engine ou pelo servidor da Solução Bare Metal inclui o papel do IAM Administrador de objetos do Storage (storage.objectAdmin).

Para adicionar esse papel à sua conta de serviço, siga estas etapas:

No console do Google Cloud, abra a página IAM.

Acessar IAM
Selecione seu projeto do Google Cloud.
Identifique a conta de serviço a que você quer adicionar o papel.
- Se a conta de serviço ainda não estiver na lista de principais, ela não terá nenhum papel atribuído a ela. Clique em Adicionar e digite o endereço de e-mail da conta do serviço.
- Se a conta de serviço estiver na lista de principais, a conta de serviço já terá papéis. Clique no botão Editar da conta de serviço que você quer editar.
Na lista de papéis disponíveis, selecione Administrador de objetos do Storage.
Clique em Adicionar ou Salvar para aplicar os papéis à conta de serviço.

Para um nível granular de acesso, é possível definir as seguintes permissões do IAM para o papel personalizado da conta de serviço no nível do projeto:

storage.objects.list
storage.objects.create

Você também precisa definir políticas do IAM no seu bucket concedendo ao principal as seguintes permissões do IAM:

storage.objects.get
storage.objects.update
storage.objects.delete

Adicione as seguintes permissões se quiser fazer uploads de várias partes:

storage.multipartUploads.create
storage.multipartUploads.abort

Para mais informações sobre como criar um papel personalizado, consulte Criar e gerenciar papéis personalizados. Para mais informações sobre como conceder a um principal uma função personalizada para acesso no nível do bucket, consulte Adicionar um principal a uma política no nível do bucket.

Ativar acesso a APIs do Cloud e servidores de metadados

O agente do Google Cloud para SAP requer acesso a endereços IP e hosts do Google Cloud durante as operações de backup e recuperação:

Para acessar o Cloud Storage, storage.googleapis.com.
Para o servidor de metadados da instância do Compute Engine:
- oauth2.googleapis.com, para autenticação
- 169.254.169.254
- metadata.google.internal

Se o agente do Google Cloud para SAP e o sistema SAP HANA estiverem em execução em uma instância do Compute Engine que não tenha acesso à Internet, você precisará configurar o Acesso privado do Google para que o agente possa interagir com o Cloud Storage e, se usar uma conta de serviço dedicada, autenticar-se com o Google Cloud. Para ver instruções, consulte Como configurar o Acesso privado do Google.

Ativar o recurso Backint

Para ativar o recurso Backint do agente do Google Cloud para SAP, conclua as seguintes etapas:

Conecte-se ao host do SAP HANA usando SSH.

Se o host for uma instância do Compute Engine, na página Instâncias de VM do console do Google Cloud, clique no botão SSH da instância ou use o método SSH de sua preferência.
Mude para administrador do sistema do SAP HANA:
```
sudo su - SID_LCadm
```
Substitua SID_LC pelo SID. Todas as letras devem ser minúsculas.

Esse comando também define diferentes variáveis de ambiente, incluindo $SAPSYSTEMNAME, que é definida com o SID do banco de dados SAP HANA.
Ative o recurso Backint do agente do Google Cloud para SAP:
```
/usr/bin/google_cloud_sap_agent installbackint
```
Como alternativa, para instalar os arquivos relacionados ao Backint em um host com um SID diferente, inclua a sinalização sid:
```
/usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC
```
Substitua DIFFERENT_SID_LC pelo SID da instância exigida pelo SAP HANA. Todas as letras devem ser minúsculas.

Depois que o comando for executado com êxito, todos os arquivos relacionados ao recurso Backint do agente do Google Cloud para SAP serão instalados no diretório /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Isso inclui os arquivos necessários para integrar o agente com o SAP HANA. Ele também detecta o agente Backint do Cloud Storage para SAP HANA no host, desativa esse agente e copia os arquivos para um diretório recuperável no host. Para mais informações, consulte Fazer upgrade a partir do agente do Backint.
Configurar o recurso do Backint:
Executar comando
- Se o banco de dados do SAP HANA estiver em execução em uma instância do Compute Engine ou em um servidor da Solução Bare Metal, execute o comando configurebackint para configurar o recurso Backint do agente. Recomendamos essa abordagem em vez da edição do arquivo de configuração do Backint do agente.
  /usr/bin/google_cloud_sap_agent configurebackint \ -f="PATH_TO_PARAMETERS_FILE" \ -bucket="BUCKET_NAME"
- Se o banco de dados SAP HANA estiver em execução em um ambiente local, configure o recurso Backint do agente executando o seguinte comando:
  /usr/bin/google_cloud_sap_agent configurebackint \ -f="PATH_TO_PARAMETERS_FILE" \ -bucket="BUCKET_NAME" \ -service_account_key="PATH_TO_KEY" \ -log_to_cloud=false \ -send_metrics_to_monitoring=false
  Substitua:
  - PATH_TO_PARAMETERS_FILE: o caminho para o arquivo de configuração PARAMETERS.json do Backint.
  - BUCKET_NAME: o nome do bucket do Cloud Storage em que você quer armazenar os backups do SAP HANA.
  - PATH_TO_KEY: o caminho totalmente qualificado para a chave da conta de serviço do Google Cloud codificada em JSON que você configurou
Se quiser, defina mais parâmetros ao executar esse comando. Para informações sobre esses parâmetros, consulte Parâmetros de configuração.
Editar arquivo de configuração
Como alternativa à execução do comando configurebackint do agente, edite o arquivo de configuração do Backint da seguinte maneira:
1. Abra o arquivo de configuração do Backint:
  /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
  Substitua SID pelo SID do sistema SAP em que você instalou os arquivos relacionados ao Backint.
  
  Este é um exemplo do conteúdo do arquivo de configuração:
  { "bucket": "", "log_to_cloud": true }
2. Para permitir que o agente do Google Cloud para SAP realize operações de backup e recuperação baseadas em Backint para seu sistema SAP HANA, edite o arquivo de configuração e especifique os seguintes parâmetros:
  - bucket: especifique o nome do bucket do Cloud Storage em que você quer armazenar os backups do SAP HANA.
  - service_account_key: se você tiver criado uma conta de serviço para o agente do Google Cloud para SAP, especifique o caminho absoluto para o diretório no host em que fez upload da chave da conta de serviço correspondente codificada em JSON
  Para mais informações, consulte Considerações sobre a conta de serviço.
3. Se o banco de dados do SAP HANA estiver em execução em um ambiente local, configure também o seguinte:
  - "log_to_cloud": false
  - "send_metrics_to_monitoring": false
4. Se quiser, modifique outros parâmetros de configuração. Para informações sobre esses parâmetros, consulte Parâmetros de configuração.
5. Salve o arquivo de configuração.

Personalizar o arquivo de configuração do Backint

Opcionalmente, depois de ativar o recurso Backint do agente do Google Cloud para SAP, é possível realizar as seguintes customizações:

Renomeie o arquivo parameters.json.

Para indicar essa renomeação, esse arquivo é conhecido como PARAMETERS.json na documentação do agente para SAP do Google Cloud.
Crie um arquivo de configuração separado para cada um dos seguintes itens: volume de dados do SAP HANA, volume de registros do SAP HANA e catálogo de backup do SAP HANA.

Defina um nome exclusivo para cada arquivo de configuração.
Mova esses arquivos de configuração para outro diretório. Por exemplo, em uma implantação de escalonamento horizontal, é possível armazenar os arquivos de configuração relacionados ao Backint de todos os nós em um diretório compartilhado acessível a eles. Isso pode facilitar o gerenciamento deles.

Se você realizar alguma dessas customizações, especifique corretamente o nome do arquivo e o caminho dele para os parâmetros, no arquivo global.ini do SAP HANA. Para instruções, consulte Configurar o SAP HANA para o recurso Backint.

Configurar o SAP HANA para o recurso Backint

Depois de ativar o recurso Backint do agente do Google Cloud para SAP, é necessário configurar o sistema SAP HANA para utilizá-lo:

Use o SAP HANA Studio ou o SAP HANA Cockpit para editar o arquivo de configuração global.ini.

Na seção backup do arquivo global.ini, especifique valores para os seguintes parâmetros:

Parâmetro	Valor
`data_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json`.
`parallel_data_backup_backint_channels`	Para backups de dados de multistreaming, especifique o número de canais considerando o tipo de bucket do Cloud Storage usado, o desempenho necessário e a capacidade de processamento do disco.
`log_backup_using_backint`	Se você estiver usando um arquivo de configuração separado para o volume de registros de backup do SAP HANA, especifique o valor `true`.
`log_backup_parameter_file`	Se você estiver usando um arquivo de configuração separado para o volume de registros de backup do SAP HANA, especifique o seguinte valor: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json`. Substitua `PARAMETERS_LOG` pelo nome do arquivo de configuração que você está usando para os backups do volume de registros do SAP HANA.
`catalog_backup_using_backint`	Se você estiver usando um arquivo de configuração separado para o catálogo de backup do SAP HANA, especifique o valor `true`.
`catalog_backup_parameter_file`	Se você estiver usando um arquivo de configuração separado para o catálogo de backup do SAP HANA, especifique o seguinte valor: `/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json`. Substitua `PARAMETERS_CATALOG` pelo nome do arquivo de configuração que você está usando para os backups do catálogo de backups do SAP HANA.

Veja a seguir o exemplo de um arquivo global.ini configurado para usar o recurso Backint do agente do Google Cloud para SAP:

[backup]
log_backup_using_backint = true
catalog_backup_using_backint = true
parallel_data_backup_backint_channels = 16
catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

Na seção persistence do arquivo global.ini, especifique valores para os seguintes parâmetros:
- basepath_logbackup: especifique o diretório no sistema de arquivos em que o SAP HANA poderá armazenar backups de registros quando não conseguir se conectar ao bucket do Cloud Storage. Verifique se o diretório tem espaço suficiente para armazenar backups.
- basepath_catalogbackup: especifique o diretório no sistema de arquivos em que o SAP HANA poderá armazenar backups do catálogo de backup do SAP HANA quando não conseguir se conectar ao bucket do Cloud Storage. Verifique se esse diretório tem espaço suficiente para armazenar backups.

Validar backup e recuperação

Depois de ativar o recurso Backint do agente do Google Cloud para SAP, valide-o criando e restaurando um backup em um sistema de teste.

Para testes, use a ferramenta integrada de autodiagnóstico do agente. Você precisa de pelo menos 18 GB de espaço disponível em disco no sistema de arquivos para executar essa ferramenta integrada. Para usar essa ferramenta integrada para validar o backup e recuperação, execute o seguinte comando:

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

Substitua:

IDENTIFIER: um valor que identifica a execução do comando. Esse identificador é usado para nomear a pasta temporária criada no bucket do Cloud Storage durante a execução do diagnóstico.
PATH_TO_PARAMETERS_FILE: o caminho para o arquivo PARAMETERS.json

Ao usar essa ferramenta, você pode usar os parâmetros opcionais diagnose_file_max_size_gb e diagnose_tmp_directory. Para mais informações sobre esses parâmetros, consulte as descrições em Parâmetros de configuração.

Se você tiver instalado o agente do Backint no host, na primeira vez que usar o agente do Google Cloud para SAP para executar uma operação de backup, o agente do Google Cloud para SAP criará versões JSON dos arquivos de configuração de texto. Para mais informações, consulte Fazer upgrade a partir do agente do Backint.

Exemplo: arquivo de configuração

Veja a seguir um arquivo de configuração PARAMETERS.json completo do recurso Backint do agente do Google Cloud para SAP:

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

Parâmetros de configuração

Na tabela a seguir, explicamos os parâmetros de configuração do agente do Google Cloud para SAP que são específicos do recurso do Backint.

Para informações sobre o mapeamento entre os parâmetros de configuração do agente do Backint e o agente do Google Cloud para SAP, consulte Mapeamento de parâmetros de configuração.

Para informações sobre os parâmetros de configuração do agente do Google Cloud para SAP, incluindo os parâmetros relacionados à coleta de métricas, consulte o guia de instalação do seu cenário.

Parâmetros
`bucket`	`String` Especifique o nome do bucket do Cloud Storage de onde o agente do Google Cloud para SAP irá gravar e ler. O agente cria objetos de backup com a classe de armazenamento do bucket e é compatível com todas as classes de armazenamento. O agente usa a criptografia padrão do Compute Engine para criptografar dados em repouso.
`recovery_bucket`	`String` Opcional. Especifique o nome do bucket do Cloud Storage que o agente lê durante as operações `RESTORE`. Se você não especificar esse parâmetro, o agente usará o bucket especificado no parâmetro `bucket` em todas as operações: `BACKUP`, `RESTORE`, `INQUIRE`, `DELETE` e `DIAGNOSE`. Embora o uso desse parâmetro seja recomendado para simplificar o gerenciamento de configurações de operações de cópia e atualização do sistema, é incompatível com o argumento `CHECK ACCESS USING BACKINT` durante operações de restauração do SAP HANA.
`log_to_cloud`	`Boolean` Opcional. Para redirecionar os registros relacionados ao Backint do agente do Google Cloud para SAP, para o Cloud Logging, especifique `true`. O valor padrão é `true`. Se o banco de dados SAP HANA estiver em execução em um ambiente local, defina o valor desse parâmetro como `false`. Para ver informações sobre o arquivo de registros relacionado ao Backint, consulte Logging.
`log_level`	`String` Opcional. Especifique o nível de geração de registros para o recurso Backint do agente do Google Cloud para SAP e defina o valor obrigatório. Os níveis de registro disponíveis são os seguintes: `DEBUG` `INFO` `WARNING` `ERROR` O valor padrão é `INFO`. Não altere o nível de geração de registros, a menos que isso seja orientado pelo Cloud Customer Care.
`compress`	`Boolean` Opcional. Especifique se o agente do Google Cloud para SAP deve ou não ativar a compactação ao gravar backups no bucket do Cloud Storage. O valor padrão é `false`. Recomendamos que você não ative a compactação. Embora a compactação reduza o custo de armazenamento dos backups no Cloud Storage, ela exige mais processamento da CPU durante as operações de backup e diminui a capacidade de processamento de backup efetiva. Seja qual for esse parâmetro, o agente do Google Cloud para SAP é compatível com arquivos de backup compactados e descompactados, durante uma operação de restauração.
`encryption_key`	`String` Opcional. Especifique o caminho para a chave de criptografia fornecida pelo cliente que você configurou para usar no bucket do Cloud Storage e criptografar backups. Especifique um caminho totalmente qualificado para uma chave AES-256 codificada em base64. Não é possível especificar o parâmetro `encryption_key` com os `kms_key` ou `parallel_streams`.
`kms_key`	`String` Opcional. Especifique o caminho para a chave de criptografia gerenciada pelo cliente que você configurou para utilização no bucket do Cloud Storage para criptografar backups. Especifique o caminho usando o formato `projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME`, em que: `KMS_PROJECT_ID`: o ID do projeto do Google Cloud em que a chave KMS está localizada `LOCATION`: o local do Cloud KMS em que a chave KMS está localizada. `KEY_RING_NAME`: o nome do keyring que contém a chave do KMS `KMS_KEY_NAME`: o nome da chave do KMS Se o sistema SAP HANA estiver em execução em uma instância do Compute Engine, a chave precisará estar acessível para essa instância. Se o sistema SAP HANA estiver sendo executado em um host que não seja uma instância do Compute Engine, a chave do Cloud KMS precisará estar acessível à conta de serviço usada pelo agente do Google Cloud para SAP. Para mais informações, consulte Contas de serviço. Não é possível especificar o parâmetro `kms_key` com os `encryption_key` ou `parallel_streams`.
`folder_prefix`	`String` Opcional. Especifique para definir um prefixo para as pastas no bucket do Cloud Storage em que o agente do Google Cloud para SAP grava e lê. É possível usar esse parâmetro para organizar backups de diferentes instâncias do SAP HANA no mesmo bucket do Cloud Storage. É possível especificar uma única pasta, como `folder1`, ou um caminho de vários níveis de pastas, como `folder1/folder2/folder3`. Esse prefixo é inserido como uma pasta entre os valores `BUCKET_NAME` e `SID` no caminho para os backups do SAP HANA no Cloud Storage. Para mais informações, consulte Personalizações compatíveis. Esse parâmetro está disponível a partir da versão 3.1 do agente. Aviso:alterar o valor desse parâmetro muda o caminho para os arquivos de backup, o que pode causar falhas durante as operações de recuperação do banco de dados. Portanto, antes de alterar o valor desse parâmetro, teste o backup e a recuperação com o novo valor de parâmetro em um ambiente que não seja de produção.
`recovery_folder_prefix`	`String` Opcional. Especifique para definir um prefixo para as pastas no bucket do Cloud Storage que o agente lê durante operações `RESTORE`. É possível usar esse parâmetro para organizar backups de diferentes instâncias do SAP HANA no mesmo bucket do Cloud Storage. É possível especificar uma única pasta, como `folder1`, ou um caminho de vários níveis para pastas, como `folder1/folder2/folder3`. Para ver mais informações, consulte Personalizações compatíveis. Esse parâmetro está disponível a partir da versão 3.1 do agente. Embora o uso desse parâmetro seja recomendado para simplificar o gerenciamento de configurações de operações de cópia e atualização do sistema, é incompatível com o argumento `CHECK ACCESS USING BACKINT` durante operações de restauração do SAP HANA. Aviso:alterar o valor desse parâmetro muda o caminho para os arquivos de backup, o que pode causar falhas durante as operações de recuperação do banco de dados. Portanto, antes de alterar o valor desse parâmetro, teste o backup e a recuperação com o novo valor de parâmetro em um ambiente que não seja de produção.
`shorten_folder_path`	`Boolean` Opcional. Especifique para encurtar o caminho do objeto no bucket do Cloud Storage que o agente lê e grava durante todas as operações do Backint. Para ver mais informações, consulte Personalizações compatíveis. Esse parâmetro está disponível a partir da versão 3.3 do agente. Aviso:alterar o valor desse parâmetro muda o caminho para os arquivos de backup, o que pode causar falhas durante as operações de recuperação do banco de dados. Portanto, antes de alterar o valor desse parâmetro, teste o backup e a recuperação com o novo valor de parâmetro em um ambiente que não seja de produção.
`retries`	`Int` Especifica o número máximo de vezes que o agente do Google Cloud para SAP repete uma tentativa com falha de ler ou gravar no Cloud Storage. O valor padrão é `5`, que também é o valor recomendado.
`parallel_streams`	`Int` Opcional. Especifique esse parâmetro para ativar o upload paralelo de backups no seu bucket do Cloud Storage. O valor especificado para esse parâmetro é o número máximo de streams de upload paralelos que o Agente para SAP do Google Cloud pode usar. O valor máximo é 32. Qualquer valor acima disso é limitado a 32. O valor padrão é `1`, que desativa o upload paralelo. Se você quiser ativar o upload paralelo para dados de streaming ou se o bucket do Cloud Storage tiver uma política de retenção, defina `xml_multipart_upload` também como `true`. Não ative o upload paralelo se uma das seguintes condições se aplicar: O bucket de destino do Cloud Storage usa uma política de retenção. Você especificou os parâmetros `encryption_key` ou `kms_key`. Se alguma das condições anteriores for atendida, o agente será encerrado e mostrará o status `1`. Para mais informações sobre uploads paralelos, consulte Uploads paralelos.
`xml_multipart_upload`	`Boolean` Opcional. Especifica se o método de upload de várias partes da API XML é usado ao gravar backups no bucket do Cloud Storage. O valor padrão é `false`. Esse parâmetro está disponível a partir da versão 3.2 do agente. Para usar o método de upload de várias partes da API XML, `parallel_streams` precisa ter um valor maior que `1`. Se você definir `xml_multipart_upload` como `true`, mas não especificar `parallel_streams`, o valor `parallel_streams` será atribuído automaticamente a `16`. Recomendamos o uso de `xml_multipart_upload` apenas para carregar backups de registro ou catálogo em paralelo. Para carregar backups de dados em paralelo, recomendamos definir `parallel_data_backup_backint_channels` na seção `backup` do arquivo `global.ini`. Para informações sobre como criar arquivos de parâmetros separados para backups de dados e registros ou como definir o valor para `parallel_data_backup_backint_channels`, consulte Configurar o SAP HANA para o recurso Backint. Em caso de falha, os uploads em várias partes do XML são cancelados automaticamente e os dados enviados são excluídos. Também recomendamos definir as condições do ciclo de vida para AbortIncompleteMultipartUpload a fim de garantir que os dados sejam excluídos em caso de falha na operação de upload.
`storage_class`	`String` Opcional. Especifique a classe de armazenamento usada ao gravar backups no bucket do Cloud Storage. Estas são as classes de armazenamento disponíveis: `STANDARD` `NEARLINE` `COLDLINE` `ARCHIVE` O valor padrão é `STANDARD`. Esse parâmetro está disponível a partir da versão 3.2 do agente.
`metadata`	`Map<String, String>` Opcional. Especifique os campos chave-valor a serem armazenados como metadados para objetos ao gravar backups no bucket do Cloud Storage. Esse parâmetro está disponível a partir da versão 3.3 do agente. O formato de um arquivo de configuração `PARAMETERS.json` de exemplo é o seguinte: { "bucket": "example-bucket-backup", "metadata": {"key1": "value1", "key2": "value2"}, "log_to_cloud": true } Os metadados padrão gravados são `{"X-Backup-Type": "PIPE"}` ou `{"X-Backup-Type": "FILE"}`, dependendo do tipo de arquivo. Aviso: a chave `X-Backup-Type` não pode ser substituída por metadados personalizados.
`custom_time`	`String` Opcional. Especifique a data e a hora que você quer definir para os metadados `Custom-Time` dos backups enviados para o Cloud Storage. Você deve especificar a data e a hora no formato especificado em `Custom-Time`. Esse parâmetro está disponível a partir da versão 3.4 do agente. É possível definir esse parâmetro com o valor `UTCNow`, que define os metadados `Custom-Time` com a data e a hora UTC quando o backup é criado. A partir da versão 3.6 do agente, é possível definir uma data futura para os metadados `Custom-Time` usando `UTCNow+NUMBERd`. Por exemplo, para definir o `Custom-Time` como 30 dias a partir da criação do backup, defina a configuração como no exemplo a seguir: { "bucket": "example-bucket-backup", "custom_time": "UTCNow+30d", "log_to_cloud": true } Confira a seguir um exemplo de como especificar esse parâmetro com um valor de data e hora no arquivo `PARAMETERS.json`: { "bucket": "example-bucket-backup", "custom_time": "2024-06-25T13:25:00Z", "log_to_cloud": true }
`rate_limit_mb`	`Int` Opcional. Especifique o limite máximo, em MB, para a largura de banda da rede de saída do Compute Engine durante as operações de backup ou restauração. Por padrão, o Google Cloud não limita a largura de banda da rede para o agente do Google Cloud para SAP. Quando você define esse parâmetro, a capacidade pode variar, mas não deve exceder o limite especificado.
`service_account_key`	`String` Se o agente do Google Cloud para SAP não estiver sendo executado em uma instância do Compute Engine, especifique o caminho totalmente qualificado para a conta de serviço do Google Cloud codificada em JSON. Se o agente do Google Cloud para SAP estiver em execução em uma instância do Compute Engine, recomendamos que você não especifique esse parâmetro e use a autenticação padrão do Compute Engine. A especificação desse parâmetro instrui o agente do Google Cloud para SAP a usar a chave da conta de serviço ao autenticar-se no Cloud Storage.
`diagnose_file_max_size_gb`	`Int` Opcional. Especifique o limite máximo de tamanho do arquivo temporário, em GB, que a ferramenta de autodiagnóstico do agente cria e exclui. O valor padrão é 16 GB. Esse parâmetro está disponível a partir da versão 3.3 do agente. Para que a ferramenta de autodiagnóstico funcione, verifique se o armazenamento disponível no seu sistema de arquivos é de 2 a 3 GB a mais do que o valor de `diagnose_file_max_size_gb`.
`diagnose_tmp_directory`	`String` Opcional. Especifique o diretório usado para ler e gravar arquivos temporários da ferramenta de autodiagnóstico do agente. O valor padrão é `/tmp/backint-diagnose`. Esse parâmetro está disponível a partir da versão 3.3 do agente.
`send_metrics_to_monitoring`	`Boolean` Opcional. Especifica se o agente pode ou não coletar métricas relacionadas ao status e à capacidade de arquivos dos quais é feito o upload ou download durante as operações do Backint. O agente envia as métricas coletadas para o Cloud Monitoring. Esse parâmetro está disponível a partir da versão 3.3 do agente. O valor padrão é `true`. Se o banco de dados SAP HANA estiver em execução em um ambiente local, defina o valor desse parâmetro como `false`. Para informações sobre as métricas relacionadas ao Backint, consulte Coleta de métricas do Backint.
`threads`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o número de linhas de execução de worker. O valor padrão é o número de processadores no host.
`file_read_timeout_ms`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o tempo máximo, em milissegundos, que o agente do Google Cloud para SAP aguardará até abrir o arquivo de backup. O valor padrão é de `60000` (60 segundos).
`buffer_size_mb`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique esse parâmetro para controlar o tamanho das solicitações HTTPS para o Cloud Storage durante operações de backup ou restauração. O tamanho padrão do bloco é 100 MB, o que significa que um fluxo de solicitação HTTP para ou do Cloud Storage é mantido aberto até que 100 MB de dados sejam transferidos. O tamanho máximo do buffer é de 250 MB. Como o agente do Google Cloud para SAP tenta repetir solicitações HTTP com falha várias vezes antes de indicar uma operação com erro, buffers menores que 100 MB resultam em menos dados do que precisam ser retransmitidos no caso de uma falha. Tamanhos maiores de buffer podem melhorar a capacidade, mas exigem mais uso de memória e mais tempo para o reenvio dos dados em caso de falha na solicitação. Se você estiver usando o parâmetro `parallel_streams`, o uso de memória necessário precisará ser multiplicado por esse valor, porque cada stream requer o próprio buffer para processar as solicitações HTTPS.
`retry_backoff_initial`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o valor inicial, em segundos, para o período de repetição usado nas tentativas de rede de espera exponencial. O valor padrão é `10`.
`retry_backoff_max`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o valor máximo, em segundos, para o período de repetição usado nas tentativas de rede de espera exponencial. O valor padrão é `300`.
`retry_backoff_multiplier`	`Float` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o multiplicador para o período de repetição usado nas novas tentativas de rede de espera exponencial. O multiplicador precisa ser maior que `1`, e o valor padrão é `2`.
`log_delay_sec`	`Int` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o atraso da geração de registros, em segundos, para atualizações de progresso durante leituras e gravações no bucket do Cloud Storage. O valor padrão é `60`.
`client_endpoint`	`String` É um parâmetro de ajuste avançado opcional. Não modifique esse parâmetro, a menos que seja instruído pelo Customer Care. O valor padrão raramente precisa ser modificado. Especifique o endpoint do cliente do Cloud Storage. O valor padrão é `storage.googleapis.com`.

Solução de problemas

Para resolver problemas com a versão 3.6 (mais recente) do agente do Google Cloud para SAP, consulte o Guia de solução de problemas do agente do Google Cloud para SAP.

Receber suporte

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

A seguir

Para saber como criar backups baseados em Backint e recuperar seu banco de dados SAP HANA usando-os, consulte Fazer backup e recuperar o SAP HANA usando o Backint.