為 SAP HANA 設定以 Backint 為基礎的備份和復原功能

本指南說明如何設定 Google Cloud的 SAP 代理程式，為 SAP HANA 執行以 Backint 為基礎的備份和復原作業。

如需有關此功能的概念資訊，可協助您規劃實作方式，請參閱「使用 Backint 備份及復原 SAP HANA」。

如要瞭解如何建立以 Backint 為基礎的備份，並使用這些備份復原 SAP HANA，請參閱「使用 Backint 備份及復原 SAP HANA」。

事前準備

• 驗證您是否已安裝Google Cloud的 Agent for SAP 3.8 版 (最新版)。如需操作說明，請參閱適用於您情況的安裝指南。
• 如果您已在 Bare Metal 解決方案伺服器上安裝代理程式，請確認您已完成必要的先決條件，並設定服務帳戶。如需操作說明，請參閱「在 Linux 上設定 Google Cloud的 Agent for SAP」。
• 如果 SAP HANA 資料庫是在內部部署環境中執行，請務必設定服務帳戶及其金鑰。如要瞭解如何執行這項操作，請參閱「在 Linux 上設定 Google Cloud的 Agent for SAP」。
• 如果您需要為Google Cloud的 Agent for SAP 啟用這項功能，而該執行個體是在 Compute Engine 執行個體或 Bare Metal Solution 伺服器以外的主機上執行，則必須在 BC-OP-LNX-GOOGLE 元件中建立 SAP 支援事件，以便 SAP 和 Google Cloud 都能評估您的設定。
• 安裝 SAP HANA：
  • 如要瞭解如何使用 Terraform 在Google Cloud 上自動安裝 SAP HANA，請參閱適用於您情況的部署指南。
  • 如要瞭解如何在裸機解決方案上安裝 SAP HANA，請參閱 裸機解決方案的 SAP HANA 規劃指南。

建立 Cloud Storage bucket

啟用 Google Cloud適用於 SAP 的代理程式 Backint 功能前，請確認已建立 Cloud Storage 值區來儲存備份。如果您有 Cloud Storage 值區，可以略過本節。

如要瞭解如何在 Cloud Storage 值區中儲存備份，請參閱「在 Cloud Storage 值區中儲存備份」。

如要建立 Cloud Storage 值區，請按照下列步驟操作：

設定 IAM 角色

如要讓 Google Cloud的 SAP 代理程式執行 SAP HANA 的備份與復原作業，您必須確保 Compute Engine 執行個體或裸機解決方案伺服器使用的服務帳戶包含 IAM 角色 Storage Object Admin (storage.objectAdmin)。

如要將這個角色新增至服務帳戶，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「IAM」頁面。

   前往身分與存取權管理頁面

2. 選取 Google Cloud 專案。

3. 找出您想指派角色的服務帳戶。

   • 如果服務帳戶不在主體清單中，表示尚未獲派任何角色。按一下「Add」，然後輸入服務帳戶的電子郵件地址。
   • 如果服務帳戶已在使用者清單中，表示已獲指派角色。找到要編輯的服務帳戶，然後按一下「編輯」按鈕。

4. 在可用的角色清單中，選取「Storage Object Admin」(儲存空間物件管理員)。

5. 按一下 [Add] (新增) 或 [Save] (儲存)，即可將角色套用到服務帳戶。

如需更精細的存取權層級，您可以在專案層級為服務帳戶的自訂角色設定下列身分與存取權管理角色：

• storage.objects.list
• storage.objects.create

您還必須為值區設定 IAM 政策，方法是授予實體下列 IAM 權限：

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

如要執行多部分上傳作業，請新增下列權限：

• storage.multipartUploads.create
• storage.multipartUploads.abort

如要進一步瞭解如何建立自訂角色，請參閱「建立及管理自訂角色」。如要進一步瞭解如何授予主體值區層級存取權的自訂角色，請參閱「將主體新增至值區層級政策」。

啟用 Cloud API 和中繼資料伺服器的存取權

Google Cloud的 SAP 代理程式在備份和復原作業期間需要存取下列 Google CloudIP 位址和主機：

• 如要存取 Cloud Storage，請使用 storage.googleapis.com。
• 針對 Compute Engine 執行個體中繼資料伺服器：
  • oauth2.googleapis.com，用於驗證
  • 169.254.169.254
  • metadata.google.internal

如果 Google Cloud的 Agent for SAP 和 SAP HANA 系統是在無法存取網際網路的 Compute Engine 執行個體上執行，則您需要設定私人 Google 存取權，讓代理程式能夠與 Cloud Storage 互動，如果使用專屬服務帳戶，則還需要使用 Google Cloud進行驗證。如需操作說明，請參閱「設定私人 Google 存取權」。

啟用 Backint 功能

如要啟用 Google Cloud的 Agent for SAP 的 Backint 功能，請完成下列步驟：

1. 使用 SSH 連線至 SAP HANA 主機。

   如果主機是 Compute Engine 執行個體，您可以在 Google Cloud 控制台的「VM 執行個體」頁面中，按一下執行個體的「SSH」按鈕，或使用您偏好的 SSH 方法。

2. 切換至 SAP HANA 系統管理員：

   sudo su - SID_LCadm

   將 SID_LC 替換為 SID。請使用小寫字母。

   此指令也會設定多個環境變數，包括 $SAPSYSTEMNAME，該變數會使用 SAP HANA 資料庫的 SID 進行設定。

3. 為 Google Cloud的 Agent for SAP 啟用 Backint 功能：

   /usr/bin/google_cloud_sap_agent installbackint

   或者，如要將 Backint 相關檔案安裝在具有不同 SID 的主機上，請加入 sid 標記：

   /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

   將 DIFFERENT_SID_LC 替換為所需 SAP HANA 執行個體的 SID。請使用小寫英文字母。

   指令成功執行後， Google Cloud的 Agent for SAP 的 Backint 功能相關檔案就會安裝在 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ 目錄中。包括將代理程式與 SAP HANA 整合所需的檔案。也會在主機上偵測 SAP HANA 適用的 Cloud Storage Backint 代理程式、停用該代理程式，並將其檔案複製到主機上的可復原目錄。詳情請參閱「從 Backint 代理程式升級」。

4. 設定 Backint 功能：

   執行指令

   • 如果 SAP HANA 資料庫是在 Compute Engine 執行個體或 Bare Metal Solution 伺服器上執行，則如要設定代理程式的 Backint 功能，請執行 configurebackint 指令。我們建議您採用這種方法，而非編輯代理程式的 Backint 設定檔。

     /usr/bin/google_cloud_sap_agent configurebackint \
      -f="PATH_TO_PARAMETERS_FILE" \
      -bucket="BUCKET_NAME"

   • 如果 SAP HANA 資料庫是在內部部署環境中執行，請執行下列指令來設定代理程式的 Backint 功能：

     /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

     更改下列內容：

     • PATH_TO_PARAMETERS_FILE：PARAMETERS.json Backint 設定檔的路徑
     • BUCKET_NAME：您要儲存 SAP HANA 備份的 Cloud Storage 值區名稱
     • PATH_TO_KEY：您設定的 JSON 編碼 Google Cloud 服務帳戶金鑰完整路徑

   您可以視需要在執行這項指令時設定更多參數。如要瞭解這些參數，請參閱「設定參數」。

   編輯設定檔

   除了執行代理程式的 configurebackint 指令之外，您也可以按照下列步驟編輯 Backint 設定檔：

   1. 開啟 Backint 設定檔：

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json

      將 SID 替換為您安裝 Backint 相關檔案的 SAP 系統 SID。

      以下是設定檔的內容範例：

      {
       "bucket": "",
       "log_to_cloud": true
      }

   2. 如要讓 Google Cloud的 SAP 代理程式為 SAP HANA 系統執行以 Backint 為基礎的備份和復原作業，請編輯設定檔，然後指定下列參數：

      • bucket：指定要儲存 SAP HANA 備份的 Cloud Storage 值區名稱
      • service_account_key：如果您已為 Google Cloud的 Agent for SAP 建立服務帳戶，請指定主機上相應 JSON 編碼服務帳戶金鑰上傳目錄的絕對路徑

      詳情請參閱服務帳戶注意事項。

   3. 如果 SAP HANA 資料庫是在內部部署環境中執行，請務必也設定下列項目：

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false

   4. 您也可以視需要修改其他設定參數。如要瞭解這些參數，請參閱「設定參數」。

   5. 儲存設定檔。

自訂 Backint 設定檔

您可以選擇在啟用 Google Cloud的 SAP 代理程式 Backint 功能後，執行下列自訂動作：

• 重新命名 parameters.json 檔案。

  為了表示這個重新命名動作， Google Cloud的 SAP 代理程式說明文件中會將此檔案稱為 PARAMETERS.json。

• 請為下列項目各自建立設定檔：SAP HANA 資料磁碟區、SAP HANA 記錄磁碟區和 SAP HANA 備份目錄。

  請務必為每個設定檔設定不重複的名稱。

• 將這些設定檔移至其他目錄。舉例來說，在向外擴充部署中，您可以將所有節點的 Backint 相關設定檔儲存在節點可存取的共用目錄中。這樣一來，您就能更輕鬆地管理這些檔案。

如果您執行上述任何自訂動作，請務必在 SAP HANA 的 global.ini 檔案中，適當指定參數的檔案名稱和路徑。如需操作說明，請參閱「為 Backint 功能設定 SAP HANA」。

針對 Backint 功能設定 SAP HANA

啟用 Google Cloud適用於 SAP 的代理程式的 Backint 功能後，您需要設定 SAP HANA 系統以使用這項功能：

1. 使用 SAP HANA Studio 或 SAP HANA 主控台編輯 global.ini 設定檔。

2. 在 global.ini 檔案的 backup 部分中，指定下列參數的值：

   參數	值
   data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json。
   parallel_data_backup_backint_channels	針對多串流資料備份，請根據您使用的 Cloud Storage 值區類型、所需效能和磁碟傳輸量，指定管道數量。
   log_backup_using_backint	如果您使用的是 SAP HANA 備份記錄磁碟區的個別設定檔，請指定 true 值。
   log_backup_parameter_file	如果您使用的是 SAP HANA 備份記錄檔磁碟區的個別設定檔，請指定以下值：/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json。 將 PARAMETERS_LOG 替換為您用於備份 SAP HANA 記錄磁區的設定檔名稱。
   catalog_backup_using_backint	如果您使用的是 SAP HANA 備份目錄的專屬設定檔，請指定 true 值。
   catalog_backup_parameter_file	如果您使用的是 SAP HANA 備份目錄的專屬設定檔，請指定以下值：/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json。 將 PARAMETERS_CATALOG 替換為您用於備份 SAP HANA 備份目錄的設定檔名稱。

   以下是已設定為使用 Google Cloud的 Agent for SAP 的 Backint 功能的 global.ini 檔案範例：

   [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

3. 在 global.ini 檔案的 persistence 部分中，指定下列參數的值：

   • basepath_logbackup：指定檔案系統中的目錄，當 SAP HANA 無法連線至 Cloud Storage 值區時，可用於儲存記錄備份；請確認這個目錄有足夠的空間儲存備份。
   • basepath_catalogbackup：指定檔案系統中的目錄，當 SAP HANA 無法連線至 Cloud Storage 值區時，SAP HANA 可在此目錄中儲存 SAP HANA 備份目錄的備份；請確認這個目錄有足夠的空間儲存備份。

   

驗證 Backint 備份與復原功能的設定

您可以驗證是否已正確 Google Cloud 設定代理程式，以便為 SAP HANA 系統執行 Backint 備份和復原作業。您可以執行代理程式的 status 指令來進行驗證，這個指令自代理程式 3.7 版起就已支援。

如要這樣做，請按照下列步驟進行：

1. 與 Compute Engine 執行個體或 Bare Metal 解決方案伺服器建立 SSH 連線。

2. 執行下列指令：

   sudo /usr/bin/google_cloud_sap_agent status -b="BACKINT_PARAM_FILE_PATH"
   

   如果您 Google Cloud 設定的 Backint 備份和復原功能正確，輸出內容就會包含以下內容。您的設定會為與 Backint 相關的設定參數提供不同的值。

   Agent Status:
       ...
       Systemd Service Enabled: True
       Systemd Service Running: True
       Cloud API Full Scopes: True
       Configuration File: /etc/google-cloud-sap-agent/configuration.json
       Configuration Valid: True
   ...
   ----------------------------------------------------------------------------
   Backint: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           bucket:           my-bucket                                                           (configuration file)
           log_to_cloud:     true                                                                (default)
           parallel_streams: 16                                                                  (configuration file)
           param_file:       /usr/sap/NS1/SYS/global/hdb/opt/backint/backint-gcs/parameters.json (configuration file)
           threads:          32                                                                  (configuration file)
   ...

驗證備份和復原作業

啟用 Google Cloud的 SAP 代理程式 Backint 功能後，請務必在測試系統中建立及還原備份，以便驗證該功能。

如要進行測試，您可以使用代理程式內建的自我診斷工具。檔案系統中至少要有 18 GB 的可用磁碟空間，才能執行這個內建工具。如要使用這個內建工具驗證備份和復原作業，請執行下列指令：

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

更改下列內容：

• IDENTIFIER：用於識別指令執行作業的值。這個 ID 會用於命名在執行診斷時，在 Cloud Storage 值區中建立的暫存資料夾。
• PATH_TO_PARAMETERS_FILE：PARAMETERS.json 檔案的路徑

使用這項工具時，您可以使用選用參數 diagnose_file_max_size_gb 和 diagnose_tmp_directory。如要進一步瞭解這些參數，請參閱「設定參數」中的說明。

如果您已在主機上安裝 Backint 代理程式，那麼當您第一次使用 Google Cloud的 Agent for SAP 執行備份作業時，Google Cloud的 Agent for SAP 會建立文字設定檔的 JSON 版本。詳情請參閱「從 Backint 代理程式升級」。

設定檔範例

以下是 Google Cloud的 Agent for SAP 的 Backint 功能的完整 PARAMETERS.json 設定檔：

{
  "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"
}

設定參數

下表說明Google Cloud的 SAP 代理程式專屬於 Backint 功能的設定參數。

如要瞭解 Backint 代理程式和 Google Cloud的 Agent for SAP 之間的設定參數對應關係，請參閱「設定參數的對應關係」。

如要瞭解 Google Cloud的 SAP 代理程式設定參數，包括與指標收集相關的參數，請參閱適用於您情況的安裝指南。

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}

疑難排解

如要排解Google Cloud適用於 SAP 的 3.8 版 (最新版) 代理程式的問題，請參閱 Google Cloud適用於 SAP 的代理程式疑難排解指南。

取得支援

如果您需要協助解決 Google Cloud的 Agent for SAP 問題，請收集必要的診斷資訊，然後與 Cloud Customer Care 團隊聯絡。如需詳細資訊，請參閱 Google Cloud的 SAP HANA 診斷資訊代理程式。

後續步驟

• 如要瞭解如何建立以 Backint 為基礎的備份，並使用這些備份復原 SAP HANA 資料庫，請參閱「使用 Backint 備份及復原 SAP HANA」一文。