設定Azure 應用程式一致快照集工具

發行項
10/24/2023

本文說明如何執行 azacsnap -c configure 可與 Azure NetApp Files 搭配使用的Azure 應用程式一致快照集工具（AzAcSnap）命令。

組態檔的命令

您可以使用命令來建立或編輯 AzAcSnap azacsnap -c configure 的組態檔。此命令有下列選項：

--configuration new 建立新的組態檔
--configuration edit 編輯現有的組態檔
[--configfile <config filename>] （選擇性參數）允許自訂群組態檔名稱

根據預設，組態檔的名稱是 azacsnap.json 。您可以使用自訂檔案名搭配 --configfile= 參數（例如， --configfile=<customname>.json 。

下列範例會建立 Azure 大型實例組態的組態檔：

azacsnap -c configure --configuration new

Building new config file
Add comment to config file (blank entry to exit adding comments): This is a new config file for AzAcSnap 6
Add comment to config file (blank entry to exit adding comments):
Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): hana

=== Add SAP HANA Database details ===
HANA SID (e.g. H80): H80
HANA Instance Number (e.g. 00): 00
HANA HDB User Store Key (e.g. `hdbuserstore List`): AZACSNAP
HANA Server's Address (hostname or IP address): testing01
Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n]:

=== Azure NetApp Files Storage details ===
Are you using Azure NetApp Files for the database? (y/n) [n]:

=== Azure Managed Disk details ===
Are you using Azure Managed Disks for the database? (y/n) [n]:

=== Azure Large Instance (Bare Metal) Storage details ===
Are you using Azure Large Instance (Bare Metal) for the database? (y/n) [n]: y
--- DATA Volumes have the Application put into a consistent state before they are snapshot ---
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: y
Storage User Name (e.g. clbackup25): clt1h80backup
Storage IP Address (e.g. 192.168.1.30): 172.18.18.11
Storage Volume Name (e.g. hana_data_soldub41_t250_vol): hana_data_h80_testing01_mnt00001_t020_vol
Add Azure Large Instance (Bare Metal) resource to DATA Volume section of Database configuration? (y/n) [n]: n
--- OTHER Volumes are snapshot immediately without preparing any application for snapshot ---
Add Azure Large Instance (Bare Metal) resource to OTHER Volume section of Database configuration? (y/n) [n]: n

Enter the database type to add, 'hana', 'oracle', or 'exit' (for no database): exit


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

組態檔的必要值

下列各節提供組態檔資料庫區段所需值的詳細指引。

當您將 SAP HANA 資料庫 新增至組態時，需要下列值：

HANA Server's Address：SAP HANA 伺服器的主機名稱或 IP 位址。
HANA SID：SAP HANA 系統識別碼（SID）。
HANA Instance Number：SAP HANA 實例編號。
HANA HDB User Store Key：SAP HANA 使用者已設定執行資料庫備份的許可權。
Do you need AzAcSnap to automatically disable/enable backint during snapshot：預設為 n （否）。您可以將它設定為 y [是] 以允許 AzAcSnap 停用或重新啟用 Backint 介面。本文中的 Backint 共存區段會更詳細地說明此選項。
Single node：節點的主機名稱和 IP 位址。
HSR with STONITH：節點的主機名稱和 IP 位址。
Scale-out (N+N, N+M)：主要節點的目前主機名稱和 IP 位址。
HSR without STONITH：節點的主機名稱和 IP 位址。
Multi SID on Single node：裝載這些 SID 之節點的主機名稱和 IP 位址。

Backint 共存

Azure 備份服務提供 SAP HANA 的替代備份工具。您可以將資料庫和記錄備份串流至Azure 備份。

有些客戶想要結合串流 Backint 型備份與一般快照式備份。不過，Backint 型備份會封鎖其他備份方法，例如使用以檔案為基礎的備份或以儲存體快照集為基礎的備份（例如 AzAcSnap）。如需詳細資訊，請參閱使用 Azure 備份在資料庫上執行 SAP HANA 原生用戶端備份。

Azure 備份檔描述的程式已使用 AzAcSnap 實作，以自動執行下列步驟：

強制將記錄備份排清至 Backint。
等候執行中的備份完成。
停用 Backint 型備份。
將 SAP HANA 置於備份的一致狀態。
建立以儲存體快照集為基礎的備份。
發行 SAP HANA。
重新啟用 Backint 型備份。

預設會停用此選項。您可以執行 azacsnap -c configure –configuration edit 並回答 y 問題 Do you need AzAcSnap to automatically disable/enable backint during snapshot? (y/n) [n] 來啟用它。。

如所述編輯組態會將 JSON 組態檔中的值設定 autoDisableEnableBackint 為（例如 azacsnap.json true ）。您也可以直接編輯組態檔來變更此值。

當您將 Db2 資料庫新增至組態時，需要下列值：

Db2 Server's Address：資料庫伺服器的主機名稱或 IP 位址。

如果 Db2 Server Address （ serverAddress ）符合 127.0.0.1 或 localhost ，快照集工具會在本機執行所有 db2 命令。否則，快照集工具會使用 serverAddress 作為主機，透過安全殼層（SSH）連接到，方法是使用 Instance User 值作為 SSH 登入名稱。

您可以使用來驗證透過 SSH ssh <instanceUser>@<serverAddress> 的遠端存取。將和 <serverAddress> 取代 <instanceUser> 為個別的值。
Instance User：資料庫系統的實例使用者。
SID：資料庫系統識別碼。

重要

設定 Db2 Server Address （ serverAddress ）會直接與用來與 Db2 通訊的方法一致。請確定您已正確設定，如所述。

Azure 大型實例（裸機）
Azure NetApp Files （具有虛擬機器）

當您將 Azure 大型實例儲存體新增至資料庫區段時，需要下列值：

Storage User Name：用來建立儲存體 SSH 連線的使用者名稱。
Storage IP Address：儲存體系統的 IP 位址。

Storage Volume Name：要快照集的磁片區名稱。您可以透過多種方式來判斷此值。簡單的方法是使用下列殼層命令：

grep nfs /etc/fstab | cut -f2 -d"/" | sort | uniq

hana_data_p40_soldub41_mnt00001_t020_vol
hana_log_backups_p40_soldub41_t020_vol
hana_log_p40_soldub41_mnt00001_t020_vol
hana_shared_p40_soldub41_t020_vol

當您將 Azure NetApp Files 儲存體新增至資料庫區段時，需要下列值：

Service Principal Authentication filename （JSON 欄位： authFile ）：
- 若要使用系統管理的識別，請將此欄位保留空白且沒有值，然後選取 Enter 鍵以移至下一個欄位。
  
  如需設定 Azure 系統受控識別的範例，請參閱安裝Azure 應用程式一致快照集工具。
- 若要使用服務主體，請在設定與 Azure NetApp Files 儲存體的通訊時，使用在 Azure Cloud Shell 中產生的驗證檔案名稱（例如 authfile.json ）。
  
  如需設定服務主體的範例，請參閱安裝Azure 應用程式一致快照集工具。
Full ANF Storage Volume Resource ID （JSON 欄位：）： resourceId 要快照集之磁片區的完整資源識別碼。您可以移至Azure 入口網站，然後選取 [Azure NetApp Files > 磁片 > 區設定或屬性 > 資源識別碼 ，以擷取 此字串。

範例設定檔

在下列範例中， azacsnap.json 會設定為一個 SID。

您必須將參數值設定為特定的 SAP HANA 環境。針對 Azure 大型實例系統，Microsoft 服務管理會在呼叫上線和交接期間，以 Excel 檔案的形式提供這項資訊。如果您需要 Microsoft 服務管理再次傳送資訊，請開啟服務要求。

下列輸出只是範例組態檔。這是組態範例產生的檔案內容。請據以更新所有值。

cat azacsnap.json

{
  "version": "6",
  "logPath": "./logs",
  "securityPath": "./security",
  "comments": [
    "This is a new config file for AzAcSnap 6"
  ],
  "database": [
    {
      "hana": {
        "serverAddress": "testing01",
        "sid": "H80",
        "instanceNumber": "00",
        "hdbUserStoreName": "AZACSNAP",
        "savePointAbortWaitSeconds": 600,
        "autoDisableEnableBackint": false,
        "hliStorage": [
          {
            "dataVolume": [
              {
                "backupName": "clt1h80backup",
                "ipAddress": "172.18.18.11",
                "volume": "hana_data_h80_testing01_mnt00001_t020_vol"
              }
            ],
            "otherVolume": []
          }
        ],
        "anfStorage": [],
        "amdStorage": []
      },
      "oracle": null
    }
  ]
}

注意

針對您將在 DR 月臺執行備份的災害復原（DR）案例，DR 月臺上 DR.json 所設定的 HANA 伺服器名稱應該與生產伺服器名稱相同。

針對 Azure 大型實例，您的儲存體 IP 位址必須位於與伺服器集區相同的子網中。例如，在此情況下，伺服器集區子網是 172.18.18.0/24，指派的儲存體 IP 位址為 172.18.18.11。

下一步

測試Azure 應用程式一致快照集工具

共用方式為

設定Azure 應用程式一致快照集工具

組態檔的命令

組態檔的必要值

Backint 共存

範例設定檔

下一步

意見反應

其他資源