Back up SAP HANA to OSS with Backint agent - Object Storage Service: Central de Documentação do Alibaba Cloud

Instale o agente

Crie o diretório de configuração.
```
mkdir -p /usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/
```
Substitua <SID> pelo ID do sistema SAP HANA, como HDB.

Baixe o script de instalação.

curl -O https://gosspublic.alicdn.com/oss-backint/v1/install.sh

Execute o script de instalação.
```
chmod +x install.sh
./install.sh <SID>
```
Saída esperada: <version> has successfully installed.
Verifique a instalação.
```
/usr/sap/HT1/SYS/global/hdb/opt/hdbbackint -v
```
Saída esperada: #SOFTWAREID "backint 1.06" "ALIBABACLOUD OSS 1.0.4"

Configure o agente

Edite o arquivo de configuração para definir o bucket do OSS, a região e as credenciais:

/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/oss-backint-agent.ini

Exemplo de configuração mínima:

[default]
bucket-name = my-hana-backup
region = cn-hangzhou
source-profile = ak-pair

[profile ak-pair]
access-key-id = LTAI5t****
access-key-secret = ****

Ative o backup via Backint

Faça login como <sid>adm e execute as instruções SQL a seguir para ativar o Backint:

-- Point the catalog, data, and log backup parameter files to the agent configuration file
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup', 'catalog_backup_parameter_file') = '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/oss-backint-agent.ini';
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup', 'catalog_backup_using_backint') = 'true';
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup', 'data_backup_parameter_file') = '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/oss-backint-agent.ini';
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup', 'log_backup_parameter_file') = '/usr/sap/<SID>/SYS/global/hdb/opt/hdbconfig/oss-backint-agent.ini';
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('backup', 'log_backup_using_backint') = 'true';

-- Enable continuous log recording for point-in-time recovery
ALTER SYSTEM ALTER CONFIGURATION ('global.ini', 'SYSTEM') SET ('persistence', 'log_mode') = 'normal';

Reinicie o banco de dados ou execute o comando abaixo como <sid>adm para aplicar as alterações:

hdbnsutil -reconfig

Verifique a configuração

Execute um backup de teste para validar a configuração:

BACKUP DATA USING BACKINT ('oss-backint-agent-test');

Se o backup for bem-sucedido, os dados aparecerão no bucket do OSS no caminho storage-prefix (padrão: SAP-HANA-Backint). Os procedimentos rotineiros de backup e recuperação estão descritos em Backup e recuperação do SAP HANA.

Métodos adicionais de credenciais

Cenário	Método de credencial	Descrição
SAP HANA em instância ECS	Função RAM do ECS (recomendado)	Dispensa o gerenciamento de AccessKey. O agente obtém credenciais temporárias dos metadados da instância.
Backup entre contas	ARN da função RAM	Usa tokens STS para acesso seguro entre contas.
Cluster ACK com RRSA ativado	OIDC	Utiliza tokens OIDC para isolamento de credenciais no nível do pod.
Sistema externo de gerenciamento de chaves	External Process	Obtém credenciais ao executar um comando personalizado.

Função RAM do ECS

Se o SAP HANA estiver em uma instância ECS, use uma função RAM do ECS para evitar o gerenciamento de pares de AccessKey. Certifique-se de que a instância tenha uma função RAM com permissões de acesso ao OSS.

source-profile = ecsramrole

[profile ecsramrole]
mode = EcsRamRole
# Optional. The role name is automatically retrieved if not specified.
# ecs-role-name = EcsRamRoleHana

ARN da função RAM

Para armazenar backups em um bucket do OSS de outra conta Alibaba Cloud, use o ARN da função RAM para autorização entre contas.

source-profile = ramrolearn

[profile ramrolearn]
mode = RamRoleArn
access-key-id = yourAccessKeyID
access-key-secret = yourAccessKeySecret
role-arn = acs:ram::113511544585****:role/testrole
role-session-name = session_name_example

OIDC

Se o SAP HANA estiver em um cluster Container Service for Kubernetes (ACK) com RRSA ativado, use a autenticação OIDC para isolar credenciais no nível do pod.

source-profile = oidcrolearn

[profile oidcrolearn]
mode = OidcRoleArn
oidc-provider-arn = acs:ram::113511544585****:oidc-provider/TestOidcProvider
oidc-token-file-path = OIDCTokenFilePath
role-arn = acs:ram::113511544585****:role/testoidc
role-session-name = TestOidcAssumedRoleSession

External Process

Se sua organização usar um sistema externo de gerenciamento de chaves, configure o agente para obter credenciais executando um comando personalizado. O comando deve retornar um objeto JSON em um dos formatos a seguir:

Credenciais de longo prazo:

{
  "AccessKeyId": "yourAccessKeyID",
  "AccessKeySecret": "yourAccessKeySecret"
}

Credenciais temporárias:

{
  "AccessKeyId": "yourAccessKeyID",
  "AccessKeySecret": "yourAccessKeySecret",
  "Expiration": "2023-12-29T07:45:02Z",
  "SecurityToken": "yourSecurityToken"
}

Exemplo de configuração:

source-profile = process

[profile process]
mode = Process
credential-process = /path/to/your/credential-script

Referência de configuração

O arquivo oss-backint-agent.ini aceita os parâmetros a seguir.

Parâmetro	Descrição
`bucket-name`	(Obrigatório) Nome do bucket do OSS.
`region`	(Obrigatório) Região do bucket, como `cn-hangzhou`.
`source-profile`	(Obrigatório) Nome do perfil de credenciais. Perfis compatíveis listados em Métodos adicionais de credenciais.
`hana-sid`	(Obrigatório) ID do sistema SAP HANA. O script de instalação define este valor automaticamente.
`endpoint`	Endpoint do OSS. O padrão é o endpoint público da `region` especificada. Para usar um endpoint interno, especifique-o explicitamente, como `https://oss-cn-hangzhou-internal.aliyuncs.com`.
`storage-prefix`	Prefixo do objeto no bucket. Padrão: `SAP-HANA-Backint`.
`object-acl`	ACL para objetos de backup. Valores válidos: `default`, `private`, `public-read` e `public-read-write`.
`object-tagging`	Tags para objetos de backup no formato chave-valor. Exemplo: `Project=SAP&Environment=Production`.
`object-storage-class`	Classe de armazenamento para objetos de backup. Valores válidos: `Standard`, `IA`, `Archive`, `ColdArchive` e `DeepColdArchive`. Classes de arquivamento e mais frias exigem restauração do objeto antes da recuperação.
`server-side-encryption`	Método de criptografia no lado do servidor. Valores válidos: `AES256`, `KMS` e `SM4`. O KMS exige `server-side-encryption-key-id`.
`server-side-data-encryption`	Algoritmo de criptografia de dados.
`server-side-encryption-key-id`	ID da chave mestra do cliente (CMK) do KMS.
`addressing-style`	Estilo de endereçamento do endpoint. Valores válidos: `virtual`, `path` e `cname`. Padrão: `virtual`.
`sign-version`	Versão do algoritmo de assinatura. Valores válidos: `v1` e `v4`. Padrão: `v4`.
`read-timeout`	Tempo limite de leitura em segundos. Padrão: `20`.
`connect-timeout`	Tempo limite de conexão em segundos. Padrão: `10`.
`retry-times`	Número máximo de tentativas após falha. Padrão: `10`.
`skip-verify-cert`	Ignora a verificação de certificado TLS. Padrão: `false`.
`proxy`	Endereço do servidor proxy.
`bind-address`	Endereço local para vincular conexões de saída.
`page-size`	Resultados por página nas operações de listagem. Padrão: `100`.
`job`	Jobs simultâneos entre arquivos. Padrão: `5`.
`big-file-threshold`	Limiar de tamanho de arquivo para upload multipart e download paralelo, em bytes. Padrão: `67108864` (64 MiB).
`pipe-parallel`	Threads simultâneas no modo pipe. Padrão: `3`.
`pipe-part-size`	Tamanho da parte no modo pipe, em bytes. Tamanho máximo de backup por pipe = este valor × 10.000. Padrão: `6291456` (6 MiB), com suporte a até ~60 GB. Aumente para bancos de dados maiores. Fórmula de pico de uso de memória: job × pipe-parallel × pipe-part-size. Por exemplo, com as configurações padrão: 5 × 3 × 6 MiB = 90 MiB.
`file-parallel`	Threads simultâneas no modo arquivo. Calculado automaticamente, máximo de 12. Não se aplica ao SAP HANA (modo pipe).
`file-part-size`	Tamanho da parte no modo arquivo, em bytes. Calculado automaticamente. Não se aplica ao SAP HANA (modo pipe).
`shorten-backup-destination-enabled`	Usa um caminho de backup do OSS encurtado. Padrão: `false`. Quando definido como `true`, o caminho de backup muda de: `oss://<bucket>/<storage-prefix>/<sid>/DB_<user_id>/usr/sap/<sid>/SYS/global/hdb/backint/` para: `oss://<bucket>/<storage-prefix>/<sid>/DB_<user_id>/`
`log-level`	Nível de log. Valores válidos: `off`, `info` e `debug`. Padrão: `off`.
`log-file`	Caminho do arquivo de saída de log. Defina como `-` para stdout.