Menyiapkan agen untuk workload SAP

Workload Manager untuk solusi SAP menggunakan AgenGoogle Clouduntuk SAP guna mendeteksi dan mengumpulkan metadata untuk mengevaluasi konfigurasi sistem SAP Anda. Agen untuk SAP, bersama dengan Agen Host SAP, diperlukan di semua instance VM yang menjalankan sistem SAP untuk dukungan dan pemantauan sistem SAP Anda yang berjalan di Google Cloud, termasuk SAP NetWeaver, SAP HANA, SAP ASE, dan SAP MaxDB.

Sebelum memulai

Sebelum menginstal dan mengonfigurasi Agen Google Clouduntuk SAP, Anda harus memastikan bahwa prasyarat berikut terpenuhi:

Peran IAM yang diperlukan untuk agen

Agen untuk SAP menggunakan akun layanan yang dilampirkan ke instance komputasi untuk autentikasi dan untuk mengakses resource Google Cloud .

Untuk meningkatkan keamanan, sebaiknya gunakan akun layanan tujuan tunggal, bukan akun layanan default Compute Engine.

Untuk memastikan akun layanan memiliki izin yang diperlukan agar Agen untuk SAP dapat melakukan autentikasi denganGoogle Cloud dan mengakses resource Google Cloud , minta administrator untuk memberikan peran IAM berikut ke akun layanan di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun layanan melalui peran khusus atau peran bawaan lainnya.

Mengaktifkan akses ke Cloud API

Compute Engine merekomendasikan agar Anda mengonfigurasi instance untuk mengizinkan semua cakupan akses ke semua Cloud API. Untuk mengontrol akses ke resource Google Cloud, gunakan hanya izin IAM akun layanan instance. Untuk mengetahui informasi selengkapnya, lihat Membuat VM yang menggunakan akun layanan yang dikelola pengguna.

Jika Anda membatasi akses ke Cloud API, Agen untuk SAP memerlukan setidaknya cakupan akses Cloud API berikut pada instance komputasi host:

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

Untuk mengetahui informasi selengkapnya, lihat Praktik terbaik cakupan.

Jika Anda menjalankan aplikasi SAP pada instance komputasi yang tidak memiliki alamat IP eksternal, Anda harus mengaktifkan Akses Google Pribadi pada subnet instance agar Agen untuk SAP dapat mengakses Google API dan layanan Google. Untuk mengetahui informasi tentang cara mengaktifkan Akses Google Pribadi, lihat Mengonfigurasi Akses Google Pribadi.

Menginstal dan mengonfigurasi agen menggunakan pengelola paket

Bagian ini menunjukkan cara menginstal Agen untuk SAP di instance komputasi Anda, dan mengonfigurasinya agar terhubung dengan workload SAP, menggunakan pengelola paket.

Jika ingin menginstal dan mengonfigurasi agen di fleet VM, Anda dapat menggunakan kebijakan VM Extension Manager. Untuk mengetahui informasi selengkapnya, lihat Menginstal dan mengelola agen di fleet VM menggunakan VM Extension Manager.

Menginstal agen

Jika belum dilakukan, instal Agen Google Clouduntuk SAP di semua instance komputasi yang menjalankan workload SAP Anda:

Untuk menginstal agen di instance Compute Engine, ikuti langkah-langkah berikut:

  1. Buat koneksi SSH ke instance komputasi Anda.
  2. Di terminal, instal agen dengan menjalankan perintah khusus untuk sistem operasi Anda:
    • (Direkomendasikan) Untuk menginstal agen versi 3.16 (terbaru):

      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
    • Untuk menginstal versi agen tertentu:

      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

      Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk mengetahui informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

      Untuk mengetahui informasi tentang cara mendowngrade agen ke versi tertentu, lihat Mendowngrade Agen Google Clouduntuk SAP.

Mengonfigurasi pengumpulan metrik evaluasi Workload Manager

Setelah menginstal Agent for SAP, Anda harus mengonfigurasi agen untuk pengumpulan metrik evaluasi Workload Manager.

Untuk mengonfigurasi Agen Google Clouduntuk SAP, selesaikan langkah-langkah berikut:

  1. Agar agen dapat mengumpulkan metrik evaluasi Workload Manager:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  2. Opsional: Untuk mengaktifkan pengumpulan metrik "Insight SAP HANA" dan "Praktik Terbaik Keamanan SAP HANA" di Workload Manager, tambahkan bagian workload_validation_db_metrics_config setelah collect_workload_validation_metrics di file konfigurasi agen, lalu tentukan parameter berikut:

    • hana_db_user: menentukan akun pengguna yang digunakan untuk mengkueri instance SAP HANA.
    • hostname: menentukan ID untuk mesin, baik lokal maupun jarak jauh, yang menghosting instance SAP HANA Anda.
    • port: menentukan port tempat instance SAP HANA Anda menerima kueri.

    • hana_db_password_secret_name: menentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna

      Sebagai alternatif untuk secret, Anda dapat menggunakan parameter konfigurasi hdbuserstore_key.

    • hdbuserstore_key: tentukan kunci hdbuserstore yang mengautentikasi pengguna yang Anda tentukan untuk hana_db_user

      Jika Anda menentukan hdbuserstore_key, Anda tidak perlu menentukan parameter hostname dan port.

    Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.

    Contoh berikut adalah file konfigurasi lengkap dari AgenGoogle Clouduntuk SAP yang berjalan di instance Compute Engine, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan.

    Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih diutamakan daripada parameter hana_db_password, yang lebih diutamakan daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

    • Contoh berikut menggunakan kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA: 
      {
  "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
  }
}
    • Contoh berikut menggunakan nama pengguna dan secret Secret Manager untuk autentikasi SAP HANA: 
      {
  "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
  }
}
    • Contoh berikut menggunakan nama pengguna dan sandi untuk autentikasi SAP HANA. Sebaiknya gunakan secret Secret Manager atau kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA. 
      {
  "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. Mulai ulang agen agar setelan baru diterapkan:

    sudo systemctl restart google-cloud-sap-agent

    Setelah berhasil dimulai ulang, agen akan mulai mengirim metrik evaluasi Workload Manager ke Workload Manager.

Menginstal dan mengelola agen di fleet VM menggunakan VM Extension Manager

Bagian ini menunjukkan cara menginstal dan mengelola Agen untuk SAP di fleet VM menggunakan VM Extension Manager.

Kebijakan VM Extension Manager memungkinkan Anda melakukan tugas seperti berikut:

  • Penginstalan di seluruh fleet: Instal Agen untuk SAP pada hal berikut:
    • Semua VM di project Google Cloud Anda, atau subset VM yang diidentifikasi oleh label.
    • Semua VM dalam zona, atau subset VM yang diidentifikasi oleh label.
  • Pengelolaan konfigurasi: Terapkan konfigurasi kustom ke agen di semua VM yang dikelola oleh kebijakan.

Menyiapkan VM Extension Manager

Untuk menyiapkan VM Extension Manager, selesaikan langkah-langkah berikut:

Menginstal dan mengonfigurasi agen di fleet VM

Untuk menginstal Agen untuk SAP versi terbaru di fleet VM Anda menggunakan kebijakan VM Extension Manager, lihat bagian yang sesuai:

Menginstal dan mengonfigurasi agen di VM dalam project Google Cloud Anda

Untuk menginstal agen di semua VM dalam project Google Cloud Anda, atau subset VM yang diidentifikasi oleh label, menggunakan kebijakan VM Extension Manager, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman VM extension policies.

    Buka VM extension policies

  2. Klik Create extension policy.

  3. Di kolom Name, masukkan nama untuk kebijakan.

  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.

  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antara kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Di bagian Cakupan, pilih Peluncuran global.

  7. Di bagian Manage extensions, klik Add extension, lalu lakukan hal berikut:

    1. Dari daftar Extension, pilih Google Cloud's extension for SAP.

    2. Biarkan pilihan kolom Version apa adanya.

      Tindakan ini akan mengarahkan kebijakan untuk menginstal AgenGoogle Clouduntuk SAP versi terbaru di fleet VM Anda.

    3. Di kolom Configuration file content, masukkan konten file konfigurasi yang ingin Anda terapkan ke agen.

      Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload SAP Anda, lihat Parameter konfigurasi.

    4. Klik Done.

    5. Di kolom Rollout, pilih opsi rencana peluncuran yang ingin Anda gunakan: Slow rollout (direkomendasikan) atau Fast rollout.

  8. Opsional: Untuk membatasi peluncuran kebijakan ke VM yang diperlukan, di bagian Target VM instances, lakukan hal berikut:

    1. Klik Add labels dan sertakan label yang mengidentifikasi VM yang diperlukan.
    2. Klik Done.

  9. Klik Create.

gcloud

Di terminal Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies create:

gcloud 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]

Ganti kode berikut:

  • POLICY_NAME: nama unik untuk kebijakan ekstensi VM.
  • PROJECT_ID: project ID dari projectGoogle Cloud tempat Anda membuat kebijakan

  • ROLLOUT_PLAN_OPTION: opsi peluncuran yang ingin Anda terapkan ke kebijakan global. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout.

    • Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
    • Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.

  • DESCRIPTION: deskripsi opsional untuk kebijakan.

  • CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi untuk Agen untuk SAP.

    • Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG".
    • Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
    • Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.

  • KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM dapat ditargetkan oleh kebijakan Anda, VM harus memiliki semua label yang ditentukan.
    • Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM dalam project.

  • PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Untuk mengetahui informasi selengkapnya, lihat Prioritas kebijakan dan penyelesaian konflik.

Menginstal dan mengonfigurasi agen di fleet VM dalam zona tertentu

Untuk menginstal Agen untuk SAP versi terbaru di fleet VM Anda dalam zona tertentu menggunakan kebijakan VM Extension Manager, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman VM extension policies.

    Buka VM extension policies

  2. Klik Create extension policy.

  3. Di kolom Name, masukkan nama untuk kebijakan.

  4. Opsional: Di kolom Description, masukkan deskripsi untuk kebijakan.

  5. Di kolom Priority, tentukan nomor prioritas untuk menyelesaikan konflik antara kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Di bagian Scope, pilih Zonal rollout, lalu pilih Region dan Zone tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Manage extensions, klik Add extension, lalu lakukan hal berikut:

    1. Dari daftar Extension, pilih Google Cloud's extension for SAP.

    2. Kosongkan kolom Version.

      Tindakan ini akan mengarahkan kebijakan untuk menginstal AgenGoogle Clouduntuk SAP versi terbaru.

    3. Di kolom Configuration file content, masukkan konten file konfigurasi yang ingin Anda terapkan ke agen.

      Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload SAP Anda, lihat Parameter konfigurasi.

    4. Klik Done.

  8. Opsional: Untuk membatasi peluncuran kebijakan ke VM yang diperlukan, di bagian Target VM instances, lakukan hal berikut:

    1. Klik Add labels dan sertakan label yang mengidentifikasi VM yang diperlukan.
    2. Klik Done.

  9. Klik Create.

gcloud

Di terminal atau Cloud Shell, jalankan perintah gcloud compute zone-vm-extension-policies create:

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]

Ganti kode berikut:

  • POLICY_NAME: nama untuk kebijakan ekstensi VM.

    Perintah akan gagal jika kebijakan dengan nama yang ditentukan sudah ada di zona.

  • ZONE: zona tempat Anda ingin menerapkan kebijakan ini.

  • CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi Agen untuk SAP agar terhubung dengan workload SAP Anda.

    • Atau, untuk memberikan konfigurasi sebagai string inline, gunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG". Google Cloud merekomendasikan agar Anda menggunakan --config-from-file.
    • Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
    • Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen untuk workload SAP Anda, lihat Parameter konfigurasi.

  • DESCRIPTION: deskripsi opsional untuk kebijakan.

  • KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM dapat ditargetkan oleh kebijakan Anda, VM harus memiliki semua label yang ditentukan.
    • Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

  • PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih kecil menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

Contoh:

Perintah berikut membuat kebijakan bernama test-agent-policy di projectGoogle Cloud bernama test-project, yang menginstal versi terbaru Agen untuk Workload Komputasi di semua VM yang di-deploy di zona us-centrail-f. Konfigurasi yang ditentukan dalam agent-config.json diterapkan ke agen.

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"

Mengelola agen di fleet VM

Untuk mengubah cara kebijakan VM Extension Manager mengelola Agen untuk SAP, perbarui kebijakan. Saat Anda mengupdate kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, Agen untuk SAP mungkin diinstal di VM baru atau di-uninstal dari VM yang ada, berdasarkan apakah VM tersebut cocok dengan label yang diperbarui.

Bagian berikut menunjukkan cara mengelola Agen untuk SAP guna melakukan hal berikut:

Mengubah konfigurasi agen di fleet VM

Untuk mengubah konfigurasi instance Agent for SAP yang telah Anda instal di fleet VM menggunakan kebijakan VM Extension Manager, Anda harus mengedit kebijakan tersebut.

Untuk mengubah konfigurasi agen di fleet VM Anda, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman VM extension policies.

    Buka VM extension policies

  2. Untuk memperbarui kebijakan zona, buka tab Zonal policies.

  3. Klik kebijakan yang ingin Anda ubah.

  4. Di halaman Extension policy details, klik Edit.

  5. Di bagian Manage extensions, lakukan tindakan berikut:

    1. Pilih Google Cloud's extension for SAP.
    2. Di kolom Configuration file content, masukkan konfigurasi yang ingin Anda terapkan ke agen.

    Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.

  6. Klik Done.

  7. Klik Save.

gcloud

Zonal

Untuk mengubah konfigurasi Agen untuk SAP di VM dalam zona tertentu, jalankan perintah gcloud compute zone-vm-extension-policies update. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan tersebut bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi agen:

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"]

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan perpanjangan VM yang ingin Anda ubah.
  • ZONE: Google Cloud zona tempat kebijakan berlaku.

  • CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi untuk Agen untuk SAP.

    • Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan menggunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG". Google Cloud merekomendasikan agar Anda menggunakan --config-from-file.
    • Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
    • Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.

  • KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM dapat ditargetkan oleh kebijakan Anda, VM harus memiliki semua label yang ditentukan.
    • Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

  • PRIORITY_NUMBER: prioritas yang ingin Anda tetapkan untuk kebijakan Anda. Anda dapat menentukan bilangan bulat dari 0 hingga 65535.

  • DESCRIPTION: deskripsi kebijakan ekstensi VM.

Global

Untuk mengubah konfigurasi Agen untuk SAP di VM dalam projectGoogle Cloud Anda, jalankan perintah gcloud compute global-vm-extension-policies update. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan tersebut bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hapus akan kembali ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi agen:

gcloud 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"]

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan perpanjangan VM yang ingin Anda ubah.
  • PROJECT_ID: ID project Google Cloud tempat kebijakan berada.

  • ROLLOUT_PLAN_OPTION: opsi peluncuran yang ingin Anda terapkan ke kebijakan global. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout.

    • Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
    • Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.

  • CONFIG_FILE_PATH: jalur lokal ke file JSON yang berisi konfigurasi untuk Agen untuk SAP.

    • Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan menggunakan flag --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG". Google Cloud merekomendasikan agar Anda menggunakan --config-from-file.
    • Anda dapat menggunakan --config-from-file atau --config, tetapi tidak keduanya dalam perintah yang sama.
    • Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh agen, lihat Parameter konfigurasi.

  • KEY_1=VALUE_1: daftar key-value pair yang dipisahkan koma, yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM dapat ditargetkan oleh kebijakan Anda, VM harus memiliki semua label yang ditentukan.
    • Jika Anda menentukan --inclusion-labels beberapa kali, kebijakan akan menargetkan VM yang cocok dengan salah satu pemilih yang disediakan (OR logis). Jika Anda menghilangkan flag ini, kebijakan akan menargetkan semua VM dalam project.

  • PRIORITY_NUMBER: prioritas yang ingin Anda tetapkan untuk kebijakan Anda. Anda dapat menentukan bilangan bulat dari 0 hingga 65535.

  • DESCRIPTION: deskripsi kebijakan ekstensi VM.

Memperbarui kebijakan global untuk menyertakan zona baru

Saat Anda membuat VM di zona baru setelah membuat dan meluncurkan kebijakan global, VM Extension Manager tidak akan otomatis menerapkan kebijakan tersebut ke VM di zona baru. Untuk menyertakan VM di zona baru, Anda harus memulai ulang peluncuran kebijakan global.

Untuk memulai ulang peluncuran kebijakan global, selesaikan langkah-langkah berikut:

  • Di terminal atau Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies update dan berikan opsi --rollout-entry-uuid sebagai berikut:

    gcloud 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

    Ganti kode berikut:

    • UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Mencoba ulang peluncuran.

    • ROLLOUT_PLAN_OPTION: opsi peluncuran yang ingin Anda terapkan ke kebijakan global. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout.

      • Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
      • Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.

Memperbarui kebijakan global untuk mengecualikan zona

Untuk memperbarui kebijakan global guna mengecualikan zona, selesaikan langkah-langkah berikut:

  • Di terminal atau Cloud Shell, jalankan perintah gcloud compute global-vm-extension-policies update dan berikan rencana peluncuran kustom yang menentukan zona tempat kebijakan akan diterapkan:

    gcloud 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

    Ganti kode berikut:

    • NEW_CUSTOM_PLAN_NAME: nama rencana peluncuran kustom baru yang mengidentifikasi zona tempat kebijakan akan diterapkan. Untuk mengetahui informasi tentang cara membuat rencana peluncuran kustom, lihat Tentang rencana peluncuran.
    • UUID: ID unik universal (UUID) yang mengidentifikasi permintaan percobaan ulang. Anda dapat menggunakan generator UUID apa pun untuk membuatnya. Untuk mengetahui informasi selengkapnya, lihat Mencoba ulang peluncuran.

Meng-uninstal agen dari fleet VM

Untuk meng-uninstal Agent for SAP dari fleet VM, Anda harus menghapus kebijakan VM Extension Manager yang mengelola fleet VM.

Saat menghapus kebijakan, jika kebijakan aktif lain dengan prioritas lebih rendah berlaku untuk VM dan mendeklarasikan Agen untuk SAP, agen akan tetap diinstal di VM tersebut berdasarkan kebijakan dengan prioritas lebih rendah.

VM Extension Manager akan menghapus agen dari semua VM yang dapat diakses dalam waktu satu menit setelah penghapusan kebijakan. Jika VM tidak dapat diakses karena agen tamu dihapus atau VM dihapus, VM Extension Manager akan melewati penghapusan Agen untuk SAP. Jika VM tersebut tersedia lagi, VM Extension Manager akan menghapus Agen untuk SAP pada saat itu.

Untuk meng-uninstal Agent for SAP dari fleet VM Anda, selesaikan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman VM extension policies.

    Buka VM extension policies

  2. Klik kebijakan yang mengelola Agen untuk SAP di fleet VM Anda.

  3. Di halaman Extension policy details, klik Delete dan konfirmasi penghapusan.

gcloud

Zonal

Untuk menghapus kebijakan VM Extension Manager zonal, gunakan perintah gcloud compute zone-vm-extension-policies delete:

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

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan zona yang ingin Anda hapus.
  • PROJECT_ID: ID project Google Cloud tempat kebijakan berada.
  • ZONE: zona Google Cloud tempat kebijakan berada.

Global

Untuk menghapus kebijakan VM Extension Manager global, gunakan perintah gcloud compute global-vm-extension-policies delete:

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

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan zona yang ingin Anda hapus.
  • PROJECT_ID: ID project Google Cloud tempat kebijakan berada.

  • ROLLOUT_PLAN_OPTION: opsi peluncuran yang ingin Anda terapkan ke kebijakan global. Nilai yang didukung adalah slow_rollout (direkomendasikan) dan fast_rollout.

    • Atau, Anda dapat menggunakan rencana peluncuran kustom dengan menentukan opsi --rollout-custom-plan. Untuk mengetahui informasi selengkapnya, lihat Tentang rencana peluncuran.
    • Anda dapat menggunakan --rollout-predefined-plan atau --rollout-custom-plan, tetapi tidak keduanya dalam perintah yang sama.

Memverifikasi versi agen

Google Cloud merekomendasikan agar Anda menginstal versi terbaru Agent for SAP untuk evaluasi workload SAP yang akurat karena rilis berkala Agent for SAP mungkin menambahkan atau mengubah metrik yang digunakan untuk evaluasi.

Untuk memastikan Anda memiliki Agen Google Clouduntuk SAP versi terbaru, Anda harus memeriksa update secara berkala dan mengupdate agen.

Memeriksa update

Pilih sistem operasi Anda, lalu ikuti langkah-langkah berikut:

RHEL

  1. Buat koneksi SSH dengan instance Anda.
  2. Jalankan perintah berikut: 
    sudo yum check-update google-cloud-sap-agent

SLES

  1. Buat koneksi SSH dengan instance Anda.
  2. Jalankan perintah berikut: 
    sudo zypper list-updates -r google-cloud-sap-agent

Menginstal update

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

  1. Buat koneksi SSH dengan instance Anda.
  2. Update instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.16 (terbaru): 
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Untuk mengupdate ke versi agen tertentu: 
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk mengetahui informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

SLES

  1. Buat koneksi SSH dengan instance Anda.
  2. Update instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.16 (terbaru): 
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Untuk mengupdate ke versi agen tertentu: 
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Ganti VERSION_NUMBER dengan nomor versi agen yang ingin Anda instal, seperti 3.1-606637668. Untuk mengetahui informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

Memvalidasi penyiapan untuk pengumpulan metrik evaluasi Workload Manager

Anda dapat memvalidasi apakah Anda memiliki penyiapan Google Cloud yang benar untuk pengumpulan metrik evaluasi Workload Manager dengan menjalankan perintah status agen. Perintah ini didukung mulai agen versi 3.7.

Untuk memvalidasi penyiapan Google Cloud , selesaikan langkah-langkah berikut:

  1. Buat koneksi SSH dengan instance Compute Engine Anda.
  2. Jalankan perintah berikut: 
    sudo /usr/bin/google_cloud_sap_agent status -f="workload_manager,sap_discovery"

    Jika penyiapan Google Cloud untuk pengumpulan metrik evaluasi Workload Manager sudah benar, output-nya akan menyertakan hal berikut. Konfigurasi Anda mungkin memiliki nilai selain nilai 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)
    ...
  3. Jika output Anda menunjukkan bahwa beberapa penyiapan tidak ada, tinjau informasi yang diberikan di bagian sebelumnya, lakukan tindakan yang diperlukan, lalu jalankan kembali perintah status untuk memvalidasi ulang penyiapan.

Contoh file konfigurasi

Contoh berikut adalah file konfigurasi lengkap dari AgenGoogle Clouduntuk SAP yang berjalan di instance Compute Engine, tempat pengumpulan metrik evaluasi Workload Manager diaktifkan.

Untuk autentikasi SAP HANA, agen menggunakan urutan preferensi berikut: jika ditentukan, parameter konfigurasi hdbuserstore_key lebih diutamakan daripada parameter hana_db_password, yang lebih diutamakan daripada parameter hana_db_password_secret_name. Sebaiknya tetapkan hanya satu opsi autentikasi dalam file konfigurasi Anda.

  • Contoh berikut menggunakan kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA: 
    {
  "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
  }
}
  • Contoh berikut menggunakan nama pengguna dan secret Secret Manager untuk autentikasi SAP HANA: 
    {
  "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
  }
}
  • Contoh berikut menggunakan nama pengguna dan sandi untuk autentikasi SAP HANA. Sebaiknya gunakan secret Secret Manager atau kunci Penyimpanan pengguna yang aman (hdbuserstore) untuk autentikasi SAP HANA. 
    {
  "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
  }
}

Untuk mengetahui informasi tentang parameter konfigurasi yang didukung oleh Agen untuk SAP, lihat Parameter konfigurasi.

Langkah berikutnya