SAP HANA の Backint ベースのバックアップと復元を構成する

このガイドでは、SAP HANA の Backint ベースのバックアップと復元を実行するために、Google Cloud の SAP 用エージェントを構成する方法について説明します。

実装計画に役立つこの機能のコンセプトについては、Backint を使用した SAP HANA のバックアップと復元をご覧ください。

Backint ベースのバックアップを作成し、それを使用して SAP HANA を復元する方法については、Backint を使用して SAP HANA のバックアップと復元を行うをご覧ください。

始める前に

• Google Cloud の SAP 用エージェントのバージョン 3.6（最新）のインストールを確認します。手順については、シナリオのインストール ガイドをご覧ください。
• Bare Metal Solution サーバーにエージェントがインストールされている場合は、必要な前提条件を満たしていることを確認して、サービス アカウントを設定します。手順については、Linux で Google Cloud の SAP 用エージェントを構成するをご覧ください。
• SAP HANA データベースがオンプレミス環境で実行されている場合は、サービス アカウントとそのキーを必ず設定してください。詳細については、Linux で Google Cloud の SAP 用エージェントを構成するをご覧ください。
• Compute Engine インスタンスまたは Bare Metal Solution サーバー以外のホストで実行されている Google Cloud の SAP 用エージェントのインスタンスでこの機能を有効にする必要がある場合は、SAP と Google Cloud の両方が構成を評価できるように、コンポーネント BC-OP-LNX-GOOGLE で SAP サポートのインシデントを作成する必要があります。
• SAP HANA をインストールします。
  • Google Cloud 上の SAP HANA の Terraform を使用したインストールの自動化については、シナリオのデプロイガイドをご覧ください。
  • Bare Metal Solution 向け SAP HANA をインストールする方法については、Bare Metal Solution 向け SAP HANA のプランニング ガイドをご覧ください。

Cloud Storage バケットを作成する

Google Cloud の SAP 用エージェントの Backint 機能を有効にする前に、バックアップを保存する Cloud Storage バケットが存在することを確認してください。Cloud Storage バケットがある場合、このセクションは省略できます。

Cloud Storage バケットにバックアップを保存する方法については、Cloud Storage バケットにバックアップを保存するをご覧ください。

Cloud Storage バケットを作成するには:

IAM のロールを設定する

Google Cloud の SAP 用エージェントが SAP HANA のバックアップと復元のオペレーションを実行できるようにするには、Compute Engine インスタンスまたは Bare Metal Solution サーバーが使用するサービス アカウントに、IAM ロール ストレージ オブジェクト管理者（storage.objectAdmin）が含まれるようにする必要があります。

このロールをサービス アカウントに追加する手順は次のとおりです。

1. Google Cloud コンソールの [IAM] ページに移動します。

   [IAM] に移動

2. Google Cloud プロジェクトを選択します。

3. ロールを追加するサービス アカウントを特定します。

   • サービス アカウントがまだプリンシパル リストに含まれていない場合、サービス アカウントには何もロールが割り当てられていません。[追加] をクリックし、サービス アカウントのメールアドレスを入力します。
   • このサービス アカウントがすでにプリンシパル リストに含まれている場合、サービス アカウントには既存のロールがあります。編集するサービス アカウントの [編集] ボタンをクリックします。

4. 使用可能なロールのリストから、[ストレージ オブジェクト管理者] を選択します。

5. [追加] または [保存] をクリックして、サービス アカウントにロールを適用します。

きめ細かいアクセスレベルの場合は、プロジェクト レベルでサービス アカウントのカスタムロールに次の IAM 権限を設定できます。

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

また、プリンシパルに次の IAM 権限を付与して、バケットに IAM ポリシーを設定する必要があります。

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

マルチパート アップロードを実行する場合は、次の権限を追加します。

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

カスタムロールの作成方法の詳細については、カスタムロールを作成、管理するをご覧ください。プリンシパルにバケットレベルのアクセス権のカスタムロールを付与する方法については、バケットレベルのポリシーにプリンシパルを追加するをご覧ください。

Cloud APIs とメタデータ サーバーへのアクセスを可能にする

Google Cloud の SAP 用エージェントは、バックアップと復元のオペレーション中に、以下の Google Cloud の IP アドレスとホストにアクセスする必要があります。

• Cloud Storage へのアクセスの場合: storage.googleapis.com
• Compute Engine インスタンス メタデータ サーバーの場合:
  • oauth2.googleapis.com（認証用）
  • 169.254.169.254
  • metadata.google.internal

Google Cloud の SAP 用エージェントと SAP HANA システムが、インターネットにアクセスできない Compute Engine インスタンスで実行されている場合は、エージェントが Cloud Storage とやり取りできるように、限定公開の Google アクセスを構成する必要があります。専用のサービス アカウントを使用する場合は、Google Cloud で自身を認証します。手順については、限定公開の Google アクセスを構成するをご覧ください。

Backint 機能を有効にする

Google Cloud の SAP 用エージェントの Backint 機能を有効にするには、次の手順を実行します。

1. SSH を使用して SAP HANA のホストに接続します。

   ホストが Compute Engine インスタンスの場合は、Google Cloud コンソールの [VM インスタンス] ページから、インスタンスの [SSH] ボタンをクリックするか、任意の SSH メソッドを使用します。

2. ユーザーを SAP HANA のシステム管理者に切り替えます。

   sudo su - SID_LCadm

   SID_LC は、SID に置き換えます。英字には小文字を使用します。

   このコマンドは、SAP HANA データベースの SID を設定する $SAPSYSTEMNAME など、複数の環境変数も設定します。

3. Google Cloud の SAP 用エージェントの Backint 機能を有効にします。

   /usr/bin/google_cloud_sap_agent installbackint

   また、異なる SID を持つホストに Backint 関連ファイルをインストールするには、sid フラグを指定します。

   /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

   DIFFERENT_SID_LC は、必要な SAP HANA インスタンスの SID に置き換えます。英字には小文字を使用します。

   コマンドが正常に実行されると、Google Cloud の SAP 用エージェントの Backint 機能に関連するすべてのファイルがディレクトリ /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/ にインストールされます。これには、エージェントと SAP HANA との統合に必要なファイルが含まれています。また、ホスト上の Cloud Storage Backint agent for SAP HANA を検出し、そのエージェントを無効にして、そのファイルをホスト上の復元可能なディレクトリにコピーします。詳細については、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 の 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 Cockpit を使用して、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 の 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 バックアップ カタログのバックアップを保存できるファイル システム内のディレクトリを指定します。このディレクトリにバックアップを保存するための十分な容量があることを確認してください。

   

バックアップと復元を検証する

Google Cloud の SAP 用エージェントの Backint 機能を有効にしたら、必ずテストシステムでバックアップを作成して復元し、機能を検証してください。

テストには、エージェントの組み込みの自己診断ツールを使用できます。この組み込みツールを実行するには、ファイル システムに 18 GB 以上の空きディスク容量が必要です。この組み込みツールを使用してバックアップと復元を検証するには、次のコマンドを実行します。

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

次のように置き換えます。

• IDENTIFIER: コマンドの実行を識別する値。この識別子は、診断の実行中に Cloud Storage バケットに作成される一時フォルダの名前付けに使用されます。
• PATH_TO_PARAMETERS_FILE: PARAMETERS.json ファイルのパス

このツールを使って、オプションのパラメータ diagnose_file_max_size_gb と diagnose_tmp_directory を使用できます。これらのパラメータの詳細については、構成パラメータの説明をご覧ください。

ホストに Backint エージェントをインストールしている場合は、Google Cloud の SAP 用エージェントを初めて使用してバックアップ オペレーションを実行すると、Google Cloud の SAP 用エージェントによってテキスト構成ファイルの JSON バージョンが作成されます。詳細については、Backint エージェントからのアップグレードをご覧ください。

構成ファイルの例

Google Cloud の 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"
}

構成パラメータ

以下の表に、Backint 機能に対応する Google Cloud の SAP 用エージェントの構成パラメータを示します。

Backint エージェントと Google Cloud の 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.6（最新）における問題のトラブルシューティングについては、Google Cloud の SAP 用エージェントのトラブルシューティング ガイドをご覧ください。

サポートを受ける

Google Cloud の SAP 用エージェントの問題解決にサポートが必要な場合は、必要な診断情報を収集し、Cloud カスタマーケアまでお問い合わせください。詳細については、Google Cloud の SAP 用エージェントの診断情報をご覧ください。

次のステップ

• Backint ベースのバックアップを作成し、それを使用して SAP HANA データベースを復元する方法については、Backint を使用して SAP HANA のバックアップと復元を行うをご覧ください。