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.2（最新）に切り替えることをおすすめします。アップグレード手順については、他の Google Cloud エージェントから Google Cloud の SAP 用エージェントにアップグレードするをご覧ください。

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

以下では、Cloud Storage Backint agent for SAP HANA（Backint エージェント）をインストールして構成する方法を説明します。

Backint エージェントの構成オプションについては、SAP HANA 用 Cloud Storage Backint エージェントの概要をご覧ください。

前提条件

Backint エージェントをインストールする前に、SAP HANA をインストールする必要があります。SAP HANA を Google Cloud にインストールする方法については、SAP HANA デプロイガイドをご覧ください。

Bare Metal Solution に SAP HANA をインストールする方法については、SAP HANA on Bare Metal Solution プランニングガイドをご覧ください。

ホスト VM がインターネットにアクセスできない場合は、Backint エージェントが Google Cloud APIs にアクセスできるように、限定公開の Google アクセスを構成する必要があります。限定公開の Google アクセスを構成する場合は、限定公開の Google アクセスの構成をご覧ください。

バックアップ用の Cloud Storage バケットの作成

Backint エージェントを構成する前に、バックアップを保持するための Cloud Storage バケットを作成する必要があります。

Cloud Storage バケットを作成するには、Google Cloud コンソールを使用します。

バケットのオプションについては、Cloud Storage バケットへのバックアップの保存をご覧ください。

Google Cloud コンソールで Cloud Storage ブラウザを開きます。

Cloud Storage ブラウザを開く
[バケットを作成] をクリックします。
バケットに名前を付け、[続行] をクリックします。
指示に沿ってバケットのオプションを選択します。

注: バケットの作成中に Google Cloud コンソールに表示される暗号化オプションは通常、バケット内の保存オブジェクトに適用されます。Backint エージェントには、バケットの暗号化オプションとは別に、バックアップのための追加の暗号化オプションが用意されています。
[作成] をクリックします。
バケットの権限を構成するには、[権限] タブをクリックします。バケットのオーナーには、デフォルトでバケットへの読み書きアクセス権があります。他のプリンシパルにバケットへのアクセスを許可することもできます。

SAP HANA のホストに Backint エージェントをインストールする

Backint エージェントは、SAP HANA データベースと同じ共有ファイルシステムにインストールされます。

SAP HANA スケールアウトデプロイで、SAP HANA システムの各ノードに Backint エージェントをインストールします。管理を簡素化するため、デプロイ内のすべてのノードからアクセス可能な共有の場所（/hana/shared など）に構成ファイルを保存することもできます。

SSH を使用して SAP HANA のホストに接続します。ホストが Compute Engine VM の場合は、[VM インスタンス] ページで、VM インスタンスの SSH ボタンをクリックするか、任意の SSH メソッドを使用します。
ユーザーを SAP HANA のシステム管理者に切り替えます。
```
sudo su - SID_LCadm
```
Backint エージェントをダウンロードしてインストールします。
```
curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
chmod +x install.sh
./install.sh
```
注: Backint エージェントの既存のインスタンスを新しいバージョンに更新する場合は、Backint エージェントを新しいバージョンに更新するの手順で操作してください。
install.sh スクリプトは次のアクションを実行します。
- /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs に Backint エージェントを JAR ファイルとしてインストールします。
- 互換性のあるバージョンの Java Runtime Environment をダウンロードします。
- Backint エージェントを呼び出す backint スクリプトを設定します。Cloud カスタマーケアから指示されない限り、backint スクリプトを変更しないでください。
- 完了すると、parameters.txt ファイルの更新と認証の設定を求めるメッセージが発行されます。詳細については、Backint エージェントと SAP HANA の構成をご覧ください。
次のいずれかのシナリオが該当する場合は、Backint エージェント用のサービスアカウントを作成する必要があります。
- Backint エージェントが、ホストの Compute Engine VM が使用するリソースとは別の権限セットを使用することを必要としている。
- SAP HANA が Bare Metal Solution で稼働している。
- SAP HANA が Google Cloud で稼働していない。
Backint エージェントのサービスアカウントを作成するには:
1. Google Cloud コンソールで、[サービスアカウント] ページに移動します。
  
  [サービスアカウント] ページに移動
2. Google Cloud プロジェクトを選択します。
3. [サービスアカウントを作成] をクリックします。
4. サービスアカウントの名前を指定します。必要であれば、説明も入力します。
5. [作成して続行] をクリックします。
6. [続行] をクリックして、権限のないサービスアカウントを作成します。
7. 必要に応じて、他のユーザーにサービスアカウントへのアクセス権を付与します。
8. [完了] をクリックします。
9. Google Cloud コンソールの [サービスアカウント] ページで、作成したサービスアカウントのメールアドレスをクリックします。
10. サービスアカウント名で [キー] タブをクリックします。
11. [鍵を追加] プルダウンメニューをクリックして [新しい鍵を作成] を選択し、サービスアカウントキーを作成します。
12. 鍵のタイプとして JSON を選択し、[作成] をクリックします。秘密鍵がパソコンに保存されます。
JSON キーファイルを SAP HANA ホストにアップロードします。
- SID_LCadm ユーザーがアクセスできるディレクトリ（/usr/sap/SID/home など）に .json ファイルを保存します。
- SID_LCadm ユーザーにファイルの読み取り権限があることを確認してください。
Cloud Storage バケットを更新して、バケットを使用する権限をサービスアカウントに付与します。
1. Cloud Storage ブラウザでバケット名をクリックします。
  
  Cloud Storage ブラウザを開く
2. [権限] タブをクリックします。
3. [プリンシパルを追加] をクリックします。
4. [新しいプリンシパル] フィールドに、サービスアカウントの完全なメールアドレスを入力します。例:
  
  backint-test@my-project.iam.gserviceaccount.com
5. [ロールを選択] プルダウンをクリックし、ストレージオブジェクト管理者を入力します。
6. [保存] をクリックします。

Backint エージェントと SAP HANA の構成

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

すべてのバックアップタイプ（データ、ログ、カタログ）に同じ単一構成を使用できます。または、バックアップタイプごとに別々の構成ファイルを作成して、バックアップタイプごとに異なる構成を使用することもできます。

SAP HANA で Backint エージェントの各構成ファイルのパスを指定するには、global.ini ファイルでパラメータを指定します。

parameters.txt ファイルでパラメータを指定して、Backint エージェントを構成します。ファイル名は必要に応じて変更できます。
1. 任意の方法で parameters.txt ファイルを編集します。このファイルは、次のディレクトリにインストールされます。
```
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
```
  parameters.txt ファイルの名前を変更し、データ、ログ、カタログのバックアップ用に別の構成ファイルを使用できます。
  
  構成パラメータの説明と、パフォーマンスに関する推奨事項については、Backint エージェントの構成オプションをご覧ください。
2. バックアップに使用する Cloud Storage バケットの名前を指定します。
```
#BUCKET bucket-name
```
3. Backint エージェント用のサービスアカウントと秘密鍵を作成した場合は、JSON キーファイルのパスを指定します。
```
#SERVICE_ACCOUNT /path/key-file-name.json
```
次の例は、有効な parameters.txt ファイルの内容を示しています。この例の # は構文の一部であり、その行がコメントであることを意味するわけではありません。
```
#BUCKET hana-backups
#DISABLE_COMPRESSION
#SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json
```
省略可: バックアップと復元で Backint エージェントがプロキシをバイパスするか使用するかに関する構成を行います。デフォルトでは、Backint エージェントは HTTP プロキシをバイパスします。

警告: プロキシ経由でバックアップをルーティングする場合、Cloud Storage との間でバックアップの送信または取得を行うときに、すべてのプロキシトラフィックのパフォーマンスと信頼性に悪影響が生じます。Google Cloud では、Backint エージェントが HTTP プロキシをバイパスすることを強くおすすめします。
インスタンスメタデータサーバーに対するクエリでは、常に HTTP プロキシサーバーをバイパスする必要があります。お使いのプロキシサーバーに応じて http または https のいずれかのプロキシパラメータを使用してください。

Backint エージェントのプロキシサーバー設定を指定するには、ファイル /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties を編集します。

たとえば、次の構成では HTTPS プロキシサーバーが指定されています。
```
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 エージェントとプロキシを組み合わせて使用する方法の詳細については、プロキシと Backint エージェントをご覧ください。

Backint エージェントを使用するように SAP HANA を構成します。

SAP HANA Studio または SAP HANA Cockpit を使用して、global.ini 構成ファイルの backup セクションの次のパラメータを表に示す値に設定します。変更を行った後、SAP HANA を再起動する必要はありません。

バックアップのタイプごとに異なる構成ファイルを使用する場合は、次の表に示すように異なる構成ファイルを指定します。それ以外の場合は、すべてのタイプに同じ構成ファイルを指定します。

パラメータ	値
`catalog_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt`
`catalog_backup_using_backint`	`true`
`data_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt`
`log_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt`
`log_backup_using_backint`	`true`

SAP HANA Studio を使用して、global.ini ファイル内の persistence セクションの basepath_catalogbackup と basepath_logbackup に同じ値を指定します。例:

Cloud Storage バケットにバックアップを作成し、そのバックアップから復元することによりインストールをテストします。
Backint エージェントの自動更新機能をサポートするには、SAP HANA VM から https://www.googleapis.com/ へのリモート HTTP リクエストを有効にします。
必要に応じて、Cloud Logging を有効にします。
- SAP HANA が Compute Engine VM で実行されている場合は、com.google.cloud.logging.LoggingHandler ハンドラを /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties ファイル内の com.google.cloud.partners.handlers プロパティに追加します。
- SAP HANA が Google Cloud の外部で実行されている場合は、Google Cloud CLI をインストールし、gcloud auth application-default login コマンドを使用してアプリケーションのデフォルトのログインを構成します。

Backint エージェントを新しいバージョンに更新する

Backint エージェントを本番環境で新しいバージョンに更新する前に、新しいバージョンを非本番環境で必ずテストしてください。Backint エージェントのバージョンの詳細については、そのバージョンのリリースノートをご覧ください。

Backint エージェントを新しいバージョンに更新するには:

進行中のデータバックアップや、更新と重複する期間にスケジュールされているデータバックアップがないことを確認します。
SAP HANA パラメータの enable_auto_log_backup パラメータを no に設定して、ログの自動バックアップを無効にします。手順については、SAP HANA ドキュメントの Enable and Disable Automatic Log Backup をご覧ください。
SAP HANA ホストから https://www.googleapis.com/ へのリモート HTTP リクエストを有効にします。
SAP HANA ホストで SID_LCadm として新しいバージョンをインストールします。
```
curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
chmod +x update.sh
./update.sh
```
update.sh スクリプトは次のアクションを実行します。
- 新しいバージョンの Backint エージェントを /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs にインストールします。
- backint スクリプトを更新して、新しい Backint エージェントバージョンを呼び出します。
- VERSION.txt のバージョン番号を更新します。
- update.sh スクリプトを /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs にローカルに保存します。
- 終了時にメッセージを発行します。
更新プロセスでは、既存の parameters.txt ファイルの変更や置き換えは行われません。新しいバージョンで導入された新しいオプションを使用するには、対応するパラメータを既存の parameters.txt ファイルに追加する必要があります。

更新プロセスでは、以前のバージョンの Backint エージェントが /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs ディレクトリに残り、必要に応じて古いバージョンにフォールバックできます。
SAP HANA パラメータの enable_auto_log_backup パラメータを yes に設定して、ログの自動バックアップを有効にします。手順については、SAP HANA ドキュメントの Enable and Disable Automatic Log Backup をご覧ください。
システムをモニタリングし、バックアップが成功していることを確認します。

以前のバージョンへのフォールバック

新しいバージョンの Backint エージェントで問題が発生し、Google Cloud サポートまたは SAP サポートから以前のバージョンにフォールバックするようにアドバイスされた場合、backint ファイルを編集することでフォールバックできます。

parameters.txt ファイルで新しいバージョンに追加したパラメータを削除する必要はありません。以前のバージョンの Backint エージェントは、新しいバージョンのパラメータを無視します。

以前のバージョンにフォールバックするには:

SID_LCadm として、編集用に backint スクリプトを開きます。例:
```
vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint
```
Backint エージェントの JAR ファイルの名前を、以前のバージョンの JAR ファイルの名前に変更します。

たとえば、バージョン 1.0.6 からバージョン 1.0.4 にフォールバックする場合:
```
-jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar
```
これを次のように変更します。
```
-jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar
```
VERSION.txt ファイルを編集用に開き、前のバージョン番号を指定します。これは、更新メカニズムで実行中のバージョンを認識できるようにするために必要です。
```
vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt
```
バックアップをトリガーして Backint エージェントをテストします。

トラブルシューティング

SAP HANA の Backint エージェントに関する問題のトラブルシューティングについては、SAP HANA の Backint エージェントのトラブルシューティングをご覧ください。

Backint エージェントのサポートを利用する

SAP HANA のモニタリングエージェントの問題を解決するには、必要な診断情報を収集し、Cloud カスタマーケアまでお問い合わせください。詳細については、SAP HANA の Backint エージェントの診断情報をご覧ください。