Cloud Storage Backint agent for SAP HANA の概要

重要: 新規インストールでは、SAP HANA 用 Cloud Storage Backint エージェントを使用する代わりに、後継エージェントである Google Cloud の SAP 用エージェントを使用することをおすすめします。バージョン 3.0 以降、Google Cloud の SAP 用エージェントは、SAP Host Agent の指標収集だけでなく、SAP HANA の Backint ベースのバックアップや復元などの機能も提供しています。

Backint エージェントを使用している場合は、Backint エージェントのサポートが終了する前に、Google Cloud の SAP 用エージェント バージョン 3.5（最新）に切り替えることをおすすめします。アップグレード手順については、他の Google Cloud エージェントから Google Cloud の SAP 用エージェントにアップグレードするをご覧ください。

Backint エージェントのサポートは 2025 年 2 月に終了します。このエージェントは、2024 年 2 月以降に一般提供（GA）になった Compute Engine マシンタイプではサポートされていません。

SAP 認定の Cloud Storage Backint agent for SAP HANA（Backint エージェント）を使用すると、Google Cloud、Bare Metal Solution、オンプレミス、その他のクラウド プラットフォームで稼働している SAP HANA インスタンスから、SAP HANA バックアップを直接 Cloud Storage に送信できます。

Backint エージェントは SAP HANA と統合されているため、SAP に元から備わっているバックアップ機能と復元機能を使用して、Cloud Storage から直接バックアップの保存と取得ができます。

Backint エージェントを使用する場合、バックアップに永続ディスク ストレージを使用する必要はありません。

Backint エージェントのインストール手順については、Cloud Storage Backint agent for SAP HANA インストール ガイドをご覧ください。

注: Google Cloud 上にないホストマシンに Backint エージェントをインストールする前に、コンポーネント BC-OP-LNX-GOOGLE で SAP サポートのインシデント レポートを開いてください。これにより、SAP と Google Cloud が構成を評価できます。

Backint エージェントの SAP 認定の詳細については、以下をご覧ください。

• SAP Note 2031547
• Backint for SAP HANA certification

Backint エージェント構成ファイル

Backint エージェントを構成するには、書式なしテキスト ファイルでパラメータを指定します。

デフォルトの構成ファイルは parameters.txt と呼ばれ、デフォルトの場所は /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt です。

複数の構成ファイルを指定する場合は、各ファイルに異なる名前を付けます。

たとえば、ログのバックアップの構成を backint-log-backups.txt という名前のファイルで指定し、データのバックアップの構成を backint-data-backups.txt というファイルで指定できます。

Cloud Storage バケットにバックアップを保存する

Backint エージェントは、SAP HANA バックアップを Cloud Storage バケットに保存します。

バケットを作成するときに、バケットの場所とバケット ストレージ クラスを選択できます。

バケットのロケーションは、リージョン、デュアルリージョン、またはマルチリージョンのいずれかです。どのロケーションを選択するかは、データのロケーションを制限する必要性、バックアップと復元のレイテンシ要件、およびリージョン機能停止に対する保護の必要性によって異なります。詳細については、バケットのロケーションをご覧ください。

SAP HANA インスタンスが実行されているリージョンと同じ、あるいは近いデュアルリージョン バケットまたはマルチリージョン バケットを選択します。

バックアップを保持する必要がある期間、ストレージにアクセスする頻度、料金に基づいてストレージ クラスを選択します。詳しくは、ストレージ クラスをご覧ください。

Backint エージェントを使用したデータ バックアップのマルチストリーミング

SAP HANA 2.0 SP05 より前のバージョンの場合、SAP HANA は 128 GB を超えるデータベースのマルチストリーミングをサポートしています。SAP HANA 2.0 SP05 以降、このしきい値は SAP HANA パラメータ parallel_data_backup_backint_size_threshold によって構成可能になりました。このパラメータにより、マルチストリーミングを有効にするための最小のデータベース バックアップ サイズを GB 単位で指定できます。

マルチストリーミングは、スループットの向上や、Cloud Storage 内の単一オブジェクトの最大サイズである 5 TB を超えるデータベースのバックアップに役立ちます。

マルチストリーミングに使用するチャネルの最適な数は、使用している Cloud Storage バケットのタイプと SAP HANA を実行している環境によって異なります。また、HANA インスタンスに接続されているデータディスクのスループット能力と、管理者がバックアップ アクティビティに割り当てる帯域幅についても考慮する必要があります。

ストリーム数を変更して、スループットを調整できます。また、Backint エージェントの構成ファイル parameters.txt の #RATE_LIMIT_MB パラメータを使用して、スループットを制限できます。

マルチリージョン バケットの場合は、SAP HANA の global.ini 構成ファイルの parallel_data_backup_backint_channels パラメータを 8 に設定して、8 個のチャネルから始めます。

リージョン バケットの場合は、global.ini ファイルの parallel_data_backup_backint_channels を 12 に設定して、12 個のチャネルから始めます。

バックアップのパフォーマンス目標を達成するため、必要に応じてチャネル数を調整してください。

SAP HANA のドキュメントに記載されているように、追加チャネルにはそれぞれ 512 MB の I/O バッファが必要です。I/O バッファのサイズを指定するには、global.ini ファイルのバックアップ セクションで data_backup_buffer_size パラメータを使用します。バックアップ時間に対する I/O バッファサイズの影響については、SAP Note 2657261 をご覧ください。HANA 2.0 SP05 SAP の時点で、このパラメータの最大値は 4 GB です。Google Cloud でのテストでは、バッファサイズをデフォルトより大幅に増やすメリットは確認できませんでしたが、これはワークロードによって異なる場合があります。

マルチストリーミングの詳細については、使用している SAP HANA バージョンに対応する SAP HANA 管理ガイドの Multistreaming Data Backups with Third-Party Backup Tools をご覧ください。

並列アップロード

Backint エージェントの並列アップロード機能を有効にすると、ログ バックアップ ファイルのアップロードのパフォーマンスを向上させることができます。これは、ログ バックアップ ファイルの場合に特に有効です（ログ バックアップ ファイルは SAP HANA からマルチストリーミングできないため）。

データ バックアップの場合は、SAP HANA パラメータ parallel_data_backup_backint_channels のみを使用して、SAP HANA バックアップ チャネルの数を調整できます。

並列アップロードが有効になっている場合、Backint エージェントは、SAP HANA から受け取った個々のバックアップ ファイルを複数のパートに分割して、それぞれを並行してアップロードします。これにより、アップロードのパフォーマンスが向上します。

各パートは Cloud Storage によって受信されると、Backint エージェントによって SAP HANA から受信された元の単一のファイルとして再構築され、保存されます。単一のファイルには、Cloud Storage 内のオブジェクトに対する 5 TB のサイズ上限が適用されます。

並列アップロードの構成

並列アップロード機能は、#PARALLEL_FACTOR パラメータで並列アップロード スレッドの最大数を指定することにより、parameters.txt 構成ファイルで有効になります。

各パートのサイズを設定する #PARALLEL_PART_SIZE_MB パラメータと、ワーカー スレッド数を決定する #THREADS パラメータは、高度な調整専用です。Cloud カスタマーケアから指示されない限り、これらの設定を変更しないでください。デフォルト値を変更する必要はほとんどありません。

並列アップロードのパラメータの詳細については、Backint エージェントの構成オプションをご覧ください。

並列アップロードの制限

並列アップロード機能には、次の制限が適用されます。

• #ENCRYPTION_KEY または #KMS_KEY_NAME 構成パラメータで暗号化を有効にした場合、並列アップロードを使用できません。暗号化は並列アップロードに対応していません。これらの暗号化パラメータのいずれかで #PARALLEL_FACTOR パラメータを指定すると、Backint エージェントがステータス 1 で終了します。
• 圧縮を有効にした場合、並列アップロードを使用できません。圧縮は並列アップロードに対応していません。バージョン 1.0.22 以降では、#PARALLEL_FACTOR パラメータを指定して構成で #DISABLE_COMPRESSION パラメータを省略すると、Backint エージェントはステータス 1 で終了します。
• Cloud Storage バケットに保持ポリシーが実装されている場合、バケットは並列アップロードをサポートしていません。保持ポリシーにより、各パートを単一のファイルに再構築することが妨げられるため、アップロードは失敗します。

並列アップロードのパラメータの詳細については、Backint エージェントの構成オプションをご覧ください。

並列アップロードの調整

ログ バックアップの場合、SAP HANA はマルチストリーム ログのバックアップを実行しないため、並列アップロードでバックアップのスループットが大幅に改善されます。ほとんどの場合、16 以下の #PARALLEL_FACTOR を指定すれば十分です。大量のログを生成する場合、16 などの高い #PARALLEL_FACTOR 値を使用して、SAP HANA パラメータ log_segment_size_mb と max_log_backup_size の値を引き上げることにより、スループットを最大にすることができます。

場合によっては、#PARALLEL_FACTOR の値を高く設定すると、全体的なスループットが低下する可能性があります。たとえば、多数の並列バックアップ チャネルを使用している場合に発生することがあります。

バックアップで使用するネットワーク帯域幅を制限するには、#RATE_LIMIT_MB を使用して、並列アップロードで使用できる帯域幅の上限を設定します。

特定の環境、ワークロード、バックアップ タイプに適した設定を見つけるには、さまざまな設定でテストを行い、バックアップ スループットを測定します。

Backint エージェントの認証とアクセス制御

Google Cloud はサービス アカウントを使用して、Backint エージェントなどのプログラムを識別し、プログラムがアクセスできる Google Cloud リソースを制御します。

必要な Cloud Storage 権限

Backint エージェントのサービス アカウントには、Backint エージェントが Google Cloud リソースにアクセスする権限を付与する必要があります。ストレージ オブジェクト管理者のロールでは、Cloud Storage バケット内のオブジェクトの権限の一覧表示、取得、作成、削除を行うことができます。

サービス アカウントの権限は、プロジェクト レベルまたはバケットレベルで設定できます。プロジェクト レベルで設定すると、Backint エージェントはプロジェクト内のすべてのバケットにアクセスできるようになります。バケットレベルで設定した場合、Backint エージェントは 1 つのバケットにのみアクセスできます。Cloud Storage バケットの権限の詳細については、次を参照してください。

• プロジェクト レベルのロールとバケットレベルのロール
• IAM 権限の使用

Backint エージェントのサービス アカウント オプション

SAP HANA が Compute Engine VM で実行されている場合、デフォルトで、Backint エージェントは VM のサービス アカウントを使用します。

VM サービス アカウントを使用する場合、Backint エージェントには、VM サービス アカウントを使用する他のすべてのプログラムおよびプロセスと同じプロジェクト レベルの権限が付与されます。

最も厳密なアクセス制御を行うには、Backint エージェント用の別個のサービス アカウントを作成し、サービス アカウントにバケットレベルでバケットへのアクセス権を付与します。

SAP HANA が Compute Engine VM で実行されていない場合は、Backint エージェント用のサービス アカウントを作成する必要があります。Google Cloud プロジェクトで、Backint エージェントが使用する Cloud Storage バケットを含むサービス アカウントを作成します。

Backint エージェントのサービス アカウントを作成する場合は、サービス アカウント キーも作成する必要があります。キーは SAP HANA ホストに保存し、parameters.txt ファイルにキーへのパスを指定します。SAP HANA が Compute Engine VM で実行されている場合、キーへのパスを指定すると、Backint エージェントは、VM サービス アカウントではなく、そのキーに関連付けられたサービス アカウントを使用するようになります。

注: サービス アカウント キーが正しく管理されていない場合は、セキュリティ リスクが発生します。可能であれば、サービス アカウント キーよりも安全な代替手段を選択してください。サービス アカウント キーで認証する必要がある場合は、秘密鍵のセキュリティと、サービス アカウント キーを管理するためのベスト プラクティスで説明されているその他の操作は、ユーザーの責任で実施してください。サービス アカウント キーを作成できない場合は、組織でサービス アカウント キーの作成が無効になっている可能性があります。詳細については、デフォルトで安全な組織リソースの管理をご覧ください。

Cloud Key Management Service によって生成された顧客管理の暗号鍵を使用して Cloud Storage のバックアップを暗号化する場合は、サービス アカウントに暗号鍵へのアクセス権を付与する必要があります。詳細については、サービス アカウントへの Cloud KMS 鍵の割り当てをご覧ください。

Google Cloud APIs とメタデータ サーバーへのアクセス

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

• Cloud Storage にアクセスするため、次を使用します。
  • バージョン 1.0.14 以降のエージェント: storage.googleapis.com
  • バージョン 1.0.13 以前: www.googleapis.com
• #SERVICE_ACCOUNT プロパティにサービス アカウントを指定する場合は、認証に oauth2.googleapis.com を使用します。
• Compute Engine インスタンス メタデータ サーバーに 169.254.169.254 を使用します。デフォルトでは内部 DNS 名に解決されます。
• VM インスタンス メタデータに対して metadata.google.internal も使用します。

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

限定公開の Google アクセスを構成する。限定公開の Google アクセスの構成をご覧ください。

プロキシ サーバーと Backint エージェント

デフォルトでは、Backint エージェントは HTTP プロキシをバイパスし、オペレーティング システムのプロキシ環境変数（http_proxy、https_proxy、no_proxy など）を読み取りません。

警告: プロキシ経由でバックアップをルーティングすると、Cloud Storage からバックアップを送信または取得するときの、すべてのプロキシ トラフィックのパフォーマンスと信頼性に悪影響が及びます。そのため、Google Cloud では、Backint エージェントと HTTP プロキシを併用しないことを強くおすすめします。

代替手段がない場合、または組織がパフォーマンスの影響を理解し、プロキシ サーバーを介したバックアップ ルーティングのパフォーマンスをサポートするために必要な専門知識がある場合は、プロキシを使用するように Backint エージェントを構成できます。

Backint エージェントのプロキシ設定は net.properties ファイルに含まれています。

/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties

バックアップと復元にプロキシ サーバーをバイパスする

Backint エージェントは、デフォルトでプロキシ サーバーをバイパスしますが、/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties ファイルの http.nonProxyHosts パラメータのドメイン名と IP アドレスを指定することにより、そのバイパスを明示的に行うことができます。次に例を示します。

http.nonProxyHosts=localhost|127.|[::1]|.googleapis.com|169.254.169.254|metadata.google.internal

バックアップと復元にプロキシ サーバーを使用する

警告: プロキシ経由でバックアップをルーティングすると、Cloud Storage からバックアップを送信または取得するときの、すべてのプロキシ トラフィックのパフォーマンスと信頼性に悪影響が及びます。そのため、Google Cloud では、Backint エージェントと HTTP プロキシを併用しないことを強くおすすめします。

プロキシ サーバー経由でバックアップを送信するように Backint エージェントを構成するには、/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties ファイルでプロキシホストとポート番号のパラメータを指定します。

VM インスタンス メタデータに対するクエリでは、Backint エージェントはプロキシを使用できないため、http.nonProxyHosts パラメータでインスタンス メタデータのドメイン名と IP アドレスを指定する必要があります。

次の例は、Backint エージェントの有効なプロキシ構成を示しています。

http.proxyHost=proxy-host
http.proxyPort=proxy-port
http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
https.proxyHost=proxy-host
https.proxyPort=proxy-port

Backint エージェントの更新

Google Cloud は、Backint エージェントの新しいバージョンを定期的にリリースしています。新しいバージョンは、追加料金なしでダウンロードしてインストールできます。

Backint エージェントを本番環境で新しいバージョンに更新する前に、新しいバージョンを非本番環境で必ずテストしてください。

Backint エージェントを更新するには、https://www.googleapis.com/ へのリモート HTTP リクエストをサポートする SAP HANA ホストが必要です。

Backint エージェントの既存のインスタンスを新しいバージョンに更新するには、Backint エージェントを新しいバージョンに更新するをご覧ください。

バックアップの暗号化

Cloud Storage は、データをディスクに書き込む前に常に暗号化します。独自の暗号化レイヤを適用するために、Backint エージェント バックアップのサーバー側での暗号化用に独自の暗号鍵を指定できます。

Backint エージェントで独自の鍵を指定するには、次の 2 つの方法があります。

• 顧客指定の暗号鍵
• 顧客管理の暗号鍵

顧客管理の暗号鍵を使用するには、parameters.txt ファイルの #KMS_KEY_NAME パラメータで鍵へのパスを指定します。また、VM または Backint エージェントのサービス アカウントにこの鍵へのアクセス権を付与する必要があります。サービス アカウントに暗号鍵へのアクセス権を付与する際の詳細については、Cloud KMS 鍵をサービス アカウントに割り当てるをご覧ください。

顧客指定の暗号鍵を使用するには、parameters.txt ファイル内の #ENCRYPTION_KEY パラメータで鍵へのパスを指定します。鍵は、顧客指定の暗号鍵で説明されているように、base64 でエンコードされた AES-256 鍵文字列である必要があります。

警告: 暗号鍵を紛失すると、その鍵で暗号化されたファイルは使用できなくなります。鍵を安全な場所に保管してください。

暗号化の制限

暗号化機能には次の制限が適用されます。

• #KMS_KEY_NAME と #ENCRYPTION_KEY の両方が指定されている場合、Backint エージェントは失敗し、ステータス 1 で終了します。

• #PARALLEL_FACTOR が #KMS_KEY_NAME または #ENCRYPTION_KEY のいずれかに指定されている場合、Backint エージェントは失敗し、ステータス 1 で終了します。

構成パラメータのリファレンス

parameters.txt 構成ファイルに、Backint エージェントの多数のオプションを指定できます。

Backint エージェントを初めてダウンロードしたとき、parameters.txt ファイルには次の 2 つのパラメータのみが含まれます。

• #BUCKET
• #DISABLE_COMPRESSION

# はパラメータの一部であり、コメント インジケーターではないので注意してください。

各パラメータは別個の行に指定します。パラメータと値はスペースで区切ります。

次の表に、Backint エージェントの構成パラメータを示します。

パラメータと値	説明
#BUCKET bucket-name	Backint エージェントが書き込みと読み取りを行う Cloud Storage バケットの名前を指定する必須パラメータ。Backint エージェントはバケットのストレージ クラスでバックアップ オブジェクトを作成します。すべてのストレージ クラスがサポートされます。Backint エージェントは、Compute Engine のデフォルトの暗号を使用して、保存データを暗号化します。
#CHUNK_SIZE_MB MB	高度な調整パラメータ。 バックアップまたは復元の操作時における Cloud Storage への HTTPS リクエストのサイズを制御します。デフォルトのチャンクサイズは 100 MB です。つまり、Cloud Storage とやり取りされる単一の HTTP リクエスト ストリームは、100 MB のデータが転送されるまで開放されたままになります。 カスタマーケアから指示されない限り、この設定を変更しないでください。デフォルト設定は、スループットと信頼性のバランスが取れている設定です。これを変更する必要性が生じるケースは非常にまれです。 Backint エージェントは、失敗した HTTP リクエストを何度か再試行した後でオペレーションを失敗させるため、チャンクサイズを小さくすると、リクエストが失敗した場合に再送信が必要なデータの量が少なくなります。チャンクサイズを大きくするとスループットが向上しますが、リクエストが失敗した場合、データの再送信に必要なメモリ使用量と時間が増えます。
#DISABLE_COMPRESSION	Backint エージェントが Cloud Storage バケットにバックアップを書き込む際に、デフォルトのオンザフライ圧縮を無効にする省略可能なパラメータ。#DISABLE_COMPRESSION はデフォルトで指定されています。 #DISABLE_COMPRESSION を指定することをおすすめします。圧縮すると、Cloud Storage でのバックアップ用ストレージの費用は削減されますが、バックアップ オペレーション中により多くの CPU 処理が必要になり、有効なバックアップ スループットが低下します。 この設定の有無にかかわらず、Backint エージェントは復元の際に、圧縮されたバックアップ ファイルまたは圧縮されていないバックアップ ファイルのいずれかをサポートします。
#ENCRYPTION_KEY path/to/key/file	Cloud Storage がバックアップの暗号化に使用する顧客指定の暗号鍵へのパスを指定します。パスは、base64 でエンコードされた AES-256 鍵への完全修飾パスとして指定する必要があります。 #ENCRYPTION_KEY を #KMS_KEY_NAME または #PARALLEL_FACTOR とともに指定することはできません。 Google Cloud で独自の暗号鍵を使用する際の詳細については、顧客指定の暗号鍵をご覧ください。
#KMS_KEY_NAME path/to/key/file	Cloud Key Management Service によって生成される顧客管理の暗号鍵へのパスを指定します。Cloud Storage はこの鍵を使用してバックアップを暗号化します。 SAP HANA が Compute Engine VM で実行されている場合は、鍵が VM にアクセスできる必要があります。SAP HANA が Google Cloud で実行されていない場合、Cloud KMS 鍵は Backint エージェントのサービス アカウントにリンクする必要があります。詳細については、サービス アカウントをご覧ください。 projects/key_project/locations/location/keyRings/key_ring_name/cryptoKeys/key_name の形式でパスを指定します。 ここで key_project は、鍵に関連付けられているプロジェクトの ID です。 location は、鍵を使用できるリージョンかどうかを示します。詳細については、Cloud KMS のロケーションの種類をご覧ください。 key_ring_name は、鍵を含むキーリングの名前です。 key_name は、鍵の名前です。 #KMS_KEY_NAME を #ENCRYPTION_KEY または #PARALLEL_FACTOR とともに指定することはできません。 Google Cloud で独自の暗号鍵を管理する方法の詳細については、顧客管理の暗号鍵をご覧ください。
#MAX_GCS_RETRY integer	Backint エージェントが、失敗した Cloud Storage への読み取りと書き込みを再試行する上限回数を定義します。デフォルトは 5 で、これが推奨値です。
#PARALLEL_FACTOR integer	並列アップロードを有効にして、並列アップロードの最大数を設定する省略可のパラメータ。値を「1」に設定すると、並列アップロードが無効になります。デフォルト値は 1 です。 次の場合は、並列アップロードを有効にしないでください。 ターゲット バケットが保持ポリシーを使用している。 #ENCRYPTION_KEY または #KMS_KEY_NAME が指定されている。
#PARALLEL_PART_SIZE_MB integer	高度な調整パラメータ。 並行してアップロードする各部分のサイズ（MB）を設定します。デフォルトは 128 MB です。 カスタマーケアから指示されない限り、この設定を変更しないでください。デフォルトの設定を変更する必要はありません。
#RATE_LIMIT_MB integer	バックアップまたは復元時の操作における Compute Engine への送信帯域幅の上限（MB）を設定する省略可のパラメータ。デフォルトでは、Google Cloud は Backint エージェントのネットワーク帯域幅を制限しません。このパラメータを設定すると、スループットは状況に応じて変化しますが、指定した上限を超えることはありません。
#SERVICE_ACCOUNT path/to/key/file	Compute Engine のデフォルト認証が使用されていない場合に、JSON エンコードされた Google Cloud サービス アカウント キーへの完全修飾パスを指定するオプションのパラメータ。#SERVICE_ACCOUNT を指定すると、Backint エージェントは、Cloud Storage サービスでの認証時にキーを使用するようになります。Compute Engine のデフォルト認証を使用することをおすすめします。
#THREADS integer	高度な調整パラメータ。 ワーカー スレッド数を設定します。デフォルトはマシン内のプロセッサ数です。 カスタマーケアから指示されない限り、この設定を変更しないでください。デフォルトの設定を変更する必要はありません。
#READ_IDLE_TIMEOUT integer	高度な調整パラメータ。 Backint エージェントがバックアップ ファイルを開くまで待機する最大時間をミリ秒単位で設定します。デフォルト値は 1,000 です。 カスタマーケアから指示されない限り、この設定を変更しないでください。デフォルトの設定を変更する必要はありません。
#HTTP_READ_TIMEOUT integer	高度な調整パラメータ。 Cloud Storage API リクエストからのレスポンスを読み取る場合のタイムアウトをミリ秒単位で設定します。デフォルトは -1 で、タイムアウトしません。 カスタマーケアから指示されない限り、この設定を変更しないでください。デフォルトの設定を変更する必要はありません。

Backint エージェントのロギング

SAP HANA では backup.log にログが保存されますが、Backint エージェントは、それに加えて、オペレーション イベントと通信エラーイベントを /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs の logs サブディレクトリにあるログファイルに記録します。

ログファイルのサイズが 10 MB に達すると、Backint エージェントはログファイルをローテーションします。

必要であれば、/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties で Backint エージェントのロギング構成を編集できます。

Backint エージェントは Cloud Logging もサポートしています。Cloud Logging を有効にするには、Cloud Storage Backint agent for SAP HANA インストール ガイドをご覧ください。

SAP HANA HA デプロイで Backint エージェントを使用する

SAP HANA 高可用性クラスタでは、クラスタ内の各ノードに Backint エージェントをインストールする必要があります。

HA クラスタ内の SAP HANA インスタンスごとに、同じ Cloud Storage バケットの仕様で同じ Backint エージェント構成を使用します。同じオペレーションの仕様を使用できます。これは、通常のオペレーションでは、HA 構成内のアクティブな SAP HANA インスタンスのみがバックアップを Cloud Storage に書き込むためです。セカンダリ システムはレプリケーション モードです。これは、データ、ログ、カタログのバックアップに対して該当します。

さらに、Pacemaker などのアプリケーション クラスタリング ソフトウェアは、スプリット ブレインのシナリオを回避します。これは、クラスタ内の複数の SAP HANA システムが、複数のシステムをプライマリ インスタンスと見なすことです。

ただし、メンテナンス動作中にクラスタリングが無効になると、スタンバイのデータベースがレプリケーションから削除されてオンラインに戻った場合に、プライマリ データベースでのみバックアップがトリガーされるようにする必要があります。

Backint エージェントは、どの SAP HANA システムが現在アクティブのシステムかを認識しておらず、スケジューリングやトリガーのメカニズムがないため、SAP ABAP transaction DB13 のような SAP メカニズムを使用して、スケジューリングとバックアップ トリガーを管理する必要があります。

SAP ABAP アプリケーションは、仮想 IP 経由で HA クラスタに接続するため、トリガーは常にアクティブな SAP HANA インスタンスにルーティングされます。

バックアップ トリガーが各サーバーでローカルに定義されており（たとえば、ローカル オペレーティング システムのスクリプトとして）、プライマリ システムとセカンダリ システムの両方が、両方ともアクティブ システムであるとみなした場合は、両システムともストレージ バケットにバックアップの書き込みを試みる可能性があります。

SAP HANA DR デプロイで Backint エージェントを使用する

障害復旧構成（非同期の SAP HANA システム レプリケーションを使用して、別の Google Cloud リージョン内にある SAP HANA のリカバリ インスタンスが同期されている）では、プライマリ SAP HANA システムが使用するリカバリ インスタンス用に、別のバケットを指定します。

通常、DR システムはレプリケーション モードのため、バックアップ自体を実行できませんが、定期的な障害復旧テスト中は、リカバリ インスタンスがオンラインになり、バックアップをトリガーすることがあります。そうなった場合で、復旧システムが別のバケットを使用していない場合は、バックアップによりプライマリ データベースのデータが上書きされる可能性があります。

実際の障害の場合は、バックアップから DR リージョンへの復旧が必要となるため、Backint エージェントの構成を更新して、プライマリ HA システムが使用するマルチリージョン バケットを参照できます。

SAP HANA スケールアウト システムで Backint エージェントを使用する

SAP HANA スケールアウト システムでは、システムの各ノードに Backint エージェントをインストールする必要があります。

parameters.txt 構成ファイルの管理を簡素化するために、Backint エージェントのサービス アカウント キーを使用している場合は、これらのファイルを共有 NFS ディレクトリに配置できます。