Panduan ini membahas pertimbangan dan prosedur operasional untuk menjalankan versi 3.2 (terbaru) 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
Mencantumkan semua versi agen yang tersedia
Untuk mencantumkan semua versi Agent for SAP Google Cloud yang tersedia:
RHEL
Buat koneksi SSH dengan host Anda.
Jalankan perintah berikut:
sudo yum list --showduplicates google-cloud-sap-agent
SLES
Buat koneksi SSH dengan host Anda.
Jalankan perintah berikut:
sudo zypper search -s -t package -r google-cloud-sap-agent 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 Agen untuk SAP Google Cloud guna mengumpulkan metrik Pemantauan Proses atau metrik pemantauan SAP HANA, sebaiknya Anda melihatnya untuk memverifikasi bahwa agen 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.
Memvalidasi fitur Backint
Setelah mengaktifkan fitur Backint agen, Anda harus memvalidasinya dengan membuat dan memulihkan cadangan.
Untuk mengetahui petunjuknya, lihat Memvalidasi pencadangan dan pemulihan.
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
Agent for SAP dari Google Cloud adalah penerus agen Google Cloud lainnya. Bagian berikut memberikan informasi untuk mengupgrade Agensi SAP Google Cloud ke versi 3.2 (terbaru).
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 dari agen Backint Cloud Storage untuk SAP HANA
Untuk melakukan upgrade dari agen Backint Cloud Storage untuk SAP HANA ke versi 3.2 (terbaru), selesaikan langkah-langkah berikut:
Pastikan tidak ada pencadangan data yang sedang berlangsung atau dijadwalkan untuk periode yang tumpang-tindih dengan upgrade.
Nonaktifkan pencadangan log otomatis dengan menetapkan parameter
enable_auto_log_backup
parameter SAP HANA keno
. Untuk mengetahui petunjuknya, lihat dokumen SAP HANA Mengaktifkan dan Menonaktifkan Pencadangan Log Otomatis.Instal Agen Google Cloud untuk SAP. Untuk mengetahui petunjuknya, lihat panduan penginstalan untuk skenario Anda.
Mengaktifkan fitur Backint Agent for SAP Google Cloud. Untuk mengetahui petunjuknya, lihat Mengonfigurasi pencadangan dan pemulihan berbasis Backint.
Jika fitur Backint diaktifkan, Agent for SAP dari Google Cloud akan otomatis mendeteksi agen Backint di host Anda dan menonaktifkannya dari mesin host.
Untuk membuat versi JSON dari file teks konfigurasi Backint yang sudah ada, jalankan perintah berikut untuk setiap file teks Anda:
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
Ganti
PATH_TO_PARAMETERS_FILE
dengan jalur ke filePARAMETERS.txt
Anda.File JSON dibuat di lokasi yang sama dalam sistem file Anda dengan file teks selama Agen Google Cloud untuk SAP memiliki izin untuk mengakses lokasi tersebut. Meskipun Agent for SAP Google Cloud mampu menafsirkan parameter terkait Backint yang ditentukan dalam file teks, sebaiknya gunakan file JSON untuk memperbarui konfigurasi apa pun.
Aktifkan pencadangan log otomatis dengan menetapkan parameter
enable_auto_log_backup
parameter SAP HANA keyes
. Untuk mengetahui petunjuknya, lihat dokumen SAP HANA Mengaktifkan dan Menonaktifkan Pencadangan Log Otomatis.
Saat Anda melakukan upgrade ini, hal berikut akan terjadi:
- Untuk tujuan pencadangan dan referensi, semua file penginstalan di direktori
backint-gcs
agen Backint akan disalin kebackint-gcs-old-TIMESTAMP/
. Hal ini diperlukan seandainya Anda perlu kembali menggunakan agen Backint. - Folder
backint-gcs
kemudian dibersihkan agar hanya berisi file yang diperlukan untuk menjalankan Agent for SAP Google Cloud, yang mencakup file konfigurasinya,parameters.json
, dan file konfigurasi Backint sepertiPARAMETERS.txt
.
Untuk mengetahui informasi tentang pemetaan parameter konfigurasi antara agen Backint dan Agent for SAP Google Cloud, perluas bagian berikut.
Pemetaan parameter konfigurasi
Nama parameter di agen Backint | Nama parameter di Agent for SAP Google Cloud |
---|---|
BUCKET |
bucket |
DISABLE_COMPRESSION |
compress |
ENCRYPTION_KEY |
encryption_key |
KMS_KEY_NAME |
kms_key |
MAX_GCS_RETRY |
retries |
PARALLEL_FACTOR |
parallel_streams |
PARALLEL_PART_SIZE |
Opsi ini tidak tersedia di Agen untuk SAP Google Cloud. |
RATE_LIMIT_MB |
rate_limit_mb |
SERVICE_ACCOUNT |
service_account_key |
THREADS |
thread |
READ_IDLE_TIMEOUT |
file_read_timeout_ms |
CHUNK_SIZE_MB |
buffer_size_mb |
HTTP_READ_TIMEOUT |
Opsi ini tidak tersedia di Agen untuk SAP Google Cloud. |
Mengupgrade dari agen pemantauan untuk SAP HANA
Menginstal versi 3.2 (terbaru) Agent for SAP Google Cloud akan otomatis mendeteksi versi monitoring agent untuk SAP HANA, menonaktifkannya, lalu menghapusnya dari mesin host Anda selama penginstalan.
Jika agen ini terdeteksi, konfigurasinya akan dimigrasikan ke Agen untuk SAP Google Cloud 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
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.
Mengupgrade dari agen pemantauan untuk SAP NetWeaver
Menginstal versi 3.2 (terbaru) Agent for SAP Google Cloud akan otomatis mendeteksi versi agen pemantauan untuk SAP NetWeaver.
Jika agen ini terdeteksi, konfigurasinya akan dimigrasikan ke Agen untuk SAP Google Cloud selama penginstalannya.
Mengupdate Agen Google Cloud untuk SAP
Untuk memastikan Anda memiliki Agen Google Cloud untuk SAP versi terbaru, Anda harus memeriksa update secara berkala dan mengupdate agen.
Memeriksa update
Pilih sistem operasi Anda, lalu ikuti langkah-langkah berikut:
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
Pilih sistem operasi Anda, lalu ikuti langkah-langkahnya:
RHEL
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Update instance agen Anda:
- (Direkomendasikan) Untuk mengupdate agen ke versi 3.2 (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, seperti3.1-606637668
. Untuk mengetahui informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.
- (Direkomendasikan) Untuk mengupdate agen ke versi 3.2 (terbaru):
SLES
Buat koneksi SSH dengan instance VM host atau server Solusi Bare Metal.
Update instance agen Anda:
- (Direkomendasikan) Untuk mengupdate agen ke versi 3.2 (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, seperti3.1-606637668
. Untuk mengetahui informasi tentang versi agen yang dapat Anda instal, lihat Mencantumkan semua versi agen yang tersedia.
- (Direkomendasikan) Untuk mengupdate agen ke versi 3.2 (terbaru):
Windows
Buat koneksi RDP dengan instance VM host Anda.
Untuk mengupdate agen ke versi 3.2 (terbaru), sebagai administrator, jalankan perintah berikut dari PowerShell:
googet install google-cloud-sap-agent
Roll back untuk menggunakan agen Google Cloud lainnya
Bagian ini berisi informasi tentang roll back dari penggunaan Agen untuk SAP Google Cloud versi 3.2 (terbaru) dan dari agen pendahulunya.
Melakukan roll back untuk menggunakan agen Backint
Jika Anda ingin melakukan roll back untuk menggunakan agen Backint dan berhenti menggunakan fitur Backint dari Agen untuk SAP Google Cloud, ikuti langkah-langkah berikut:
Hapus semua file yang terkait dengan fitur Backint dari Agent for SAP Google Cloud:
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
Ganti
SID
dengan SID sistem SAP Anda.Pulihkan file agen Backint yang disimpan sebagai cadangan saat Anda melakukan upgrade ke Agent for SAP dari Google Cloud, dengan menyalinnya ke direktori
backint-gcs
:cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
Ganti kode berikut:
SID
: SID sistem SAP AndaTIMESTAMP
: nilai stempel waktu pada nama folder yang dibuat saat Anda mengupgrade dari agen Backint ke Agent for SAP Google Cloud
Gunakan SAP HANA Studio atau SAP HANA Cockpit untuk mengedit file
global.ini
, dan memperbarui jalur ke file konfigurasi.txt
Anda. Untuk informasi tentang parameter yang mengharuskan Anda menentukan jalur ke file.txt
, lihat Mengonfigurasi SAP HANA untuk fitur Backint.Simpan perubahan yang dibuat pada file
global.ini
.
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
Meng-uninstal agen
Untuk meng-uninstal atau menghapus agen dari host:
RHEL
Buat koneksi SSH dengan host Anda.
Jalankan perintah berikut:
sudo yum remove google-cloud-sap-agent
SLES
Buat koneksi SSH dengan host Anda.
Jalankan perintah berikut:
sudo zypper remove google-cloud-sap-agent
Windows
Buat koneksi RDP dengan instance VM host Anda.
Sebagai administrator, jalankan perintah berikut dari PowerShell:
Remove-Service -Name 'google-cloud-sap-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 yang berkaitan dengan kumpulan metrik. Caranya, ikuti langkah-langkah berikut:
Buat koneksi SSH dengan instance VM host atau 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.
Untuk menonaktifkan pengalihan default log yang terkait dengan fitur Backint Agent for SAP Google Cloud, edit file konfigurasi Backint Anda dan tetapkan parameter log_to_cloud
ke false
.