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 terpasang ke instance komputasi untuk autentikasi dan untuk mengakses resource Google Cloud .

Untuk meningkatkan keamanan, sebaiknya gunakan akun layanan khusus daripada menggunakan akun layanan default Compute Engine.

Untuk memastikan akun layanan memiliki izin yang diperlukan agar Agen untuk SAP dapat melakukan autentikasi dengan Google Cloud dan mengakses Google Cloud resource, minta administrator untuk memberikan peran IAM berikut kepada 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 konfigurasi instance Anda untuk mengizinkan semua cakupan akses ke semua Cloud API. Untuk mengontrol akses ke Google Cloud resource, 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, maka Agen untuk SAP memerlukan cakupan akses Cloud API minimum 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 di subnet instance agar Agen untuk Compute Workloads dapat mengakses 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 untuk terhubung dengan beban kerja SAP Anda, dengan 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 beban kerja 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.14 (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 agen versi 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 informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

      Untuk mengetahui informasi tentang men-downgrade agen ke versi tertentu, lihat Men-downgrade Agen Google Cloud untuk SAP. Google Cloud

Mengonfigurasi pengumpulan metrik evaluasi Workload Manager

Setelah menginstal Agen untuk SAP, Anda perlu mengonfigurasi agen untuk pengumpulan metrik evaluasi Workload Manager.

Untuk mengonfigurasi Agen Google Cloud's untuk 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 dalam 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: tentukan 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, yang mengaktifkan pengumpulan metrik evaluasi Workload Manager.

    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 Secure user store (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 rahasia 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 rahasia Secret Manager atau kunci Secure user store (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 agen 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 sejumlah VM menggunakan VM Extension Manager.

Kebijakan VM Extension Manager memungkinkan Anda melakukan tugas seperti berikut:

  • Penginstalan di seluruh armada: Instal Agen untuk SAP di:
    • Semua VM di project Google Cloud Anda, atau subset VM yang diidentifikasi berdasarkan 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 dengan menggunakan kebijakan VM Extension Manager, lihat bagian yang sesuai:

Menginstal dan mengonfigurasi agen di VM dalam Google Cloud project

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

  • Di terminal atau Cloud Shell, jalankan perintah 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]

    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 Agent for 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 pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM menjadi target 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 diberikan (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 rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000. Untuk mengetahui informasi selengkapnya, lihat Prioritas kebijakan dan resolusi 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 kebijakan ekstensi VM

  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 antar-kebijakan. Angka yang lebih rendah menunjukkan prioritas yang lebih tinggi. Nilai defaultnya adalah 1000.

  6. Dengan menggunakan daftar Region dan Zone, pilih zona tempat Anda ingin menerapkan kebijakan ini.

  7. Di bagian Ekstensi, klik Tambahkan ekstensi, lalu lakukan tindakan berikut:

    1. Dari daftar Ekstensi, pilih Ekstensi Google Cloud untuk Beban Kerja Compute.

    2. Biarkan kolom Version kosong.

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

    3. Di kolom Configuration file content, masukkan 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, lakukan hal berikut:

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

  9. Klik Create.

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]

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 agar Agen untuk SAP terhubung dengan beban kerja 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 menyarankan 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 pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM menjadi target 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 diberikan (OR logis). Jika Anda menghilangkan tanda ini, kebijakan akan menargetkan semua VM di zona yang ditentukan.

  • PRIORITY: bilangan bulat dari 0 hingga 65535 yang menentukan prioritas kebijakan. Angka yang lebih rendah 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 Agent for Compute Workloads 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 Agent for SAP, perbarui kebijakan. Saat Anda memperbarui kebijakan, VM Extension Manager akan meluncurkan perubahan ke semua VM yang berlaku, biasanya dalam waktu satu menit. Jika Anda mengubah label penyertaan, Agent for SAP mungkin diinstal di VM baru atau di-uninstal dari VM yang ada berdasarkan apakah VM cocok dengan label yang diperbarui.

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

Mengubah konfigurasi agen di fleet VM

Untuk mengubah konfigurasi instance Agen untuk 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

Untuk memperbarui kebijakan zonal, selesaikan langkah-langkah berikut. Untuk memperbarui kebijakan global, lihat tab gcloud.

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

    Buka kebijakan ekstensi VM

  2. Klik kebijakan yang ingin Anda ubah.

  3. Di halaman Detail kebijakan ekstensi, klik Edit.

  4. Di bagian Kelola ekstensi, aktifkan Ekstensi Google Cloud untuk SAP.

  5. Di kolom Konten file konfigurasi, 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 Agent for SAP di VM dalam zona tertentu, jalankan perintah gcloud compute zone-vm-extension-policies update. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai penggantian lengkap. Setiap kolom opsional yang Anda hilangkan akan dikembalikan 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 ekstensi VM yang ingin Anda ubah.
  • ZONE: Google Cloud zona tempat kebijakan berlaku.

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

    • Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan menggunakan tanda --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG". Google Cloud menyarankan 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 pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM menjadi target 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 diberikan (OR logis). Jika Anda menghilangkan tanda 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 Agent for SAP di VM dalam projectGoogle Cloud , jalankan perintah gcloud beta compute global-vm-extension-policies update. Saat Anda memperbarui kebijakan menggunakan gcloud, permintaan akan bertindak sebagai pengganti lengkap. Setiap kolom opsional yang Anda hilangkan akan dikembalikan ke nilai defaultnya, bukan mempertahankan nilai yang ada dari kebijakan yang diubah.

Untuk mengubah konfigurasi agen:

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

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan ekstensi VM yang ingin Anda ubah.
  • PROJECT_ID: ID Google Cloud project 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 Agent for SAP.

    • Anda juga dapat memberikan konfigurasi agen sebagai string inline dengan menggunakan tanda --config, bukan --config-from-file. Contohnya, --config=google-cloud-sap-extension="CONFIG". Google Cloud menyarankan 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 pasangan nilai kunci yang dipisahkan koma yang menentukan label yang digunakan kebijakan untuk menargetkan VM.

    • Agar VM menjadi target 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 diberikan (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 otomatis menerapkan kebijakan 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 beta compute global-vm-extension-policies update dan berikan opsi --rollout-entry-uuid sebagai berikut:

    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

    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 beta compute global-vm-extension-policies update dan berikan rencana peluncuran kustom yang menentukan zona tempat kebijakan akan diterapkan:

    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

    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 armada VM, Anda harus menghapus kebijakan VM Extension Manager yang mengelola armada VM.

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

VM Extension Manager 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, Pengelola Ekstensi VM akan melewati penghapusan Agen untuk SAP. Jika VM tersebut tersedia lagi, maka VM Extension Manager akan menghapus Agen untuk SAP pada saat itu.

Untuk meng-uninstal Agen untuk SAP dari fleet VM Anda, selesaikan langkah-langkah berikut:

Konsol

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

    Buka kebijakan ekstensi VM

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

  3. Di halaman Detail kebijakan ekstensi, klik Hapus dan konfirmasi penghapusan.

gcloud

Zonal

Untuk menghapus kebijakan Pengelola Ekstensi VM zonal, gunakan perintah gcloud beta 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 Google Cloud project tempat kebijakan berada.
  • ZONE: Google Cloud zona tempat kebijakan berada.

Global

Untuk menghapus kebijakan global VM Extension Manager, gunakan perintah 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

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan zona yang ingin Anda hapus.
  • PROJECT_ID: ID Google Cloud project 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 Agent for SAP versi terbaru untuk evaluasi akurat workload SAP Anda karena rilis Agent for SAP secara berkala dapat menambahkan atau mengubah metrik yang digunakan untuk evaluasi.

Untuk memastikan Anda memiliki Agen untuk SAP versi terbaru Google Cloud, 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. Perbarui instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.14 (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. Perbarui instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.14 (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 pengumpulan metrik evaluasi Workload Manager

Anda dapat memvalidasi apakah Anda telah menyiapkan Google Cloud yang benar untuk pengumpulan metrik evaluasi Workload Manager dengan menjalankan perintah status agen. Perintah ini didukung mulai dari 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 pengumpulan metrik evaluasi Workload Manager sudah benar, output akan mencakup berikut. Konfigurasi Anda mungkin memiliki nilai selain 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 belum dilakukan, 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, yang mengaktifkan pengumpulan metrik evaluasi Workload Manager.

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 Secure user store (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 rahasia 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 rahasia Secret Manager atau kunci Secure user store (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 Agent for SAP, lihat Parameter konfigurasi.

Langkah berikutnya