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 linesaposcol
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
Buat koneksi SSH dengan server Solusi Bare Metal atau instance VM.
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
Gunakan RDP untuk terhubung ke instance VM.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
Jika agen berjalan, statusnya akan menampilkan$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
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:
- Menggunakan SSH untuk terhubung ke mesin host.
- Jalankan perintah berikut:
yum info google-cloud-sap-agent
Untuk SLES, ikuti langkah-langkah berikut:
- Menggunakan SSH untuk terhubung ke mesin host.
- Jalankan perintah berikut:
zypper info google-cloud-sap-agent
Windows
- Menggunakan RDP untuk terhubung ke mesin host.
- 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:
- Di sistem SAP, masukkan transaksi
ST06
. 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
- Penyedia Cloud:
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
Buat koneksi SSH dengan instance VM host Anda dari server Solusi Bare Metal.
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
Gunakan RDP untuk terhubung ke instance VM.
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:
Di Konsol Google Cloud, buka halaman Monitoring Metrics Explorer.
Pilih tab Configuration
Luaskan menu Select a metric.
Di menu Resources, pilih VM instance.
Di menu Metric category, pilih sap.
Di menu Metric, pilih
metric: workload.googleapis.com/sap/service/active
atau salah satu metrik baru yang akan dibuat diagramnya.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
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo systemctl restart google-cloud-sap-agent
Windows
Buat koneksi RDP dengan instance VM host Anda.
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:
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Buka file konfigurasi Agen Google Cloud untuk SAP:
/etc/google-cloud-sap-agent/configuration.json
Di bagian
hana_monitoring_configuration
, tetapkan parameterenabled
ketrue
.Di bagian
hana_monitoring_configuration.hana_instances
, lakukan tindakan berikut untuk setiap instance SAP HANA yang menggunakan protokol TLS/SSL untuk komunikasi yang aman:Tentukan parameter
enable_ssl
dan tetapkan nilainya ketrue
.Tentukan parameter
host_name_in_certificate
dan tetapkan nama host SAP HANA, seperti yang ditentukan dalam sertifikat TLS/SSL, sebagai nilainya.Tentukan parameter
tls_root_ca_file
dan tetapkan jalur, tempat sertifikat TLS/SSL disimpan, sebagai nilainya.
Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan:
sudo systemctl restart google-cloud-sap-agent
Pastikan agen sedang mengumpulkan metrik pemantauan SAP HANA. Untuk mengetahui petunjuknya, lihat Melihat metrik lainnya.
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
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo yum check-update google-cloud-sap-agent
SLES
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo zypper list-updates -r google-cloud-sap-agent
Windows
Buat koneksi RDP dengan instance VM host Anda.
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
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo yum --nogpgcheck update google-cloud-sap-agent
SLES
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo zypper --no-gpg-checks update google-cloud-sap-agent
Windows
Buat koneksi RDP dengan instance VM host Anda.
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
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Untuk mencegah pengumpulan metrik duplikat, nonaktifkan pengumpulan metrik pemantauan SAP HANA oleh Agen Google Cloud untuk SAP:
Buka file konfigurasi Agen Google Cloud untuk SAP:
/etc/google-cloud-sap-agent/configuration.json
Di bagian
hana_monitoring_configuration
, tetapkan parameterenabled
kefalse
.Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan:
sudo systemctl restart google-cloud-sap-agent
Salin konfigurasi agen pemantauan untuk SAP HANA dari file berikut:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Instal agen pemantauan untuk SAP HANA versi 2. Untuk petunjuk penginstalan, lihat Agen pemantauan untuk panduan penginstalan dan operasi SAP HANA V2.0.
Pada file berikut, tempel konfigurasi agen pemantauan untuk SAP HANA yang Anda salin pada langkah sebelumnya:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
Mulai ulang agen pemantauan untuk SAP HANA:
sudo systemctl start google-saphanamonitoring-agent
SLES
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Untuk mencegah pengumpulan metrik duplikat, nonaktifkan pengumpulan metrik pemantauan SAP HANA oleh Agen Google Cloud untuk SAP:
Buka file konfigurasi Agen Google Cloud untuk SAP:
/etc/google-cloud-sap-agent/configuration.json
Di bagian
hana_monitoring_configuration
, tetapkan parameterenabled
kefalse
.Simpan file konfigurasi.
Mulai ulang agen agar setelan baru diterapkan:
sudo systemctl restart google-cloud-sap-agent
Salin konfigurasi agen pemantauan untuk SAP HANA dari file berikut:
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
Instal agen pemantauan untuk SAP HANA versi 2. Untuk petunjuk penginstalan, lihat Agen pemantauan untuk panduan penginstalan dan operasi SAP HANA V2.0.
Pada file berikut, tempel konfigurasi agen pemantauan untuk SAP HANA yang Anda salin pada langkah sebelumnya:
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
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:
Di Konsol Google Cloud, buka halaman Logs Explorer.
Buka panel Query.
Dari menu drop-down Resources, pilih Global, lalu klik Apply.
Di editor kueri, masukkan
google-cloud-sap-agent
.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:
Buat koneksi SSH dengan instance VM host server Solusi Bare Metal.
Buka file konfigurasi berikut:
/etc/google-cloud-sap-agent/configuration.json
Untuk parameter
log_to_cloud
, perbarui nilai menjadifalse
.Simpan file konfigurasi.
Mulai ulang agen agar perubahan ini diterapkan.