Menyiapkan Agen Google Cloud untuk SAP

Solusi Workload Manager untuk SAP menggunakan AgenGoogle Clouduntuk SAP untuk mendeteksi dan mengumpulkan metadata guna 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.

Checklist berikut merangkum tugas yang perlu Anda lakukan untuk memastikan bahwa Agen untuk SAP disiapkan dengan benar:

  1. Memberikan peran yang diperlukan ke akun layanan
  2. Menginstal Agen untuk SAP
  3. Memverifikasi versi agen dan menginstal update, jika ada
  4. Mengaktifkan pengumpulan metrik evaluasi

Peran IAM yang diperlukan

AgenGoogle Clouduntuk SAP memerlukan akun layanan Identity and Access Management (IAM) untuk autentikasi dengan Google Cloud dan izin untuk mengakses resource Google Cloud . Untuk pengumpulan metrik evaluasi Workload Manager, baik Anda menggunakan akun layanan baru, yang sudah ada, atau default, akun layanan harus menyertakan peran IAM berikut:

Menginstal agen

Jika belum melakukannya, instal Agen Google Clouduntuk SAP di VM yang menghosting sistem SAP Anda:

Untuk menginstal agen pada 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.6 (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 informasi tentang cara mendowngrade agen ke versi tertentu, lihat Mendowngrade Agen Google Clouduntuk SAP.

Setelah penginstalan selesai, lanjutkan untuk mengonfigurasi agen untuk pengumpulan metrik evaluasi Workload Manager.

Memverifikasi versi agen

Google Cloud menyarankan agar Anda menginstal Agent for SAP versi terbaru untuk evaluasi yang akurat terhadap beban kerja SAP karena rilis Agent for SAP berkala dapat 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. Perbarui instance agen Anda:
    • (Direkomendasikan) Untuk mengupdate ke agen versi 3.6 (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 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.6 (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 informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.

Mengonfigurasi 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 "SAP HANA Insights" dan "SAP HANA Security Best Practices" 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: menentukan nama secret di Secret Manager yang menyimpan sandi akun pengguna

      Sebagai alternatif secret, Anda dapat menggunakan parameter konfigurasi hdbuserstore_key.

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

      Jika menentukan hdbuserstore_key, Anda akan melewati penentuan parameter hostname dan port.

    Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.

    Contoh berikut adalah file konfigurasi lengkap dari Agent for SAPGoogle Cloudyang 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 disukai daripada parameter hana_db_password, yang lebih disukai 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.

Langkah selanjutnya