Versi 1: Panduan Agen untuk operasi SAP dari Google Cloud

Panduan ini mencakup pertimbangan dan prosedur operasional untuk menjalankan versi 1 Agent for SAP Google Cloud pada instance VM Compute Engine, instance bare metal 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 Compute Engine atau server Solusi Bare Metal yang menghosting sistem SAP. Agen dijalankan sebagai layanan Linux atau layanan Windows.
  • Pada instance 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 Compute Engine.

  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 Compute Engine.

  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.

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 yang dipantau

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

Untuk melihat metrik Agen Host SAP yang dipantau, ikuti langkah-langkah berikut:

Linux

  1. Buat koneksi SSH dengan instance Compute Engine host atau 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 Compute Engine.

  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>

Memverifikasi metrik Process Monitoring dan metrik evaluasi Workload Manager

Setelah memperbarui konfigurasi, Anda harus memverifikasi bahwa metrik Pemantauan Proses dan metrik evaluasi Workload Manager tersedia. Anda dapat mengakses metrik dan informasi yang dikumpulkan oleh Agent for SAP Google Cloud di Cloud Monitoring.

Untuk memverifikasi metrik di Monitoring, ikuti 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 komputasi host Anda.

  2. Jalankan perintah berikut:

    sudo systemctl restart google-cloud-sap-agent
    

Windows

  1. Buat koneksi RDP dengan instance komputasi 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 pemantauan untuk SAP NetWeaver

Menginstal Agent for SAP Google Cloud akan otomatis mendeteksi versi lama agen pemantauan untuk SAP NetWeaver, menonaktifkan agen, lalu menghapus agen tersebut dari server host Anda selama penginstalan.

Jika agen pemantauan untuk SAP NetWeaver terdeteksi dan file konfigurasi yang ada ditemukan selama penginstalan, proses penginstalan akan otomatis memigrasikan konfigurasi yang ada ke Agent for SAP Google Cloud.

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

Mengupdate Agen Google Cloud untuk SAP

Bagian ini memberikan langkah-langkah untuk memeriksa apakah versi terbaru Agen Google Cloud untuk SAP tersedia, dan cara mengupdate ke versi 3.6 (terbaru) Agen Google Cloud untuk SAP.

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

Memeriksa update

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

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

SLES

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

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

Windows

  1. Buat koneksi RDP dengan instance komputasi host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

    googet latest google-cloud-sap-agent

Menginstal update

Untuk mengupdate instance Agen Google Cloud untuk SAP ke versi 3.6 (terbaru), pilih sistem operasi Anda, lalu ikuti langkah-langkahnya.

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

RHEL

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

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

SLES

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

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

Windows

  1. Buat koneksi RDP dengan instance komputasi host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

    googet install google-cloud-sap-agent

Melakukan roll back ke versi sebelumnya

Jika diperlukan, Anda dapat me-roll back Agent for SAP Google Cloud untuk SAP versi 1 ke agen pemantauan untuk SAP NetWeaver versi 2.

Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:

RHEL

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

    sudo yum remove google-cloud-sap-agent

  3. Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Memilih agen pemantauan untuk panduan penginstalan SAP NetWeaver.

SLES

  1. Buat koneksi SSH dengan instance komputasi host Anda.

  2. Jalankan perintah berikut:

    sudo zypper remove google-cloud-sap-agent

  3. Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Panduan memilih agen pemantauan untuk SAP NetWeaver.

Windows

  1. Buat koneksi RDP dengan instance komputasi host Anda.

  2. Sebagai administrator, jalankan perintah berikut dari PowerShell:

    googet remove google-cloud-sap-agent

  3. Instal agen pemantauan untuk SAP NetWeaver versi 2. Untuk mengetahui petunjuk cara menginstal agen pemantauan untuk SAP NetWeaver, lihat Memilih agen pemantauan untuk panduan penginstalan SAP NetWeaver.

Lihat log agen di Cloud Logging

Secara default, log untuk Agen Google Cloud untuk SAP dialihkan dari instance Compute Engine 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 Compute Engine 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 Compute Engine 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.