排解 SAP HANA 適用的 Backint 代理程式問題

如果在執行備份或復原期間發生錯誤，則會在 SAP HANA Studio 或 SAP HANA Cockpit 中顯示錯誤訊息，因此請先檢查其中是否有關於錯誤原因的資訊。此資訊可能會在 backup.log 和 backint.log 追蹤檔案中顯示。如果使用的是多租戶架構資料庫容器 (MDC)，請確認已選取相關資料庫名稱。

請確認您是以 sidadm 使用者身分安裝 Backint 代理程式。

記錄檔

如果發生錯誤，請查看下列記錄：

  • SAP HANA backup.log，其中包含 SAP HANA 備份與復原作業的相關資訊。
  • SAP HANA backint.log，其中包含對備份介面的呼叫，該介面由 Backint 代理程式和其他外部備份工具使用。
  • Backint 代理程式記錄檔，其中包含 Backint 代理程式安裝和運作事件。Backint 代理程式記錄檔位於 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs 中。Backint 代理程式記錄可能會顯示與 Cloud Storage 的通訊錯誤，以及相關設定或權限問題。
  • Google Cloud 記錄，可能包含與 Backint 代理程式使用的服務帳戶相關的錯誤。如要查看 Google Cloud 記錄，請前往Google Cloud 控制台的「Logs Explorer」頁面。

另外，請檢查 SAP HANA 主機上的磁碟和網路 I/O 資訊，以驗證活動。

如需進一步瞭解 Backint 代理程式記錄，請參閱 Backint 代理程式的記錄一節。

連線問題

如果 Backint 代理程式無法連線到 Cloud Storage 值區，請查看設定步驟。請特別查看下列項目：

  • 請重試失敗的備份或還原作業，確認錯誤並非只是暫時的連線問題。
  • 如果您使用的是主機 VM 的服務帳戶，且具備 Backint 代理程式，在 Google Cloud 主控台的「VM instance details」(VM 執行個體詳細資料) 頁面中，「Cloud API access scopes」(Cloud API 存取權範圍) 底下會列出「Storage」(儲存空間) 的存取權範圍，為「Read Write」(讀寫)。如果存取權範圍未列於上述位置，請停止執行個體，並編輯存取權範圍。
  • 如果您已為 Backint 代理程式建立服務帳戶：
    • 在Google Cloud 控制台的「Bucket details」(值區詳細資料) 頁面「Permissions」(權限) 分頁中，確認 Backint 代理服務帳戶已列出，且具備「Storage Object Admin」角色。
    • 確認您已建立私密金鑰並儲存在 SAP HANA 主機上，並在 Backint 代理程式設定檔 /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt 中，正確指定 JSON 金鑰檔案的路徑。
  • 已正確指定 parameters.txt Backint 代理程式設定檔和 SAP HANA global.ini 檔案中的所有參數。

您可以使用 Google Cloud CLI，測試從 SAP HANA 主機存取 Cloud Storage 值區的權限。使用 gcloud CLI，在 Cloud Storage 值區中儲存及存取文字檔案：

  1. 如果您未使用預設服務帳戶，請以Google Cloud 身分進行驗證，無論是使用已獲授權存取 Cloud Storage 值區的使用者，或是 Backint 代理服務帳戶：

    gcloud auth login user-account
     或者：
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
     如要進一步瞭解服務帳戶的 Cloud Storage 驗證，請參閱「gcloud CLI 驗證」。

  2. 確認您可以列出儲存在值區中的物件：

    gcloud storage ls gs://bucket/

  3. 建立測試檔案：

    touch test.txt

  4. 確認您可以將測試檔案寫入 bucket：

    gcloud storage cp test.txt gs://bucket/test.txt

  5. 確認您可以讀取值區中的測試檔案：

    gcloud storage cp gs://bucket/test.txt

處理量偏低

如果吞吐量低於預期，請確認是否已停用壓縮功能。

如要停用壓縮功能，請在 Backint 代理程式 parameters.txt 檔案中新增 #DISABLE_COMPRESSION 標記。

多重串流錯誤

如果在進行多串流時遇到錯誤，請將串流數變更為一 (1)，看看該錯誤是否與串流數有關。

如要進一步瞭解 Backint 代理程式記錄，請參閱「使用 Backint 代理程式進行多串流資料備份」。