バックアップや復元の実行中にエラーが発生した場合は、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 コンソールのログ エクスプローラ ページをご覧ください。
また、SAP HANA ホストのディスクとネットワークの I/O 情報を確認して、アクティビティを検証します。
Backint エージェントのロギングについて詳しくは、Backint エージェントのロギングをご覧ください。
接続に関する問題
Backint エージェントが Cloud Storage バケットに接続できない場合は、構成の手順を確認してください。特に、以下について確認してください。
- 失敗したバックアップまたは復元を再試行して、エラーが瞬間的な接続の問題ではないことを確認します。
- Backint エージェントでホスト VM のサービス アカウントを使用する場合、Google Cloud コンソールの VM インスタンスの詳細ページにある Cloud API アクセス スコープにストレージのアクセス スコープが読み取り / 書き込みとして表示されます。そのように表示されない場合は、インスタンスを停止してアクセス スコープを編集してください。
- Backint エージェント用のサービス アカウントを作成した場合は、次の内容を確認してください。
- Google Cloud コンソールの [バケットの詳細] ページの [権限] タブで、Backint エージェントのサービス アカウントが表示されており、ストレージ オブジェクト管理者のロールがサービス アカウントに割り当てられていることを確認します。
- 秘密鍵を作成して SAP HANA ホストに保存し、Backint エージェント構成ファイル
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txtに JSON キーファイルのパスを正しく指定していることを確認します。
- Backint エージェント構成ファイル
parameters.txtと SAP HANA ファイルglobal.iniの両方で、すべてのパラメータが正しく指定されている。
Google Cloud CLI を使用して、SAP HANA ホストから Cloud Storage バケットへのアクセスをテストできます。gcloud CLI を使用して、Cloud Storage バケットにテキスト ファイルを保存してアクセスします。
デフォルトのサービス アカウントを使用していない場合には、Cloud Storage バケットまたは Backint エージェントのサービス アカウントに承認されたユーザーとして Google Cloud で認証します。
gcloud auth login user-account
gcloud auth activate-service-account --key-file=/path/key-file-name.json
バケットに保存されているオブジェクトを一覧表示できることを確認します。
gcloud storage ls gs://bucket/
テストファイルを作成します。
touch test.txt
テストファイルをバケットに書き込めることを確認します。
gcloud storage cp test.txt gs://bucket/test.txt
バケット内のテストファイルが読み取れることを確認します。
gcloud storage cp gs://bucket/test.txt
低いスループット
スループットが想定よりも低い場合は、圧縮が無効になっていることを確認します。
圧縮を無効にするには、Backint エージェントの parameters.txt ファイルに #DISABLE_COMPRESSION フラグを追加します。
マルチストリーミング エラー
マルチ ストリーム中にエラーが発生した場合は、ストリーム数を 1 に変更して、ストリーム数に関連するエラーかどうかを確認します。
Backint エージェント ロギングの詳細については、Backint エージェントを使用したマルチストリーミング データのバックアップをご覧ください。