Configurar a ferramenta Instantâneo Consistente do Aplicativo do Azure

Este artigo mostra como executar o azacsnap -c configure comando da ferramenta de Instantâneo Consistente de Aplicativo do Azure (AzAcSnap) que você pode usar com os Arquivos NetApp do Azure.

Comandos para o arquivo de configuração

Você pode criar ou editar o arquivo de configuração para AzAcSnap usando o azacsnap -c configure comando. O comando tem as seguintes opções:

--configuration new Para criar um novo arquivo de configuração
--configuration edit Para editar um arquivo de configuração existente
[--configfile <config filename>] (parâmetro opcional) para permitir nomes de arquivo de configuração personalizados

Por padrão, o nome do arquivo de configuração é azacsnap.json. Você pode usar um nome de arquivo personalizado com o --configfile= parâmetro (por exemplo, --configfile=<customname>.json).

O exemplo a seguir cria um arquivo de configuração para uma configuração de Instâncias Grandes do Azure:

azacsnap -c configure --configuration new

Exemplo de SAP HANA com armazenamento de arquivos NetApp do Azure

+----------------------------------------------------------+
+  For details on configuring AzAcSnap please visit        +
+          https://aka.ms/azacsnap-configure               +
+----------------------------------------------------------+
Building new config file

Q. Add comment #1 to config file (blank entry to exit adding comments)?
A. This is a new config file for AzAcSnap 11 with SAP HANA and Azure NetApp Files

Q. Add comment #2 to config file (blank entry to exit adding comments)?
A.

Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. hana

Checking for SAP HANA external program dependency 'hdbsql'
External dependency 'hdbsql' found.

=== Add SAP HANA details ===

Q. What is the SAP HANA SID (e.g. H80)?
A. H81

Q. What is the SAP HANA Instance Number (e.g. 00)?
A. 00

Q. What is the SAP HANA HDB User Store Key (e.g. `hdbuserstore List`)?
A. AZACSNAP

Q. What is the SAP HANA Server's Address (hostname or IP address)?
A. saphana1

Q. Do you need AzAcSnap to automatically disable/enable backint during snapshot?
   ('y' for yes, 'n' for no) [default='n']
A.

=== Add Hana Storage section ===

Q. Do you want to add Hana database Storage?
   ('y' for yes, 'n' for no)
A. y

--- DATA Volumes are specially prepared before they are snapshot ---

Q. Do you want to add Hana storage + DataVolume #1?
   ('y' for yes, 'n' for no)
A. y

Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #1?
   ('y' for yes, 'n' for no)
A. y

Q. What is the Hana storage + DataVolume #1 + Azure NetApp Files entry #1 + ResourceId?
  (e.g. /subscriptions/.../resourceGroups/.../providers/Microsoft.NetApp/netAppAccounts/.../capacityPools/Premium/volumes/...)?
A. /subscriptions/99999999-9zz9-9z99-z9z9-z999z999zzz9/resourceGroups/saphanasystems/providers/Microsoft.NetApp/netAppAccounts/saphanaanf/capacityPools/Premium/volumes/HANADATA01

Q. What is the Hana storage + DataVolume #1 + Azure NetApp Files entry #1 + Service Principal AuthenticationFile
   (e.g. auth-file.json or <blank> if using Azure Managed ID)?
A.
Hana storage + DataVolume #1 + Azure NetApp Files entry #1 (added)


Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #2?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Managed Disk entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #2?
   ('y' for yes, 'n' for no)
A. n

--- OTHER Volumes are snapshot immediately (no special preparation) ---

Q. Do you want to add Hana storage + OtherVolume #1?
   ('y' for yes, 'n' for no)
A. n


Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. save


Editing configuration complete, writing output to 'azacsnap.json'.

Exemplo de SAP HANA com armazenamento de instância grande do Azure

+----------------------------------------------------------+
+  For details on configuring AzAcSnap please visit        +
+          https://aka.ms/azacsnap-configure               +
+----------------------------------------------------------+
Building new config file

Q. Add comment #1 to config file (blank entry to exit adding comments)?
A. This is a new config file for AzAcSnap 11

Q. Add comment #2 to config file (blank entry to exit adding comments)?
A.

Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. hana

Checking for SAP HANA external program dependency 'hdbsql'
External dependency 'hdbsql' found.

=== Add SAP HANA details ===

Q. What is the SAP HANA SID (e.g. H80)?
A. H80

Q. What is the SAP HANA Instance Number (e.g. 00)?
A. 00

Q. What is the SAP HANA HDB User Store Key (e.g. `hdbuserstore List`)?
A. AZACSNAP

Q. What is the SAP HANA Server's Address (hostname or IP address)?
A. testing01

Q. Do you need AzAcSnap to automatically disable/enable backint during snapshot?
   ('y' for yes, 'n' for no) [default='n']
A.

=== Add Hana Storage section ===

Q. Do you want to add Hana database Storage?
   ('y' for yes, 'n' for no)
A. y

--- DATA Volumes are specially prepared before they are snapshot ---

Q. Do you want to add Hana storage + DataVolume #1?
   ('y' for yes, 'n' for no)
A. y

Q. Do you want to add Hana storage + DataVolume #1 + Azure NetApp Files entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #1?
   ('y' for yes, 'n' for no)
A. y

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Certificate File
   (e.g. svmadm_cert.p12)?
A. svm01.p12

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage ResourceId
   (e.g. <hostname>/api/storage/volumes/<UUID>)?
A. svm01/api/storage/volumes/0892dcdc-f760-11ee-a301-000c2989d71e

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Resource Name
   (e.g. volume01)?
A. hana_data_01

Q. What is the Hana storage + DataVolume #1 + Azure Large Instance entry #1 + Storage Resource Type
   (e.g. volumes or consistency-groups)?
A. volumes
Hana storage + DataVolume #1 + Azure Large Instance entry #1 (added)


Q. Do you want to add Hana storage + DataVolume #1 + Azure Large Instance entry #2?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #1 + Azure Managed Disk entry #1?
   ('y' for yes, 'n' for no)
A. n

Q. Do you want to add Hana storage + DataVolume #2?
   ('y' for yes, 'n' for no)
A. n

--- OTHER Volumes are snapshot immediately (no special preparation) ---

Q. Do you want to add Hana storage + OtherVolume #1?
   ('y' for yes, 'n' for no)
A. n


Q. Enter the database type to add, 'hana', 'oracle', 'db2', 'mssql',
   'exit' (to abort without saving), 'save' (to save and exit)?
A. save


Editing configuration complete, writing output to 'azacsnap.json'.

Valores necessários para o arquivo de configuração

As seções a seguir fornecem orientação detalhada sobre os valores necessários para a seção de banco de dados do arquivo de configuração.

Quando você adiciona um banco de dados SAP HANA à configuração, os seguintes valores são necessários:

HANA SID (Chave JSON: sid): O ID do sistema SAP HANA (SID).
HANA Instance Number (Chave JSON: instanceNumber): O número da instância do SAP HANA.
HANA HDB User Store Key (chave JSON: hdbUserStoreName): A SAP HANA KEY como mostrado pelo comando que usa a KEY para vincular o USUÁRIO com permissões para executar backups de banco de dados para o ENV (nome do hdbuserstore List host e porta). A seção Habilitar comunicação com banco de dados fornece mais detalhes e exemplos.
HANA Server's Address (Chave JSON: serverAddress): O nome do host ou endereço IP do servidor SAP HANA.
Do you need AzAcSnap to automatically disable/enable backint during snapshot: O padrão é n (não). Você pode defini-lo como y (yes) para permitir que o AzAcSnap desative ou reative a interface Backint. A seção de coexistência Backint neste artigo explica essa opção com mais detalhes.
O HANA Server's Address deve ser um dos seguintes:
- Nó único : Nome do host e endereço IP do nó.
- HSR com STONITH : Nome do host e endereço IP do nó.
- Scale-out (N+N, N+M): Nome do host atual e endereço IP do nó principal.
- HSR sem STONITH : Nome do host e endereço IP do nó.
- Multi SID em nó único : Nome do host e endereço IP do nó que hospeda esses SIDs.

Coexistência Backint

O serviço de Backup do Azure fornece uma ferramenta de backup alternativa para o SAP HANA. Você pode transmitir backups de banco de dados e de log no Backup do Azure.

Alguns clientes desejam combinar os backups baseados em backint de streaming com backups regulares baseados em instantâneo. No entanto, os backups baseados em Backint bloqueiam outros métodos de backup, como o uso de um backup baseado em arquivos ou um backup baseado em instantâneo de armazenamento (por exemplo, AzAcSnap). Para obter mais informações, consulte Executar backup de clientes nativos do SAP HANA em um banco de dados com o Backup do Azure.

O processo descrito na documentação do Backup do Azure foi implementado com o AzAcSnap para executar automaticamente as seguintes etapas:

Forçar uma liberação de backup de log para Backint.
Aguarde a conclusão dos backups em execução.
Desative o backup baseado em Backint.
Coloque o SAP HANA em um estado consistente para backup.
Faça um backup baseado em instantâneo de armazenamento.
Lançamento do SAP HANA.
Reative o backup baseado em Backint.

Por padrão, essa opção está desativada. Você pode ativá-lo azacsnap -c configure –configuration edit executando y e respondendo (sim) à perguntaDo you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n].

A edição da configuração conforme descrito define o autoDisableEnableBackint valor para true no arquivo de configuração JSON (por exemplo, azacsnap.json). Também é possível alterar esse valor editando o arquivo de configuração diretamente.

Quando você adiciona um banco de dados Oracle à configuração, os seguintes valores são necessários:

Oracle DB Server's Address (Chave JSON: serverAddress): O nome do host ou endereço IP do servidor de banco de dados.
SID (Chave JSON: sid): O ID do sistema de banco de dados.
Oracle Connect String (Chave JSON: connectString): A cadeia de caracteres que sqlplus usa para se conectar ao Oracle e habilitar ou desabilitar o modo de backup.

Quando você adiciona um banco de dados DB2 à configuração, os seguintes valores são necessários:

Db2 Server's Address (Chave JSON: serverAddress): O nome do host ou endereço IP do servidor de banco de dados.

Se Db2 Server Address (serverAddress) corresponder 127.0.0.1 ou localhost, a ferramenta de instantâneo executa todos os db2 comandos localmente. Caso contrário, a ferramenta de snapshot será usada serverAddress como host para se conectar via Secure Shell (SSH), usando o Instance User valor como o nome de login SSH.

Você pode validar o acesso remoto via SSH usando ssh <instanceUser>@<serverAddress>. Substitua <instanceUser> e <serverAddress> pelos respetivos valores.
Instance User (Chave JSON: instanceUser): O usuário da instância para o sistema de banco de dados.
SID (Chave JSON: sid): O ID do sistema de banco de dados.

Importante

A configuração Db2 Server Address (serverAddress) alinha-se diretamente com o método usado para se comunicar com o DB2. Certifique-se de configurá-lo corretamente, conforme descrito.

Ao adicionar um banco de dados do Microsoft SQL Server à configuração, os seguintes valores são necessários:

connectionString (Chave JSON: connectionString) = A cadeia de conexão usada para se conectar ao banco de dados. Para uma instalação típica do AzAcSnap no sistema que executa o Microsoft SQL Server onde a instância de banco de dados está MSSQL2022 a cadeia de conexão = "Trusted_Connection=True; Persist Security Info=True; Fonte de dados=MSSQL2022; TrustServerCertificate=true".
instanceName (Chave JSON: instanceName) = O nome da instância do banco de dados.
metaDataFileLocation (Chave JSON: metaDataFileLocation) = O local onde o Microsoft SQL Server gravará o arquivo de metadados de backup (por exemplo, "C:\MSSQL_BKP\").

Instâncias Grandes do Azure (bare metal)
Arquivos NetApp do Azure (com uma máquina virtual)

Quando você adiciona o armazenamento de Instâncias Grandes do Azure a uma seção de banco de dados, os seguintes valores são necessários:

Storage Certificate File (chave JSON: certificateFile): O arquivo de certificado usado para autenticar no back-end de armazenamento.
Storage ResourceId (chave JSON: resourceUri): O URI completo para o recurso, começando com o nome do host (por exemplo, <hostname>/api/storage/volumes/<UUID>)
Storage Resource Name (chave JSON: resourceName): O nome 'amigável' do recurso (por exemplo, vol01)
Storage Resource Type (Chave JSON: resourceType): O tipo de recurso, 'volumes' ou 'grupos de consistência'.

Quando você adiciona o armazenamento do Azure NetApp Files a uma seção de banco de dados, os seguintes valores são necessários:

Service Principal Authentication filename (Chave JSON: authFile):
- Para usar uma identidade gerenciada pelo sistema, deixe esse campo vazio sem valor e selecione a tecla Enter para ir para o próximo campo.
  
  Para obter um exemplo de configuração de uma identidade gerenciada pelo sistema do Azure, consulte Instalar a ferramenta Instantâneo Consistente do Aplicativo do Azure.
- Para usar uma entidade de serviço, use o nome do arquivo de autenticação (por exemplo, authfile.json) gerado no Azure Cloud Shell quando você estiver configurando a comunicação com o armazenamento do Azure NetApp Files.
  
  Para obter um exemplo de configuração de uma entidade de serviço, consulte Instalar a ferramenta Instantâneo Consistente do Aplicativo do Azure.
Full ANF Storage Volume Resource ID (Chave JSON: resourceId): O ID de recurso completo do volume que está sendo instantâneo. Você pode recuperar essa cadeia de caracteres acessando o portal do Azure e selecionando Configurações deVolume>dos> NetApp do Azure ouID do Recurso de Propriedades>.

Exemplo de ficheiro de configuração

A saída a seguir é apenas um arquivo de configuração de exemplo, este exemplo é o resultado do exemplo de armazenamento SAP HANA com Arquivos NetApp do Azure.

cat azacsnap.json

{
  "version": "11",
  "logPath": "./logs",
  "securityPath": "./security",
  "comments": [
    "This is a new config file for AzAcSnap 11 with SAP HANA and Azure NetApp Files"
  ],
  "database": [
    {
      "hana": {
        "serverAddress": "saphana1",
        "sid": "H81",
        "instanceNumber": "00",
        "hdbUserStoreName": "AZACSNAP",
        "savePointAbortWaitSeconds": 600,
        "autoDisableEnableBackint": false,
        "storage": [
          {
            "dataVolumes": [
              {
                "anfStorageVolumes": [
                  {
                    "resourceId": "/subscriptions/99999999-9zz9-9z99-z9z9-z999z999zzz9/resourceGroups/saphanasystems/providers/Microsoft.NetApp/netAppAccounts/saphanaanf/capacityPools/Premium/volumes/HANADATA01",
                    "authFile": "",
                    "subscription": "99999999-9zz9-9z99-z9z9-z999z999zzz9",
                    "resourceGroupName": "saphanasystems",
                    "accountName": "saphanaanf",
                    "poolName": "Premium",
                    "volume": "HANADATA01"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Nota

Para um cenário de recuperação de desastres (DR) em que você executará backups no site de DR, o nome do servidor HANA configurado no arquivo de configuração de DR (por exemplo, DR.json) no site de DR deve ser o mesmo que o nome do servidor de produção.

Próximos passos

Testar a ferramenta Instantâneo Consistente do Aplicativo do Azure

Feedback

Esta página foi útil?

Last updated on 2025-04-23