Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SAP ワークロード用エージェントを設定する

SAP ソリューション用ワークロードマネージャーは、Google Cloudの SAP 用エージェントを使用して、SAP システム構成を評価するためのメタデータを検出して収集します。SAP NetWeaver、SAP HANA、SAP ASE、SAP MaxDB など、 Google Cloudで実行されている SAP システムのサポートとモニタリングを行うには、SAP システムを実行するすべての VM インスタンスに SAP 用エージェントと SAP ホストエージェントが必要です。

始める前に

Google Cloudの SAP 用エージェントをインストールして構成する前に、次の前提条件を満たしていることを確認する必要があります。

1 つ以上のコンピューティングインスタンスに SAP ワークロードをデプロイしている。
ワークロードマネージャーの評価を作成できるサポート対象リージョンを確認した。
管理者が、ワークロードマネージャー評価の作成と実行に必要な IAM ロールを付与している。
エージェントに必要な IAM ロールが付与されている。
Cloud APIs へのアクセスを有効にしている。

エージェントに必要な IAM ロール

Agent for SAP は、認証と Google Cloud リソースへのアクセスに、コンピューティングインスタンスに関連付けられたサービスアカウントを使用します。

セキュリティを強化するため、Compute Engine のデフォルトのサービスアカウントを使用するのではなく、単一目的のサービスアカウントを使用することをおすすめします。

SAP 用エージェントがGoogle Cloud で認証を行い、 Google Cloud リソースにアクセスできるように、サービスアカウントに必要な権限が付与されていることを確認するには、プロジェクトに対する次の IAM ロールをサービスアカウントに付与するよう管理者に依頼してください。

コンピューティングインスタンスから指標を収集する: コンピューティング閲覧者（roles/compute.viewer）
Workload Manager データウェアハウスにデータを書き込む: Workload Manager Insights ライター（roles/workloadmanager.insightWriter）
エージェントログを Cloud Logging に送信する: ログ書き込み（roles/logging.logWriter）
Secret Manager を使用して SAP ワークロードに接続するパスワードを保存している場合: Secret Manager のシークレットアクセサー（roles/secretmanager.secretAccessor）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

管理者は、カスタムロールや他の事前定義ロールを使用して、必要な権限をサービスアカウントに付与することもできます。

Cloud APIs へのアクセスを有効にする

Compute Engine では、すべての Cloud APIs にすべてのアクセススコープを使用できるようにインスタンスを構成することをおすすめします。 Google Cloudリソースへのアクセスを制御するには、インスタンスサービスアカウントの IAM 権限のみを使用します。詳細については、ユーザー管理のサービスアカウントを使用する VM を作成するをご覧ください。

Cloud APIs へのアクセスを制限する場合、SAP 用エージェントには、ホストコンピューティングインスタンスで次の最小 Cloud APIs アクセススコープが必要です。

https://www.googleapis.com/auth/cloud-platform

詳細については、スコープのベストプラクティスをご覧ください。

外部 IP アドレスを持たないコンピューティングインスタンスで SAP アプリケーションを実行している場合は、インスタンスのサブネットでプライベート Google アクセスを有効にして、コンピューティングワークロード用エージェントが Google API とサービスにアクセスできるようにする必要があります。プライベート Google アクセスを有効にする方法については、プライベート Google アクセスを構成するをご覧ください。

パッケージマネージャーを使用してエージェントをインストールして構成する

このセクションでは、パッケージマネージャーを使用して、コンピューティングインスタンスに Agent for SAP をインストールし、SAP ワークロードに接続するように構成する方法について説明します。

VM フリートにエージェントをインストールして構成する場合は、代わりに VM Extension Manager ポリシーを使用できます。詳細については、VM Extension Manager を使用して VM フリートにエージェントをインストールして管理するをご覧ください。

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

まだインストールしていない場合は、SAP ワークロードを実行するすべてのコンピューティングインスタンスに Google Cloudの SAP 用エージェントをインストールします。

Compute Engine インスタンスにエージェントをインストールするには、次の操作を行います。

コンピューティングインスタンスとの SSH 接続を確立します。

ターミナルでオペレーティングシステムに固有のコマンドを実行して、エージェントをインストールします。

（推奨）エージェントのバージョン 3.14（最新）をインストールするには:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

特定のバージョンのエージェントをインストールするには:

RHEL

sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES15

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

SLES 12

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

VERSION_NUMBER は、インストールするエージェントのバージョン番号（3.1-606637668 など）に置き換えます。インストール可能なエージェントバージョンについては、使用可能なすべてのエージェントバージョンを一覧取得するをご覧ください。

エージェントを特定のバージョンにダウングレードする方法については、 Google Cloudの SAP 用エージェントをダウングレードするをご覧ください。

ワークロードマネージャー評価指標の収集を構成する

SAP 用エージェントをインストールしたら、ワークロードマネージャー評価指標の収集用にエージェントを構成する必要があります。

Google Cloudの SAP 用エージェントを構成するには、次の操作を行います。

エージェントがワークロードマネージャー評価指標を収集できるようにするには:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
```
省略可: ワークロードマネージャーで SAP HANA Insights と SAP HANA セキュリティのベストプラクティスの指標の収集を有効にするには、エージェントの構成ファイルの collect_workload_validation_metrics の後に workload_validation_db_metrics_config セクションを追加し、次のパラメータを指定します。
- hana_db_user: SAP HANA インスタンスのクエリに使用するユーザーアカウントを指定します。
- hostname: SAP HANA インスタンスをホストするマシン（ローカルまたはリモート）の識別子を指定します。
- port: SAP HANA インスタンスがクエリを受け付けるポートを指定します。
- hana_db_password_secret_name: ユーザーアカウントのパスワードを格納する Secret Manager に Secret の名前を指定します。
  
  Secret の代わりに、hdbuserstore_key 構成パラメータを使用できます。
- hdbuserstore_key: hana_db_user に指定したユーザーを認証する hdbuserstore 鍵を指定します。
  
  hdbuserstore_key を指定すると、hostname パラメータと port パラメータの指定をスキップします。
これらのパラメータの詳細については、構成パラメータをご覧ください。

次の例は、Compute Engine インスタンス上で実行されているGoogle Cloudの SAP 用エージェントの完全な構成ファイルです。ここでは、ワークロードマネージャー評価指標の収集が有効になっています。

SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、hdbuserstore_key 構成パラメータは hana_db_password パラメータよりも優先され、これは hana_db_password_secret_name パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。
- 次の例では、SAP HANA 認証にセキュアユーザーストア（hdbuserstore）キーを使用します。
```
{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
```
- 次の例では、SAP HANA 認証にユーザー名と Secret Manager シークレットを使用します。
```
{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
```
- 次の例では、SAP HANA 認証にユーザー名とパスワードを使用します。この方法ではなく、SAP HANA 認証には Secret Manager シークレットまたはセキュアユーザーストア（hdbuserstore）キーを使用することをおすすめします。
```
{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
```
エージェントを再起動して、新しい設定を有効にします。

注: バージョン 3.7 以降では、エージェントの構成に対する変更は 30 秒以内に自動的に適用されるため、エージェントを再起動する必要はありません。
```
sudo systemctl restart google-cloud-sap-agent
```
エージェントが正常に再起動すると、エージェントはワークロードマネージャー評価指標をワークロードマネージャーに送信し始めます。

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

このセクションでは、VM Extension Manager を使用して VM のフリートに Agent for SAP をインストールして管理する方法について説明します。

VM Extension Manager ポリシーを使用すると、次のようなタスクを実行できます。

フリート全体のインストール: 次の場所に SAP 用エージェントをインストールします。
- Google Cloud プロジェクト内のすべての VM、またはラベルで識別される VM のサブセット。
- ゾーン内のすべての VM、またはラベルで識別される VM のサブセット。
構成管理: ポリシーで管理されているすべての VM のエージェントにカスタム構成を適用します。

VM Extension Manager を設定する

VM Extension Manager を設定するには、次の操作を行います。

VM Extension Manager のドキュメントで、始める前にのセクションを確認します。
VM Extension Manager ポリシーの作成と管理に必要な IAM ロールを設定します。詳しくは以下をご覧ください。

VM フリートにエージェントをインストールして構成する

VM Extension Manager ポリシーを使用して VM フリートに最新バージョンの Agent for SAP をインストールするには、該当するセクションをご覧ください。

Google Cloud プロジェクト内の VM にエージェントをインストールして構成する
特定のゾーン内の VM にエージェントをインストールして構成する

Google Cloud プロジェクト内の VM にエージェントをインストールして構成する

VM Extension Manager ポリシーを使用して、 Google Cloud プロジェクト内のすべての VM、またはラベルで識別される VM のサブセットにエージェントをインストールするには、次の操作を行います。

ターミナルまたは Cloud Shell で、gcloud beta compute global-vm-extension-policies create コマンドを実行します。
```
gcloud beta compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]
```
次のように置き換えます。
- POLICY_NAME: VM 拡張機能ポリシーの一意の名前。
- PROJECT_ID: ポリシーを作成するGoogle Cloud プロジェクトのプロジェクト ID
- ROLLOUT_PLAN_OPTION: グローバルポリシーに適用するロールアウトオプション。サポートされている値は slow_rollout（推奨）と fast_rollout です。
- または、--rollout-custom-plan オプションを指定して、カスタムロールアウトプランを使用することもできます。詳細については、ロールアウトプランについてをご覧ください。
- --rollout-predefined-plan または --rollout-custom-plan のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- DESCRIPTION: ポリシーの説明（省略可）。
- CONFIG_FILE_PATH: Agent for SAP の構成を含む JSON ファイルのローカルパス。
- あるいは、構成をインライン文字列として指定する場合は、--config-from-file ではなく --config フラグを使用します。例: --config=google-cloud-sap-extension="CONFIG"
- --config-from-file または --config のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- エージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
注: SAP 用エージェントがすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーで設定した内容で既存のエージェントのバージョンと構成がオーバーライドされます。

エージェントの既存の構成は、各 VM の /etc/google-cloud-sap-agent/ ディレクトリにある BAK ファイルに書き込まれます。
- KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りのリスト。
- ポリシーの対象となる VM には、指定されたすべてのラベルが設定されている必要があります。
- --inclusion-labels を複数回指定すると、ポリシーは、指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーはプロジェクト内のすべての VM をターゲットにします。
- PRIORITY: ポリシーの優先度を定義する 0～65535 の整数。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。詳細については、ポリシーの優先度と競合の解決をご覧ください。

特定のゾーン内の VM のフリートにエージェントをインストールして構成する

VM Extension Manager ポリシーを使用して、特定のゾーン内の VM フリートに最新バージョンの Agent for SAP をインストールするには、次の操作を行います。

コンソール

Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

[VM 拡張機能ポリシー] に移動
[拡張機能ポリシーを作成] をクリックします。
[名前] フィールドに、ポリシーの名前を入力します。
省略可: [説明] フィールドに、ポリシーの説明を入力します。
[優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。
[リージョン] リストと [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
[拡張機能] セクションで [拡張機能を追加] をクリックし、次の操作を行います。
1. [拡張機能] リストから、[Google Cloud's Extension for Compute Workloads] を選択します。
2. [バージョン] フィールドは空欄のままにします。
  
  これにより、Google Cloudの SAP 用エージェントの最新バージョンをインストールするようにポリシーが指示されます。
3. [構成ファイルの内容] フィールドに、エージェントに適用する構成を入力します。
  
  SAP ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
  
  注: Agent for Compute Workloads がすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーで設定した内容で既存のエージェントのバージョンと構成がオーバーライドされます。
  
  エージェントの既存の構成は、各 VM の /etc/google-cloud-workload-agent/ ディレクトリにある BAK ファイルに書き込まれます。
4. [完了] をクリックします。
省略可: ポリシーのロールアウトを必要な VM に制限するには、次の操作を行います。
1. [ラベルを追加] をクリックし、必要な VM を識別するラベルを追加します。
2. [完了] をクリックします。
[作成] をクリックします。

gcloud

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

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

POLICY_NAME: VM 拡張機能ポリシーの名前。

指定した名前のポリシーがゾーンにすでに存在する場合、コマンドは失敗します。
ZONE: このポリシーを適用するゾーン。
CONFIG_FILE_PATH: SAP ワークロードに接続するための Agent for SAP の構成を含む JSON ファイルのローカルパス。
- あるいは、構成をインライン文字列として指定する場合は、--config-from-file ではなく --config フラグを使用します。例: --config=google-cloud-sap-extension="CONFIG"Google Cloud は --config-from-file の使用を推奨しています。
- --config-from-file または --config のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- SAP ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
注: SAP 用エージェントがすでに実行されている VM に VM 拡張機能マネージャーポリシーを適用すると、ポリシーで設定した内容で既存のエージェントのバージョンと構成がオーバーライドされます。
エージェントの既存の構成は、各 VM の `/etc/google-cloud-sap-extension/` ディレクトリにある BAK ファイルに書き込まれます。
DESCRIPTION: ポリシーの説明（省略可）。
KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りのリスト。
- ポリシーの対象となる VM には、指定されたすべてのラベルが設定されている必要があります。
- --inclusion-labels を複数回指定すると、ポリシーは、指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。
PRIORITY: ポリシーの優先度を定義する 0～65535 の整数。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。

例:

次のコマンドは、test-project という名前のGoogle Cloud プロジェクトに test-agent-policy という名前のポリシーを作成します。このポリシーは、ゾーン us-centrail-f にデプロイされたすべての VM に最新バージョンのコンピューティングワークロード用エージェントをインストールします。agent-config.json で指定された構成がエージェントに適用されます。

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-sap-extension \
    --config-from-file=google-cloud-sap-extension="/usr/agent-config.json"

VM フリートでエージェントを管理する

VM Extension Manager ポリシーによる SAP 用エージェントの管理方法を変更するには、ポリシーを更新します。ポリシーを更新すると、VM Extension Manager は通常 1 分以内に、該当するすべての VM に変更をロールアウトします。包含ラベルを変更すると、VM が更新されたラベルと一致するかどうかに基づいて、新しい VM に Agent for SAP がインストールされたり、既存の VM からアンインストールされたりする可能性があります。

以降のセクションでは、Agent for SAP を管理して次の操作を行う方法について説明します。

VM フリートでエージェント構成を変更する
新しいゾーンを含めるようにグローバルポリシーを更新する
ゾーンを除外するようにグローバルポリシーを更新する

VM フリートでエージェント構成を変更する

VM Extension Manager ポリシーを使用して VM フリートにインストールした SAP 用エージェントインスタンスの構成を変更するには、そのポリシーを編集する必要があります。

VM フリートでエージェント構成を変更する手順は次のとおりです。

コンソール

ゾーンポリシーを更新する手順は次のとおりです。グローバルポリシーを更新するには、gcloud タブをご覧ください。

Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

[VM 拡張機能ポリシー] に移動
変更するポリシーをクリックします。
[拡張機能のポリシーの詳細] ページで、[編集] をクリックします。
[拡張機能を管理] セクションで、[Google Cloud の SAP 用拡張機能] を切り替えます。
[構成ファイルの内容] フィールドに、エージェントに適用する構成を入力します。

エージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
[完了] をクリックします。
[保存] をクリックします。

gcloud

ゾーン

特定のゾーン内の VM で Agent for SAP の構成を変更するには、gcloud compute zone-vm-extension-policies update コマンドを実行します。gcloud を使用してポリシーを更新すると、リクエストは完全な置換として機能します。省略したオプションフィールドは、変更されたポリシーの既存の値を保持するのではなく、デフォルト値に戻ります。

エージェント構成を変更するには:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --zone=ZONE \
  --extensions=google-cloud-sap-extension \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

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

POLICY_NAME: 変更する VM 拡張機能ポリシーの名前。
ZONE: ポリシーが適用される Google Cloud ゾーン。
CONFIG_FILE_PATH: Agent for SAP の構成を含む JSON ファイルのローカルパス。
- --config-from-file ではなく --config フラグを使用して、エージェント構成をインライン文字列として指定することもできます。例: --config=google-cloud-sap-extension="CONFIG"Google Cloud は --config-from-file の使用を推奨しています。
- --config-from-file または --config のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- エージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りのリスト。
- ポリシーの対象となる VM には、指定されたすべてのラベルが設定されている必要があります。
- --inclusion-labels を複数回指定すると、ポリシーは、指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。
PRIORITY_NUMBER: ポリシーに設定する優先度。0～65535 の整数を指定できます。
DESCRIPTION: VM 拡張機能ポリシーの説明。

グローバル

Google Cloud プロジェクトの VM で Agent for SAP の構成を変更するには、gcloud beta compute global-vm-extension-policies update コマンドを実行します。gcloud を使用してポリシーを更新すると、リクエストは完全な置換として機能します。省略したオプションフィールドは、変更されたポリシーの既存の値を保持するのではなく、デフォルト値に戻ります。

エージェント構成を変更するには:

gcloud beta compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=google-cloud-sap-extension \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
  --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
  [--inclusion-labels=KEY_1=VALUE_1 \]
  [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
  [--priority=PRIORITY_NUMBER \]
  [--description="DESCRIPTION"]

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

POLICY_NAME: 変更する VM 拡張機能ポリシーの名前。
PROJECT_ID: ポリシーが配置されている Google Cloud プロジェクトの ID。
ROLLOUT_PLAN_OPTION: グローバルポリシーに適用するロールアウトオプション。サポートされている値は slow_rollout（推奨）と fast_rollout です。
- または、--rollout-custom-plan オプションを指定して、カスタムロールアウトプランを使用することもできます。詳細については、ロールアウトプランについてをご覧ください。
- --rollout-predefined-plan または --rollout-custom-plan のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
CONFIG_FILE_PATH: Agent for SAP の構成を含む JSON ファイルのローカルパス。
- --config-from-file ではなく --config フラグを使用して、エージェント構成をインライン文字列として指定することもできます。例: --config=google-cloud-sap-extension="CONFIG"Google Cloud は --config-from-file の使用を推奨しています。
- --config-from-file または --config のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- エージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りのリスト。
- ポリシーの対象となる VM には、指定されたすべてのラベルが設定されている必要があります。
- --inclusion-labels を複数回指定すると、ポリシーは、指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーはプロジェクト内のすべての VM をターゲットにします。
PRIORITY_NUMBER: ポリシーに設定する優先度。0～65535 の整数を指定できます。
DESCRIPTION: VM 拡張機能ポリシーの説明。

新しいゾーンを含めるようにグローバルポリシーを更新する

グローバルポリシーを作成してロールアウトした後に新しいゾーンに VM を作成しても、VM Extension Manager は新しいゾーンの VM にポリシーを自動的に適用しません。新しいゾーンの VM を含めるには、グローバルポリシーのロールアウトを再開する必要があります。

グローバルポリシーのロールアウトを再開する手順は次のとおりです。

ターミナルまたは Cloud Shell で、gcloud beta compute global-vm-extension-policies update コマンドを実行し、次のように --rollout-entry-uuid オプションを指定します。
```
gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-predefined-plan=ROLLOUT_PLAN_OPTION \
    --config-from-file=google-cloud-sap-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID
```
次のように置き換えます。
- UUID: 再試行リクエストを識別するユニバーサルな固有識別子（UUID）。UUID は任意の UUID ジェネレータを使用して作成できます。詳細については、ロールアウトを再試行するをご覧ください。
- ROLLOUT_PLAN_OPTION: グローバルポリシーに適用するロールアウトオプション。サポートされている値は slow_rollout（推奨）と fast_rollout です。
- または、--rollout-custom-plan オプションを指定して、カスタムロールアウトプランを使用することもできます。詳細については、ロールアウトプランについてをご覧ください。
- --rollout-predefined-plan または --rollout-custom-plan のいずれかを使用できますが、同じコマンドで両方を使用することはできません。

ゾーンを除外するようにグローバルポリシーを更新する

ゾーンを除外するようにグローバルポリシーを更新する手順は次のとおりです。

ターミナルまたは Cloud Shell で gcloud beta compute global-vm-extension-policies update コマンドを実行し、ポリシーを適用するゾーンを指定するカスタムロールアウトプランを指定します。
```
gcloud beta compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-sap-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID
```
次のように置き換えます。
- NEW_CUSTOM_PLAN_NAME: ポリシーを適用するゾーンを識別する新しいカスタムロールアウトプランの名前。カスタムロールアウトプランの作成については、ロールアウトプランについてをご覧ください。
- UUID: 再試行リクエストを識別するユニバーサルな固有識別子（UUID）。UUID は任意の UUID ジェネレータを使用して作成できます。詳細については、ロールアウトを再試行するをご覧ください。

VM フリートからエージェントをアンインストールする

VM フリートから SAP 用エージェントをアンインストールするには、VM フリートを管理する VM Extension Manager ポリシーを削除する必要があります。

ポリシーの削除中に、別の優先度の低い有効なポリシーが VM に適用され、このポリシーで SAP 用エージェントが宣言されている場合、優先度の低いポリシーに基づいて、エージェントはその VM にインストールされたままになります。

VM Extension Manager は、ポリシーの削除後 1 分以内に、アクセス可能なすべての VM からエージェントを削除します。ゲストエージェントが削除されたか、VM が削除されたために VM にアクセスできない場合、VM Extension Manager は SAP 用エージェントの削除をスキップします。このような VM が再び利用可能になると、VM Extension Manager はその時点で SAP 用エージェントを削除します。

VM フリートから SAP 用エージェントをアンインストールする手順は次のとおりです。

コンソール

Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

[VM 拡張機能ポリシー] に移動
VM フリートの SAP 用エージェントを管理するポリシーをクリックします。
[拡張機能ポリシーの詳細] ページで、[削除] をクリックして、削除を確定します。

gcloud

ゾーン

ゾーン VM Extension Manager ポリシーを削除するには、gcloud beta compute zone-vm-extension-policies delete コマンドを使用します。

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

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

POLICY_NAME: 削除するゾーンポリシーの名前。
PROJECT_ID: ポリシーが配置されている Google Cloud プロジェクトの ID。
ZONE: ポリシーが配置されている Google Cloud ゾーン。

グローバル

グローバル VM Extension Manager ポリシーを削除するには、gcloud beta compute global-vm-extension-policies delete コマンドを使用します。

gcloud beta compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN_OPTION

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

POLICY_NAME: 削除するゾーンポリシーの名前。
PROJECT_ID: ポリシーが配置されている Google Cloud プロジェクトの ID。
ROLLOUT_PLAN_OPTION: グローバルポリシーに適用するロールアウトオプション。サポートされている値は slow_rollout（推奨）と fast_rollout です。
- または、--rollout-custom-plan オプションを指定して、カスタムロールアウトプランを使用することもできます。詳細については、ロールアウトプランについてをご覧ください。
- --rollout-predefined-plan または --rollout-custom-plan のいずれかを使用できますが、同じコマンドで両方を使用することはできません。

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

Google Cloud では、SAP ワークロードを正確に評価するには、SAP 用エージェントの最新バージョンをインストールすることをおすすめします。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

更新をインストールする

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

RHEL

インスタンスと SSH 接続を確立します。
エージェントインスタンスを更新します。
- （推奨）エージェントのバージョン 3.14（最新）に更新するには:
```
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.14（最新）に更新するには:
```
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 など）に置き換えます。インストール可能なエージェントのバージョンについては、使用可能なすべてのエージェントバージョンを一覧表示するをご覧ください。

ワークロードマネージャーの評価指標の収集の設定を確認する

エージェントの status コマンドを実行して、ワークロードマネージャー評価指標の収集に正しい Google Cloud 設定がされているかどうかを確認できます。このコマンドは、エージェントのバージョン 3.7 以降でサポートされています。

Google Cloud の設定を検証するには、次の操作を行います。

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

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

sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

Workload Manager 評価指標の収集の Google Cloud 設定が正しい場合、出力には次のものが含まれます。構成には、default 以外の値が含まれている場合があります。

    Agent Status:
        ...
        Systemd Service Enabled: True
        Systemd Service Running: True
        Cloud API Full Scopes: True
        Configuration File: /etc/google-cloud-sap-agent/configuration.json
        Configuration Valid: True
    ...
    ----------------------------------------------------------------------------
    System Discovery: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            enable_discovery:                  true  (default)
            enable_workload_discovery:         true  (default)
            sap_instances_update_frequency:    60    (default)
            system_discovery_update_frequency: 14400 (default)
    ----------------------------------------------------------------------------
    Workload Manager Evaluation: Enabled
        Status: Fully Functional
        IAM Permissions: All granted
        Configuration:
            collect_workload_validation_metrics:      true       (default)
            config_target_environment:                PRODUCTION (default)
            fetch_latest_config:                      true       (default)
            workload_validation_db_metrics_frequency: 3600       (default)
            workload_validation_metrics_frequency:    300        (default)
    ...

出力に設定が不足していることが示されている場合は、前のセクションで説明した情報を確認して必要なアクションを実行し、status コマンドを再実行して設定を再検証します。

構成ファイルの例

次の例は、Compute Engine インスタンス上で実行されているGoogle Cloudの SAP 用エージェントの完全な構成ファイルです。ここでは、ワークロードマネージャー評価指標の収集が有効になっています。

SAP HANA 認証の場合、エージェントは次の優先順位を使用します。指定されている場合、hdbuserstore_key 構成パラメータは hana_db_password パラメータよりも優先され、これは hana_db_password_secret_name パラメータよりも優先されます。構成ファイルで設定する認証オプションは 1 つだけにすることをおすすめします。

次の例では、SAP HANA 認証にセキュアユーザーストア（hdbuserstore）キーを使用します。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

次の例では、SAP HANA 認証にユーザー名と Secret Manager シークレットを使用します。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

次の例では、SAP HANA 認証にユーザー名とパスワードを使用します。この方法ではなく、SAP HANA 認証には Secret Manager シークレットまたはセキュアユーザーストア（hdbuserstore）キーを使用することをおすすめします。

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password": "TempPa55word",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Agent for SAP でサポートされている構成パラメータについては、構成パラメータをご覧ください。

次のステップ

ワークロードの評価について詳細を確認する

SAP ワークロード用エージェントを設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

エージェントに必要な IAM ロール

Cloud APIs へのアクセスを有効にする

パッケージ マネージャーを使用してエージェントをインストールして構成する

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

RHEL

SLES15

SLES 12

RHEL

SLES15

SLES 12

ワークロード マネージャー評価指標の収集を構成する

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

VM Extension Manager を設定する

VM フリートにエージェントをインストールして構成する

Google Cloud プロジェクト内の VM にエージェントをインストールして構成する

特定のゾーン内の VM のフリートにエージェントをインストールして構成する

コンソール

gcloud

VM フリートでエージェントを管理する

VM フリートでエージェント構成を変更する

コンソール

gcloud

ゾーン

グローバル

新しいゾーンを含めるようにグローバル ポリシーを更新する

ゾーンを除外するようにグローバル ポリシーを更新する

VM フリートからエージェントをアンインストールする

コンソール

gcloud

ゾーン

グローバル

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

更新を確認する

RHEL

SLES

更新をインストールする

RHEL

SLES

ワークロード マネージャーの評価指標の収集の設定を確認する

構成ファイルの例

次のステップ

SAP ワークロード用エージェントを設定する

パッケージマネージャーを使用してエージェントをインストールして構成する

ワークロードマネージャー評価指標の収集を構成する

新しいゾーンを含めるようにグローバルポリシーを更新する

ゾーンを除外するようにグローバルポリシーを更新する

ワークロードマネージャーの評価指標の収集の設定を確認する