Google Cloud の SAP 用エージェント運用ガイド

このガイドでは、Compute Engine VM インスタンスと Bare Metal Solution サーバーで Google Cloud の SAP 用エージェント バージョン 3.2（最新）を実行するにあたり、運用上留意する点と手順について説明します。

エージェントのライフサイクルを理解する

Google Cloud の SAP 用エージェントの運用管理を行うには、エージェントの機能を把握しておくと便利です。一般的な仕組みは次のとおりです。

SAP システムをホストする各 Compute Engine VM インスタンスまたは Bare Metal Solution サーバーに、Google Cloud の SAP 用エージェントをインストールする必要があります。エージェントは Linux サービスまたは Windows サービスとして実行されます。
Compute Engine VM インスタンスで、エージェントは Monitoring と Compute Engine API のモニタリングデータを結合します。
Bare Metal Solution サーバーで SAP Host Agent の指標のみを収集する場合、エージェントは Google Cloud APIs にアクセスしません。
SAP Host Agent は、HTTP を介して Google Cloud の SAP 用エージェントをポーリングし、キャッシュデータの有無を確認します。SAP Host Agent の指標を集約して報告し、SAP NetWeaver データベースに保存します。
SAP のトランザクション ST06 または saposcol コマンドラインインターフェースに、SAP Host Agent の指標が集計されて表示されます。
Google Cloud の SAP 用エージェントから SAP Host Agent の指標を表示するには、ターミナルウィンドウでコマンドを実行します。

エージェントが実行されていることを確認する

エージェントをインストールした後、またはエージェントを再起動した後に、エージェントが期待どおりに動作していることを確認します。

エージェントが実行されているかどうかを確認するには、次の操作を行います。

Linux

Bare Metal Solution サーバーまたは VM インスタンスとの SSH 接続を確立します。

次のコマンドを実行します。

systemctl status google-cloud-sap-agent

エージェントが正常に機能している場合、出力には active (running) が含まれます。次に例を示します。

google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Windows

RDP を使用して VM インスタンスに接続します。
管理者として PowerShell から次のコマンドを実行します。
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
エージェントが実行されている場合、ステータスは Running になります。

Google Cloud の SAP 用エージェントが実行されていない場合は、エージェントを再起動します。

エージェントのバージョンを確認する

Google Cloud の SAP 用エージェントをインストールまたは再起動した後で、エージェントのバージョンを確認できます。

エージェントのバージョンを確認する手順は次のとおりです。

Linux

RHEL の場合、次の操作を行います。

SSH を使用してホストマシンに接続します。
次のコマンドを実行します。
```
yum info google-cloud-sap-agent
```

SLES の場合、次の操作を行います。

SSH を使用してホストマシンに接続します。
次のコマンドを実行します。
```
zypper info google-cloud-sap-agent
```

Windows

RDP を使用して、ホストマシンに接続します。
管理者として PowerShell から次のコマンドを実行します。
```
googet installed google-cloud-sap-agent
```

利用可能なエージェントのバージョンを一覧表示する

Google Cloud の SAP 用エージェントの利用可能なバージョンをすべて表示するには:

RHEL

ホストとの SSH 接続を確立します。

次のコマンドを実行します。

sudo yum list --showduplicates google-cloud-sap-agent

SLES

ホストとの SSH 接続を確立します。

次のコマンドを実行します。

sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent

SAP Host Agent が指標を受信していることを確認する

Google Cloud の SAP 用エージェントによってインフラストラクチャの指標が収集され、SAP Host Agent に正しく送信されていることを確認するには、次の操作を行います。

SAP システムで、トランザクションとして「ST06」を入力します。
概要ウィンドウで可用性と以下のフィールドの内容を確認し、SAP と Google モニタリングインフラストラクチャのエンドツーエンドの設定が正しいか調べます。
- クラウドプロバイダ: Google Cloud Platform
- Enhanced Monitoring Access: TRUE
- Enhanced Monitoring Details: ACTIVE

SAP Host Agent の指標を表示する

Google Cloud の SAP 用エージェントの構成をインストールまたは更新した後、収集対象の SAP Host Agent の指標を表示できます。

Google Cloud の SAP 用エージェントによって収集された SAP Host Agent の指標を表示する手順は次のとおりです。

Linux

Bare Metal Solution サーバーのホスト VM インスタンスとの SSH 接続を確立します。

次のコマンドを実行します。

curl http://localhost:18181

指標が利用可能な場合は、システムに関する情報を含む XML 出力が表示されます。次に例を示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

RDP を使用して VM インスタンスに接続します。

管理者として PowerShell から次のコマンドを実行します。

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

指標が利用可能な場合、システムに関する情報を含む XML 出力が表示されます。例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

その他の指標を表示する

Process Monitoring 指標または SAP HANA モニタリング指標を収集するように Google Cloud の SAP 用エージェントの構成を更新した後、エージェントが想定どおりに指標を収集していることを確認するため、これらの指標を表示することをおすすめします。

Google Cloud の SAP 用エージェントによって収集された指標と情報は、次の手順で Cloud Monitoring で表示できます。

Google Cloud コンソールで、Monitoring の [Metrics Explorer] ページに移動します。

Metrics Explorer に移動
[CONFIGURATION] タブを選択します。
[指標を選択] メニューを開きます。
[リソース] メニューで、[VM instance] を選択します。
[指標カテゴリ] メニューで、[sap] を選択します。
[指標] メニューで、metric: workload.googleapis.com/sap/service/active またはグラフ化する新しい指標を選択します。
[適用] をクリックします。

時系列指標の値を含むグラフが表示されます。

Backint 機能を検証する

エージェントの Backint 機能を有効にしたら、バックアップを作成して復元することで、エージェントを検証する必要があります。

手順については、バックアップと復元を検証するをご覧ください。

エージェントを再起動する

Google Cloud の SAP 用エージェントが停止するか、構成を更新した場合は、エージェントを再起動します。

ご使用のオペレーティングシステムに応じて、次の操作を行います。

Linux

ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

次のコマンドを実行します。

sudo systemctl restart google-cloud-sap-agent

Windows

ホスト VM インスタンスと RDP 接続を確立します。
管理者として PowerShell から次のコマンドを実行します。
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

他の Google Cloud エージェントから Google Cloud の SAP 用エージェントにアップグレードする

Google Cloud の SAP 用エージェントは他の Google Cloud エージェントの後継です。以降のセクションでは、これらのエージェントから Google Cloud の SAP 用エージェントバージョン 3.2（最新）にアップグレードする方法について説明します。

Google Cloud の SAP 用エージェントをインストールして構成する手順については、Google Cloud の SAP 用エージェントのインストールと構成のガイドをご覧ください。

SAP HANA 用 Cloud Storage Backint エージェントからのアップグレード

SAP HANA 用 Cloud Storage Backint エージェントからバージョン 3.2（最新）にアップグレードするには、次の操作を行います。

進行中のデータバックアップや、アップグレードと重複する期間にスケジュールされているデータバックアップがないことを確認します。
SAP HANA パラメータの enable_auto_log_backup パラメータを no に設定して、ログの自動バックアップを無効にします。手順については、SAP HANA ドキュメントの Enable and Disable Automatic Log Backup をご覧ください。
Google Cloud の SAP 用エージェントをインストールします。手順については、シナリオに該当するインストールガイドをご覧ください。
Google Cloud の SAP 用エージェントの Backint 機能を有効にします。手順については、Backint ベースのバックアップと復元を構成するをご覧ください。

Google Cloud の SAP 用エージェントの Backint 機能を有効にすると、ホスト上の Backint エージェントが自動的に検出され、ホストマシンで無効になります。
既存の Backint 構成テキストファイルの JSON バージョンを作成するには、テキストファイルごとに次のコマンドを実行します。
```
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
```
PATH_TO_PARAMETERS_FILE は、PARAMETERS.txt ファイルへのパスで置き換えます。

Google Cloud の SAP 用エージェントにアクセスが許可されている限り、JSON ファイルはファイルシステム内のテキストファイルと同じ場所に作成されます。Google Cloud の SAP 用エージェントは、テキストファイルで指定された Backint 関連のパラメータを解釈できますが、構成の更新には JSON ファイルを使用することをおすすめします。
SAP HANA パラメータの enable_auto_log_backup パラメータを yes に設定して、ログの自動バックアップを有効にします。手順については、SAP HANA ドキュメントの Enable and Disable Automatic Log Backup をご覧ください。
バックアップと復元を検証します。

このアップグレードを行うと、次のようになります。

バックアップと参照のため、Backint エージェントの backint-gcs ディレクトリにあるすべてのインストールファイルが backint-gcs-old-TIMESTAMP/ にコピーされます。これらは、Backint エージェントに戻す場合に必要になります。
この backint-gcs フォルダをクリーンアップして、構成ファイル（parameters.json）や Backint 構成ファイル（PARAMETERS.txt）など、Google Cloud の SAP 用エージェントの実行に必要なファイルのみを残します。

Backint エージェントと Google Cloud の SAP 用エージェント間の構成パラメータのマッピングについては、次のセクションを開いてください。

構成パラメータのマッピング

Backint エージェントのパラメータ名	Google Cloud の SAP 用エージェントのパラメータ名
`BUCKET`	`bucket`
`DISABLE_COMPRESSION`	`compress`
`ENCRYPTION_KEY`	`encryption_key`
`KMS_KEY_NAME`	`kms_key`
`MAX_GCS_RETRY`	`retries`
`PARALLEL_FACTOR`	`parallel_streams`
`PARALLEL_PART_SIZE`	これは、Google Cloud の SAP 用エージェントでは使用できません。
`RATE_LIMIT_MB`	`rate_limit_mb`
`SERVICE_ACCOUNT`	`service_account_key`
`THREADS`	`thread`
`READ_IDLE_TIMEOUT`	`file_read_timeout_ms`
`CHUNK_SIZE_MB`	`buffer_size_mb`
`HTTP_READ_TIMEOUT`	これは、Google Cloud の SAP 用エージェントでは使用できません。

SAP HANA 用モニタリングエージェントからのアップグレード

Google Cloud の SAP 用エージェントのバージョン 3.2（最新）をインストールすると、インストール中に SAP HANA 用モニタリングエージェントのバージョンが自動的に検出されて無効になり、ホストマシンから削除されます。

このエージェントが検出されると、インストール中に構成が Google Cloud の SAP 用エージェントに移行されます。バックアップと参照のため、SAP HANA 用モニタリングエージェントの構成が次のファイルにコピーされます。

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

SSL 対応インスタンスのアップグレード

SAP HANA インスタンスとの通信に SSL 証明書を使用するように SAP HANA 用モニタリングエージェントを構成している場合は、Google Cloud の SAP 用エージェントをインストールするときに、SSL 構成を除くすべての SAP HANA モニタリング構成が Google Cloud の SAP 用エージェントに移行されます。この場合、Google Cloud の SAP 用エージェントを使用して SAP HANA インスタンスをモニタリングするには、次の手順を完了する必要があります。

ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。
Google Cloud の SAP 用エージェントの構成ファイルを開きます。
```
/etc/google-cloud-sap-agent/configuration.json
```
hana_monitoring_configuration セクションで、enabled パラメータを true に設定します。
hana_monitoring_configuration.hana_instances セクションで、セキュア通信に TLS / SSL プロトコルを使用する SAP HANA インスタンスごとに次の操作を行います。
1. enable_ssl パラメータを指定して、値を true に設定します。
2. host_name_in_certificate パラメータを指定し、値として TLS / SSL 証明書で指定されている SAP HANA ホスト名を設定します。
3. tls_root_ca_file パラメータを指定し、値として TLS / SSL 証明書が保存されているパスを設定します。
構成ファイルを保存します。
エージェントを再起動して、新しい設定を有効にします。
```
sudo systemctl restart google-cloud-sap-agent
```
エージェントが SAP HANA モニタリング指標を収集していることを確認します。手順については、その他の指標を表示するをご覧ください。
SAP HANA 用モニタリングエージェントをアンインストールします。

このアップグレード後に SAP HANA インスタンスとの接続で問題が発生した場合は、Logging でエージェントのログを表示し、トラブルシューティングガイドを使用して問題を解決できます。

SAP NetWeaver 用モニタリングエージェントからのアップグレード

Google Cloud の SAP 用エージェントのバージョン 3.2（最新）をインストールすると、SAP NetWeaver 用モニタリングエージェントのバージョンが自動的に検出されます。

このエージェントが検出されると、インストール中に構成が Google Cloud の SAP 用エージェントに移行されます。

Google Cloud の SAP 用エージェントを更新する

Google Cloud の SAP 用エージェントの最新バージョンを使用するには、定期的に更新を確認し、エージェントを更新する必要があります。

更新を確認する

ご使用のオペレーティングシステムに応じて、次の操作を行います。

RHEL

インスタンスと SSH 接続を確立します。

次のコマンドを実行します。

sudo yum check-update google-cloud-sap-agent

SLES

インスタンスと SSH 接続を確立します。

次のコマンドを実行します。

sudo zypper list-updates -r google-cloud-sap-agent

Windows

ホスト VM インスタンスと RDP 接続を確立します。
管理者として PowerShell から次のコマンドを実行します。
```
googet latest google-cloud-sap-agent
```

更新をインストールする

ご使用のオペレーティングシステムに応じて、次の操作を行います。

RHEL

インスタンスと SSH 接続を確立します。
エージェントインスタンスを更新します。
- （推奨）エージェントをバージョン 3.2（最新）に更新するには:
```
sudo yum --nogpgcheck update google-cloud-sap-agent
```
- エージェントを特定のバージョンに更新するには、次のコマンドを実行します。
```
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
```
  VERSION_NUMBER は、インストールするエージェントのバージョン番号（3.1-606637668 など）に置き換えます。インストール可能なエージェントのバージョンについては、使用可能なすべてのエージェントバージョンを一覧表示するをご覧ください。

SLES

インスタンスと SSH 接続を確立します。
エージェントインスタンスを更新します。
- （推奨）エージェントをバージョン 3.2（最新）に更新するには:
```
sudo zypper --no-gpg-checks update google-cloud-sap-agent
```
- エージェントを特定のバージョンに更新するには、次のコマンドを実行します。
```
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
```
  VERSION_NUMBER は、インストールするエージェントのバージョン番号（3.1-606637668 など）に置き換えます。インストール可能なエージェントのバージョンについては、使用可能なすべてのエージェントバージョンを一覧表示するをご覧ください。

Windows

ホスト VM インスタンスと RDP 接続を確立します。
エージェントをバージョン 3.2（最新）に更新するには、管理者として PowerShell から次のコマンドを実行します。
```
googet install google-cloud-sap-agent
```

他の Google Cloud エージェントを使用するようにロールバックする

このセクションでは、Google Cloud の SAP 用エージェントのバージョン 3.2（最新）から前のエージェントにロールバックする方法について説明します。

Backint エージェントを使用するようにロールバックする

Backint エージェントを使用するようにロールバックし、Google Cloud の SAP 用エージェントの Backint 機能の使用を停止する場合は、次の操作を行います。

Google Cloud の SAP 用エージェントの Backint 機能に関連するすべてのファイルを削除します。
```
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
SID は、SAP システムの SID に置き換えます。
Google Cloud の SAP 用エージェントを使用するようにアップグレードしたときにバックアップとして保存されていた Backint エージェントのファイルを backint-gcs ディレクトリにコピーして復元します。
```
cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
次のように置き換えます。
- SID: SAP システムの SID
- TIMESTAMP: Backint エージェントから Google Cloud の SAP 用エージェントにアップグレードしたときに作成されたフォルダ名のタイムスタンプ値
SAP HANA Studio または SAP HANA Cockpit を使用して global.ini ファイルを編集し、.txt 構成ファイルのパスを更新します。.txt ファイルのパスを指定する必要があるパラメータについては、Backint 機能用に SAP HANA を構成するをご覧ください。
global.ini ファイルに加えた変更を保存します。

SAP HANA 用モニタリングエージェントを使用するようにロールバックする

SAP HANA 用モニタリングエージェントを使用するようにロールバックし、Google Cloud の SAP 用エージェントの SAP HANA モニタリング機能を停止する場合は、次の操作を行います。

RHEL

ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。
重複した指標が収集されないようにするには、Google Cloud の SAP 用エージェントによる SAP HANA モニタリング指標の収集を無効にします。
1. Google Cloud の SAP 用エージェントの構成ファイルを開きます。
```
/etc/google-cloud-sap-agent/configuration.json
```
2. hana_monitoring_configuration セクションで、enabled パラメータを false に設定します。
3. 構成ファイルを保存します。
4. エージェントを再起動して、新しい設定を有効にします。
```
sudo systemctl restart google-cloud-sap-agent
```
次のファイルから SAP HANA 用モニタリングエージェントの構成をコピーします。
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
SAP HANA 用モニタリングエージェントバージョン 2 をインストールします。インストール手順については、SAP HANA 用モニタリングエージェント V2.0 のインストールおよび操作ガイドをご覧ください。
次の手順で、前の手順でコピーした SAP HANA 用のモニタリングエージェントの構成を貼り付けます。
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```
SAP HANA 用モニタリングエージェントを再起動します。
```
sudo systemctl start google-saphanamonitoring-agent
```

SLES

ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。
重複した指標が収集されないようにするには、Google Cloud の SAP 用エージェントによる SAP HANA モニタリング指標の収集を無効にします。
1. Google Cloud の SAP 用エージェントの構成ファイルを開きます。
```
/etc/google-cloud-sap-agent/configuration.json
```
2. hana_monitoring_configuration セクションで、enabled パラメータを false に設定します。
3. 構成ファイルを保存します。
4. エージェントを再起動して、新しい設定を有効にします。
```
sudo systemctl restart google-cloud-sap-agent
```
次のファイルから SAP HANA 用モニタリングエージェントの構成をコピーします。
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
SAP HANA 用モニタリングエージェントバージョン 2 をインストールします。インストール手順については、SAP HANA 用モニタリングエージェント V2.0 のインストールおよび操作ガイドをご覧ください。
次の手順で、前の手順でコピーした SAP HANA 用のモニタリングエージェントの構成を貼り付けます。
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```
SAP HANA 用モニタリングエージェントを再起動します。
```
sudo systemctl start google-saphanamonitoring-agent
```

エージェントをアンインストールする

ホストからエージェントをアンインストールまたは削除するには:

RHEL

ホストとの SSH 接続を確立します。
次のコマンドを実行します。
```
sudo yum remove google-cloud-sap-agent
```

SLES

ホストとの SSH 接続を確立します。

次のコマンドを実行します。

sudo zypper remove google-cloud-sap-agent

Windows

ホスト VM インスタンスと RDP 接続を確立します。
管理者として PowerShell から次のコマンドを実行します。
```
Remove-Service -Name 'google-cloud-sap-agent'
```

Cloud Logging でエージェントのログを表示する

デフォルトでは、Google Cloud の SAP 用エージェントのログは、VM インスタンスと Bare Metal Solution サーバーから Cloud Logging にリダイレクトされます。

Logging でエージェントのログを表示する手順は次のとおりです。

Google Cloud コンソールで、[ログエクスプローラ] ページに移動します。

[ログエクスプローラ] に移動
[クエリ] ペインに移動します。
[リソース] プルダウンメニューから [グローバル] を選択し、[適用] をクリックします。
クエリエディタで、「google-cloud-sap-agent」と入力します。
[クエリを実行] をクリックします。

すべての VM インスタンスや Bare Metal Solution サーバーで実行されているエージェントインスタンスによって生成されたログが表示されます。特定のマシンのログをフィルタするには、インターフェースで使用可能なフィルタを使用します。

指標の収集に関連するエージェントのログのデフォルトのリダイレクトを無効にできます。手順は次のとおりです。

ホスト VM インスタンスまたは Bare Metal Solution サーバーと SSH 接続を確立します。

次の構成ファイルを開きます。

/etc/google-cloud-sap-agent/configuration.json

log_to_cloud パラメータの値を false に更新します。
構成ファイルを保存します。
エージェントを再起動して、この変更を有効にします。

Google Cloud の SAP 用エージェントの Backint 機能に関連するログのデフォルトのリダイレクトを無効にするには、Backint 構成ファイルを編集し、log_to_cloud パラメータを false に設定します。

Google Cloud の SAP 用エージェント運用ガイド

エージェントのライフサイクルを理解する

エージェントが実行されていることを確認する

Linux

Windows

エージェントのバージョンを確認する

Linux

Windows

利用可能なエージェントのバージョンを一覧表示する

RHEL

SLES

SAP Host Agent が指標を受信していることを確認する

SAP Host Agent の指標を表示する

Linux

Windows

その他の指標を表示する

Backint 機能を検証する

エージェントを再起動する

Linux

Windows

他の Google Cloud エージェントから Google Cloud の SAP 用エージェントにアップグレードする

SAP HANA 用 Cloud Storage Backint エージェントからのアップグレード

構成パラメータのマッピング

SAP HANA 用モニタリング エージェントからのアップグレード

SSL 対応インスタンスのアップグレード

SAP NetWeaver 用モニタリング エージェントからのアップグレード

Google Cloud の SAP 用エージェントを更新する

更新を確認する

RHEL

SLES

Windows

更新をインストールする

RHEL

SLES

Windows

他の Google Cloud エージェントを使用するようにロールバックする

Backint エージェントを使用するようにロールバックする

SAP HANA 用モニタリング エージェントを使用するようにロールバックする

RHEL

SLES

エージェントをアンインストールする

RHEL

SLES

Windows

Cloud Logging でエージェントのログを表示する

SAP HANA 用モニタリングエージェントからのアップグレード

SAP NetWeaver 用モニタリングエージェントからのアップグレード

SAP HANA 用モニタリングエージェントを使用するようにロールバックする