Versi 2: Panduan operasi Agen untuk SAP dari Google Cloud

Panduan ini membahas pertimbangan dan prosedur operasional untuk menjalankan versi 2 Agen Google Cloud untuk SAP di instance VM Compute Engine dan server Solusi Bare Metal.

Memahami siklus proses agen

Saat mengelola operasi Agen Google Cloud untuk SAP, sebaiknya pahami dengan baik apa yang dilakukan agen tersebut. Secara umum, berikut cara kerjanya:

  • Anda harus menginstal Agen Google Cloud untuk SAP di setiap instance VM Compute Engine atau server Solusi Bare Metal yang menghosting sistem SAP. Agen dijalankan sebagai layanan Linux atau layanan Windows.
  • Pada instance VM Compute Engine, agen menggabungkan data pemantauan dari Monitoring dan Compute Engine API.
  • Pada server Solusi Bare Metal, hanya untuk pengumpulan metrik Agen Host SAP, agen tersebut tidak mengakses Google Cloud API.
  • Agen Host SAP melakukan polling Agen Google Cloud untuk SAP atas data yang di-cache, melalui HTTP. Cloud Console menggabungkan metrik Agen Host SAP, melaporkannya, dan menyimpannya di database SAP NetWeaver.
  • Transaksi SAP ST06 atau antarmuka command line saposcol menampilkan metrik Agen Host SAP gabungan.
  • Anda dapat melihat metrik Agen Google Cloud untuk SAP untuk SAP dengan menjalankan perintah di jendela terminal.

Pastikan agen sedang berjalan

Setelah menginstal agen atau memulai ulang agen, Anda dapat memverifikasi bahwa agen berjalan seperti yang diharapkan.

Untuk memeriksa apakah agen sedang berjalan, ikuti langkah-langkah berikut:

Linux

  1. Buat koneksi SSH dengan server Solusi Bare Metal atau instance VM.

  2. Jalankan perintah berikut: 

    systemctl status google-cloud-sap-agent

    Jika agen berfungsi dengan baik, output akan berisi active (running). Contoh: 

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

Windows

  1. Gunakan RDP untuk terhubung ke instance VM.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 

    $(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
    Jika agen berjalan, statusnya akan menampilkan Running.

Jika Agen Google Cloud untuk SAP tidak berjalan, mulai ulang agen.

Memeriksa versi agen

Setelah menginstal atau memulai ulang Agen Google Cloud untuk SAP, Anda dapat memeriksa versi agen.

Untuk memeriksa versi agen Anda, selesaikan langkah-langkah berikut:

Linux

Untuk RHEL, ikuti langkah-langkah berikut:

  1. Menggunakan SSH untuk terhubung ke mesin host.
  2. Jalankan perintah berikut: 
    yum info google-cloud-sap-agent

Untuk SLES, ikuti langkah-langkah berikut:

  1. Menggunakan SSH untuk terhubung ke mesin host.
  2. Jalankan perintah berikut: 
    zypper info google-cloud-sap-agent

Windows

  1. Menggunakan RDP untuk terhubung ke mesin host.
  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 
    googet installed google-cloud-sap-agent

Memverifikasi bahwa Agen Host SAP menerima metrik

Untuk memverifikasi bahwa metrik infrastruktur dikumpulkan oleh Agen Google Cloud untuk SAP dan dikirim dengan benar ke Agen Host SAP, ikuti langkah-langkah berikut:

  1. Di sistem SAP, masukkan transaksi ST06.

  2. Di panel ringkasan, periksa ketersediaan dan konten kolom berikut untuk penyiapan infrastruktur pemantauan SAP dan Google yang menyeluruh dan benar:

    • Penyedia Cloud: Google Cloud Platform
    • Akses Pemantauan yang Ditingkatkan: TRUE
    • Detail Enhanced Monitoring: ACTIVE

Melihat metrik Agen Host SAP

Setelah menginstal atau mengupdate konfigurasi Agent for SAP Google Cloud, Anda dapat melihat metrik Agen Host SAP yang dikumpulkan.

Untuk melihat metrik Agen Host SAP yang dikumpulkan oleh Agen Google Cloud untuk SAP, ikuti langkah-langkah berikut:

Linux

  1. Buat koneksi SSH dengan instance VM host Anda dari server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

    curl http://localhost:18181

    Jika metrik tersedia, Anda akan menerima output XML yang berisi informasi tentang sistem Anda. Contoh:

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

Windows

  1. Gunakan RDP untuk terhubung ke instance VM.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 

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

    Jika metrik tersedia, Anda akan melihat output XML yang berisi informasi tentang sistem Anda. Contoh:

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

Melihat metrik lainnya

Setelah Anda memperbarui konfigurasi Agent for SAP dari Google Cloud untuk mengumpulkan metrik Pemantauan Proses, metrik evaluasi Workload Manager, atau metrik pemantauan SAP HANA, Anda harus melihatnya untuk memverifikasi bahwa agen tersebut mengumpulkan metrik seperti yang diharapkan.

Anda dapat melihat metrik dan informasi yang dikumpulkan oleh Agen Google Cloud untuk SAP di Cloud Monitoring dengan menyelesaikan langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Monitoring Metrics Explorer.

    Buka Metrics Explorer

  2. Pilih tab Configuration

  3. Luaskan menu Select a metric.

  4. Di menu Resources, pilih VM instance.

  5. Di menu Metric category, pilih sap.

  6. Di menu Metric, pilih metric: workload.googleapis.com/sap/service/active atau salah satu metrik baru yang akan dibuat diagramnya.

  7. Klik Apply.

Anda akan melihat diagram dengan nilai metrik deret waktu.

Memulai ulang agen

Jika Agen Google Cloud untuk SAP berhenti berfungsi atau Anda memperbarui konfigurasinya, mulai ulang agen.

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

Linux

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

    sudo systemctl restart google-cloud-sap-agent

Windows

  1. Buat koneksi RDP dengan instance VM host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 

    Restart-Service -Name 'google-cloud-sap-agent' -Force

Upgrade ke Agent for SAP Google Cloud dari agen Google Cloud lainnya

Menginstal Agen Google Cloud untuk SAP akan otomatis mendeteksi agen pemantauan untuk SAP NetWeaver versi sebelumnya dan agen pemantauan untuk SAP HANA, menonaktifkannya, lalu menghapusnya dari mesin host Anda selama penginstalan.

Jika agen Google Cloud ini terdeteksi, konfigurasi dalam file konfigurasinya juga akan dimigrasikan ke Agen Google Cloud untuk SAP selama penginstalannya. Untuk tujuan pencadangan dan referensi, konfigurasi agen pemantauan untuk SAP HANA disalin ke file berikut:

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

Untuk mendapatkan petunjuk cara menginstal dan mengonfigurasi Agen Google Cloud untuk SAP, baca artikel Memilih panduan penginstalan dan konfigurasi Agen Google Cloud untuk SAP.

Mengupgrade instance yang mendukung SSL

Jika Anda telah mengonfigurasi agen pemantauan untuk SAP HANA agar menggunakan sertifikat SSL untuk komunikasi dengan instance SAP HANA, maka saat Anda menginstal Agen Google Cloud untuk SAP, semua konfigurasi pemantauan SAP HANA kecuali SSL dimigrasikan ke Agent for SAP Google Cloud. Dalam kasus tersebut, agar dapat menggunakan Agen Google Cloud untuk SAP untuk memantau instance SAP HANA, Anda harus menyelesaikan langkah-langkah berikut:

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Buka file konfigurasi Agen Google Cloud untuk SAP:

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

  3. Di bagian hana_monitoring_configuration, tetapkan parameter enabled ke true.

  4. Di bagian hana_monitoring_configuration.hana_instances, lakukan tindakan berikut untuk setiap instance SAP HANA yang menggunakan protokol TLS/SSL untuk komunikasi yang aman:

    1. Tentukan parameter enable_ssl dan tetapkan nilainya ke true.

    2. Tentukan parameter host_name_in_certificate dan tetapkan nama host SAP HANA, seperti yang ditentukan dalam sertifikat TLS/SSL, sebagai nilainya.

    3. Tentukan parameter tls_root_ca_file dan tetapkan jalur, tempat sertifikat TLS/SSL disimpan, sebagai nilainya.

  5. Simpan file konfigurasi.

  6. Mulai ulang agen agar setelan baru diterapkan:

    sudo systemctl restart google-cloud-sap-agent

  7. Pastikan agen sedang mengumpulkan metrik pemantauan SAP HANA. Untuk mengetahui petunjuknya, lihat Melihat metrik lainnya.

  8. Uninstal agen pemantauan untuk SAP HANA.

Jika mengalami masalah koneksi dengan instance SAP HANA setelah upgrade ini, Anda dapat melihat log agen di Logging dan menggunakan pemecahan masalah panduan untuk mengatasi masalah tersebut.

Mengupdate Agen Google Cloud untuk SAP

Bagian ini menjelaskan langkah-langkah untuk memeriksa apakah versi terbaru Agent for SAP Google Cloud tersedia, dan cara mengupdate ke versi 3.2 (terbaru) Agen untuk SAP Google Cloud.

Jika Anda perlu mengupdate ke versi agen yang bukan yang terbaru, hubungi Cloud Customer Care.

Memeriksa update

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

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

SLES

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

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

Windows

  1. Buat koneksi RDP dengan instance VM host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 

    googet latest google-cloud-sap-agent

Menginstal update

Untuk mengupdate instance Agent for SAP Google Cloud ke versi 3.2 (terbaru), pilih sistem operasi Anda, lalu ikuti langkah-langkahnya.

Jika Anda perlu menginstal versi agen yang bukan yang terbaru, hubungi Cloud Customer Care.

RHEL

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

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

SLES

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Jalankan perintah berikut: 

    sudo zypper --no-gpg-checks update google-cloud-sap-agent

Windows

  1. Buat koneksi RDP dengan instance VM host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell: 

    googet install google-cloud-sap-agent

Roll back untuk menggunakan agen pemantauan untuk SAP HANA

Jika Anda ingin melakukan roll back penggunaan agen pemantauan untuk SAP HANA dan berhenti menggunakan fitur pemantauan SAP HANA dari Agen Google Cloud untuk SAP, ikuti langkah-langkah berikut:

RHEL

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Untuk mencegah pengumpulan metrik duplikat, nonaktifkan pengumpulan metrik pemantauan SAP HANA oleh Agen Google Cloud untuk SAP:

    1. Buka file konfigurasi Agen Google Cloud untuk SAP:

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

    2. Di bagian hana_monitoring_configuration, tetapkan parameter enabled ke false.

    3. Simpan file konfigurasi.

    4. Mulai ulang agen agar setelan baru diterapkan:

      sudo systemctl restart google-cloud-sap-agent

  3. Salin konfigurasi agen pemantauan untuk SAP HANA dari file berikut:

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

  4. Instal agen pemantauan untuk SAP HANA versi 2. Untuk petunjuk penginstalan, lihat Agen pemantauan untuk panduan penginstalan dan operasi SAP HANA V2.0.

  5. Pada file berikut, tempel konfigurasi agen pemantauan untuk SAP HANA yang Anda salin pada langkah sebelumnya:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Mulai ulang agen pemantauan untuk SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

SLES

  1. Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.

  2. Untuk mencegah pengumpulan metrik duplikat, nonaktifkan pengumpulan metrik pemantauan SAP HANA oleh Agen Google Cloud untuk SAP:

    1. Buka file konfigurasi Agen Google Cloud untuk SAP:

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

    2. Di bagian hana_monitoring_configuration, tetapkan parameter enabled ke false.

    3. Simpan file konfigurasi.

    4. Mulai ulang agen agar setelan baru diterapkan:

      sudo systemctl restart google-cloud-sap-agent

  3. Salin konfigurasi agen pemantauan untuk SAP HANA dari file berikut:

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

  4. Instal agen pemantauan untuk SAP HANA versi 2. Untuk petunjuk penginstalan, lihat Agen pemantauan untuk panduan penginstalan dan operasi SAP HANA V2.0.

  5. Pada file berikut, tempel konfigurasi agen pemantauan untuk SAP HANA yang Anda salin pada langkah sebelumnya:

    /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

  6. Mulai ulang agen pemantauan untuk SAP HANA:

    sudo systemctl start google-saphanamonitoring-agent

Lihat log agen di Cloud Logging

Secara default, log untuk Agen Google Cloud untuk SAP dialihkan dari instance VM dan server Solusi Bare Metal Anda ke Cloud Logging.

Untuk melihat log agen di Logging, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Buka panel Query.

  3. Dari menu drop-down Resources, pilih Global, lalu klik Apply.

  4. Di editor kueri, masukkan google-cloud-sap-agent.

  5. Klik Run query.

Anda akan melihat log yang dihasilkan oleh instance agen yang berjalan di semua instance VM atau server Solusi Bare Metal Anda. Untuk memfilter log dari mesin tertentu, gunakan filter yang tersedia di antarmuka.

Anda dapat menonaktifkan pengalihan default log agen ini. Untuk melakukannya, ikuti langkah-langkah berikut:

  1. Buat koneksi SSH dengan instance VM host server Solusi Bare Metal.

  2. Buka file konfigurasi berikut:

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

  3. Untuk parameter log_to_cloud, perbarui nilai menjadi false.

  4. Simpan file konfigurasi.

  5. Mulai ulang agen agar perubahan ini diterapkan.