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 用エージェントを構成するをご覧ください。
  • この機能を、Compute Engine 仮想マシン(VM)インスタンスまたは Bare Metal Solution サーバー以外のホストで実行されている Google Cloud の SAP 用エージェントのインスタンスで有効にする必要がある場合は、SAP と Google Cloud の両方が構成を評価できるように、コンポーネント BC-OP-LNX-GOOGLE で SAP サポートにインシデントを作成する必要があります。
  • SAP HANA をインストールします。

Cloud Storage バケットを作成する

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

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

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

Google Cloud コンソール

  1. In the Google Cloud console, go to the Cloud Storage Buckets page.

    Go to Buckets page

  2. Click Create bucket.
  3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
    • For Name your bucket, enter a name that meets the bucket naming requirements.
    • For Choose where to store your data, do the following:
      • Select a Location type option.
      • Select a Location option.
    • For Choose a default storage class for your data, select a storage class.
    • For Choose how to control access to objects, select an Access control option.
    • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
  4. Click Create.

コマンドライン

    Create a Cloud Storage bucket and configure it as follows:
    • STORAGE_CLASS は、目的のストレージ クラスで置き換えます。
    • LOCATION は、目的のロケーション(ASIAEU、または US)で置き換えます。
    • BUCKET_NAME は、 バケット名の要件を満たすバケット名に置き換えます。
    • gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

IAM のロールを設定する

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

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

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

    [IAM] に移動

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

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

    • サービス アカウントがまだプリンシパル リストに含まれていない場合、サービス アカウントには何もロールが割り当てられていません。[追加] をクリックし、サービス アカウントのメールアドレスを入力します。
    • このサービス アカウントがすでにプリンシパル リストに含まれている場合、サービス アカウントには既存のロールがあります。編集するサービス アカウントの [編集] ボタンをクリックします。
  4. 使用可能なロールのリストから、[ストレージ オブジェクト管理者] を選択します。

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

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

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

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

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

Backint 機能を有効にする

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

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

    ホストが Compute Engine VM の場合は、Google Cloud コンソールの [VM インスタンス] ページから 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 機能を構成します。

    コマンドの実行

    エージェントの Backint 機能を構成するには、configurebackint コマンドを実行します。Backint 構成ファイルを編集するよりも、この方法をおすすめします。

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

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

    • PATH_TO_PARAMETERS_FILE: PARAMETERS.json Backint 構成ファイルのパス
    • BUCKET_NAME: SAP HANA バックアップを保存する Cloud Storage バケットの名前を指定します。

      必要に応じて、このコマンドの実行中に追加のパラメータを設定できます。これらのパラメータの詳細については、構成パラメータをご覧ください。

    構成ファイルを編集する

    エージェントの 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. 必要に応じて、他の構成パラメータを変更することもできます。これらのパラメータの詳細については、構成パラメータをご覧ください。

    4. 構成ファイルを保存します。

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 バックアップ カタログのバックアップを保存できるファイル システム内のディレクトリを指定します。このディレクトリにバックアップを保存するための十分な容量があることを確認してください。

    global.ini ファイルの persistence セクションで、パラメータ basepath_catalogbackup と basepath_logbackup が同じ値を示しています

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

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_gbdiagnose_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

String

Google Cloud の SAP 用エージェントが書き込みと読み取りを行う Cloud Storage バケットの名前を指定します。Backint エージェントはバケットのストレージ クラスでバックアップ オブジェクトを作成し、すべてのストレージ クラスがサポートします。エージェントは、Compute Engine のデフォルトの暗号化を使用して、保存データを暗号化します。

recovery_bucket

String

省略可。エージェントが RESTORE オペレーションで読み出す Cloud Storage バケットの名前を指定します。このパラメータを指定しない場合、エージェントはすべてのオペレーション(BACKUPRESTOREINQUIREDELETEDIAGNOSE)で bucket パラメータに指定されたバケットを使用します。

このパラメータを使用して、システム コピー オペレーションとシステム更新オペレーションの構成管理を簡素化することをおすすめしますが、SAP HANA 復元オペレーション中の CHECK ACCESS USING BACKINT 引数とは互換性がありません。

log_to_cloud

Boolean

省略可。Google Cloud の SAP 用エージェントの Backint 関連のログを Cloud Logging にリダイレクトするには、true を指定します。デフォルト値は true です。

Backint 関連のログファイルについては、ロギングをご覧ください。

log_level

String

省略可。Google Cloud の SAP 用エージェントの Backint 機能にロギングレベルを指定し、必要な値を設定します。使用可能なログレベルは次のとおりです。

  • DEBUG
  • INFO
  • WARNING
  • ERROR

デフォルト値は INFO です。Cloud カスタマーケアから指示されない限り、ロギングレベルを変更しないでください。

compress

Boolean

省略可。Google Cloud の SAP 用エージェントが Cloud Storage バケットにバックアップを書き込む際に圧縮を有効にするかどうかを指定します。デフォルト値は false です。

圧縮は有効にしないことをおすすめします。圧縮によって、Cloud Storage のバックアップ用ストレージの費用は削減されますが、バックアップ オペレーション中により多くの CPU 処理が必要になり、実質的にバックアップのスループットが低下します。

このパラメータに関係なく、Google Cloud の SAP 用エージェントは、復元オペレーションにおいて、圧縮バックアップ ファイルと非圧縮バックアップ ファイルの両方をサポートします。

encryption_key

String

省略可。Cloud Storage バケットでバックアップを暗号化するために構成した、顧客指定の暗号鍵のパスを指定します。base64 でエンコードされた AES-256 鍵への完全修飾パスを指定してください。

encryption_key パラメータを kms_key パラメータや parallel_streams パラメータと同時に指定することはできません。

kms_key

String

省略可。Cloud Storage バケットでバックアップを暗号化するために構成した、顧客管理の暗号鍵のパスを指定します。パスは、projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME の形式で指定します。ここで:

  • KMS_PROJECT_ID: KMS 鍵が存在する Google Cloud プロジェクトの ID
  • LOCATION: KMS 鍵が存在する Cloud KMS のロケーション
  • KEY_RING_NAME: KMS 鍵を含むキーリングの名前
  • KMS_KEY_NAME: KMS 鍵の名前

SAP HANA システムが Compute Engine VM で実行されている場合は、VM から鍵にアクセスできる必要があります。SAP HANA システムが Compute Engine VM 以外のホストで実行されている場合は、Google Cloud の SAP 用エージェントが使用するサービス アカウントから Cloud KMS 鍵にアクセスできる必要があります。詳しくは、サービス アカウントをご覧ください。

kms_key パラメータを encryption_key パラメータや parallel_streams パラメータと同時に指定することはできません。

folder_prefix

String

省略可。Google Cloud の SAP 用エージェントが書き込みと読み取りを行う Cloud Storage バケット内のフォルダの接頭辞を設定するように指定します。このパラメータを使用すると、同じ Cloud Storage バケット内の異なる SAP HANA インスタンスのバックアップを整理できます。単一のフォルダ(folder1 など)またはフォルダのマルチレベルのパス(folder1/folder2/folder3 など)を指定できます。

この接頭辞は、Cloud Storage 内の SAP HANA バックアップのパスの BUCKET_NAME 値と SID 値の間にフォルダとして挿入されます。詳細については、サポートされているカスタマイズをご覧ください。

このパラメータは、エージェントのバージョン 3.1 以降で使用できます。

recovery_folder_prefix

String

省略可。RESTORE オペレーション中にエージェントが読み取る Cloud Storage バケット内のフォルダの接頭辞を設定するように指定します。このパラメータを使用すると、同じ Cloud Storage バケット内の異なる SAP HANA インスタンスのバックアップを整理できます。単一のフォルダ(folder1 など)またはフォルダのマルチレベルのパス(folder1/folder2/folder3 など)を指定できます。 詳細については、サポートされているカスタマイズをご覧ください。

このパラメータは、エージェントのバージョン 3.1 以降で使用できます。

このパラメータを使用して、システム コピー オペレーションとシステム更新オペレーションの構成管理を簡素化することをおすすめしますが、SAP HANA 復元オペレーション中の CHECK ACCESS USING BACKINT 引数とは互換性がありません。

shorten_folder_path

Boolean

省略可。すべての Backint オペレーション中にエージェントが読み書きする Cloud Storage バケット内のオブジェクト パスを短くするように指定します。詳細については、サポートされているカスタマイズをご覧ください。

このパラメータは、エージェントのバージョン 3.3 以降で使用できます。

retries

Int

Google Cloud の SAP 用エージェントが Cloud Storage への読み取りまたは書き込みに失敗した場合に再試行する最大回数を指定します。デフォルト値は 5 で、これが推奨値でもあります。

parallel_streams

Int

省略可。このパラメータを指定すると、Cloud Storage バケットへのバックアップの並列アップロードが可能になります。このパラメータに指定する値は、Google Cloud の SAP 用エージェントが使用できる並列アップロード ストリームの最大数です。最大値は 32 です。値がこれを超えた場合は 32 に制限されます。

デフォルト値は 1 で、並列アップロードが無効になります。

ストリーミング データのパラレル アップロードを有効にする場合、または Cloud Storage バケットに保持ポリシーがある場合は、xml_multipart_uploadtrue に設定する必要もあります。

次のいずれかに該当する場合は、並列アップロードを有効にしないでください。

  • 対象の Cloud Storage バケットで保持ポリシーが使用されている。
  • encryption_key パラメータまたは kms_key パラメータを指定している。

上記の条件のいずれかが満たされる場合、エージェントはステータス 1 で終了します。並列アップロードの詳細については、並列アップロードをご覧ください。

xml_multipart_upload

Boolean

省略可。Cloud Storage バケットにバックアップを書き込むときに XML API マルチパート アップロード メソッドを使用するかどうかを指定します。デフォルト値は false です。

このパラメータは、エージェントのバージョン 3.2 以降で使用できます。

XML API マルチパート アップロード メソッドを使用するには、parallel_streams1 より大きい値を指定する必要があります。xml_multipart_uploadtrue に設定し、parallel_streams を指定しなかった場合、parallel_streams には自動的に 16 という値が割り当てられます。

xml_multipart_upload は、ログまたはカタログのバックアップを並列化する場合にのみ使用することをおすすめします。データのバックアップを並列化するには、global.ini ファイルの backup セクションで parallel_data_backup_backint_channels を設定することをおすすめします。

ログ バックアップとデータ バックアップ用に個別のパラメータ ファイルを作成する方法、または parallel_data_backup_backint_channels の値を設定する方法については、Backint 機能用に SAP HANA を構成するをご覧ください。

失敗した場合、XML マルチパート アップロードは自動的に中止され、アップロード中のデータは削除されます。また、AbortIncompleteMultipartUpload のライフサイクル条件を設定して、アップロード オペレーションが失敗した場合にデータが確実に削除されるようにすることをおすすめします。

storage_class

String

省略可。Cloud Storage バケットにバックアップを書き込むときに使用するストレージ クラスを指定します。使用可能なストレージ クラスは次のとおりです。

  • STANDARD
  • NEARLINE
  • COLDLINE
  • ARCHIVE

デフォルト値は STANDARD です。

このパラメータは、エージェントのバージョン 3.2 以降で使用できます。

metadata

Map<String, String>

省略可。Cloud Storage バケットにバックアップを書き込むときに、オブジェクトのメタデータとして保存する Key-Value フィールドを指定します。

このパラメータは、エージェントのバージョン 3.3 以降で使用できます。

サンプルの PARAMETERS.json 構成ファイルの形式は次のとおりです。

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

書き込まれるデフォルトのメタデータは、ファイル形式に応じて {"X-Backup-Type": "PIPE"} または {"X-Backup-Type": "FILE"} です。

custom_time

String

省略可。Cloud Storage にアップロードするバックアップの Custom-Time メタデータに設定する日付と時刻を指定します。日付と時刻は、Custom-Time で指定されている形式で指定する必要があります。

このパラメータは、エージェントのバージョン 3.4 以降で使用できます。

このパラメータに UTCNow という値を設定すると、バックアップの作成日時が UTC 形式で Custom-Time メタデータに設定されます。

エージェントのバージョン 3.6 以降では、UTCNow+NUMBERd を使用して Custom-Time メタデータに将来の日付を設定できます。たとえば、Custom-Time をバックアップ作成日時から 30 日後に設定するには、次のように構成を設定します。

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

PARAMETERS.json ファイルで日時値を使用してこのパラメータを指定する方法の例を次に示します。

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

Int

省略可。バックアップ オペレーションまたは復元オペレーションにおける Compute Engine のアウトバウンド ネットワーク帯域幅の上限を MB 単位で指定します。デフォルトでは、Google Cloud は Google Cloud の SAP 用エージェントのネットワーク帯域幅を制限しません。このパラメータを設定するとスループットが変化する場合がありますが、指定された上限を超えることはありません。

service_account_key

String

Google Cloud の SAP 用エージェントが Compute Engine VM で実行されていない場合は、JSON でエンコードされた Google Cloud サービス アカウントへの完全修飾パスを指定します。Google Cloud の SAP 用エージェントが Compute Engine VM で実行されている場合は、このパラメータを指定せず、Compute Engine のデフォルトの認証を使用することをおすすめします。

このパラメータを指定すると、Google Cloud の SAP 用エージェントは、Cloud Storage への認証時にサービス アカウント キーを使用します。

diagnose_file_max_size_gb

Int

省略可。エージェントのセルフ診断ツールが作成や削除を行う一時ファイルのサイズの上限(GB)を指定します。デフォルト値は 16 GB です。

このパラメータは、エージェントのバージョン 3.3 以降で使用できます。

セルフ診断ツールを正常に動作させるには、ファイル システムの使用可能なストレージが diagnose_file_max_size_gb の値より少なくとも 2~3 GB 多くなるようにする必要があります。

diagnose_tmp_directory

String

省略可。エージェントの自己診断ツールで、一時ファイルの読み書きに使用するディレクトリを指定します。デフォルト値は /tmp/backint-diagnose です。

このパラメータは、エージェントのバージョン 3.3 以降で使用できます。

send_metrics_to_monitoring

Boolean

省略可。Backint オペレーション中にアップロードまたはダウンロードされるファイルのステータスとスループスに関連する指標をエージェントが収集できるかどうかを指定します。エージェントは、収集した指標を Cloud Monitoring に送信します。

このパラメータは、エージェントのバージョン 3.3 以降で使用できます。

デフォルト値は true です。Backint 関連の指標については、Backint の指標の収集をご覧ください。

threads

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

ワーカー スレッドの数を指定します。デフォルト値はホストのプロセッサ数です。

file_read_timeout_ms

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

Google Cloud の SAP 用エージェントがバックアップ ファイルを開くまでの最大待機時間をミリ秒単位で指定します。デフォルト値は 60000(60 秒)です。

buffer_size_mb

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

このパラメータを指定すると、バックアップまたは復元のオペレーション中に Cloud Storage への HTTPS リクエストのサイズを制御できます。デフォルトのバッファサイズは 100 MB です。つまり、Cloud Storage とやり取りされる 1 つの HTTPS リクエスト ストリームは、100 MB のデータが転送されるまで開かれたままになります。バッファの最大サイズは 250 MB です。

Google Cloud の SAP 用エージェントは、失敗した HTTPS リクエストを複数回再試行してからオペレーションが失敗となるため、バッファサイズが 100 MB 未満の場合、リクエストが失敗した場合に再送する必要があるデータが少なくなります。バッファサイズを大きくするとスループットが向上しますが、リクエストが失敗した場合、データの再送信に必要なメモリ使用量と時間が増加します。

parallel_streams パラメータを使用している場合は、各ストリームが HTTPS リクエストを処理するために独自のバッファを必要とするため、必要なメモリ使用量にその値を掛ける必要があります。

retry_backoff_initial

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

指数バックオフ ネットワークの再試行で使用する再試行期間の初期値を秒単位で指定します。デフォルト値は 10 です。

retry_backoff_max

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

指数バックオフ ネットワークの再試行で使用する再試行期間の最大値を秒単位で指定します。デフォルト値は 300 です。

retry_backoff_multiplier

Float

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

指数バックオフ ネットワークの再試行で使用する再試行期間の乗数を指定します。乗数は、1 より大きくする必要があります。デフォルト値は 2 です。

log_delay_sec

Int

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

Cloud Storage バケットに対する読み取りと書き込みにおいて、進捗情報の更新によるロギングの遅延を秒単位で指定します。デフォルト値は 60 です。

client_endpoint

String

これは省略可能な、高度なチューニング パラメータです。カスタマーケアから指示されない限り、このパラメータは変更しないでください。デフォルト値を変更する必要はほとんどありません。

Cloud Storage クライアントのエンドポイントを指定します。デフォルト値は storage.googleapis.com です。

トラブルシューティング

Google Cloud の SAP 用エージェント バージョン 3.6(最新)における問題のトラブルシューティングについては、Google Cloud の SAP 用エージェントのトラブルシューティング ガイドをご覧ください。

サポートを受ける

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