Panduan ini menunjukkan cara menyelesaikan masalah terkait Agen untuk SAP Google Cloud versi 3.2 (terbaru).
Untuk informasi pemecahan masalah dan dukungan dari SAP, lihat Catatan SAP berikut:
- 1642148 - FAQ: Pencadangan & Pemulihan Database SAP HANA
- 2031547 - Ringkasan alat pencadangan pihak ketiga bersertifikasi SAP dan proses dukungan terkait
- 2705632 - Proses Dukungan untuk Google Cloud Storage
Logging
Periksa log di direktori yang khusus untuk sistem operasi Anda.
Untuk melihat log Agen Google Cloud untuk SAP, buka jalur berikut:
Linux
/var/log/google-cloud-sap-agent.log
Windows
C:\Program Files\Google\google-cloud-sap-agent\logs\google-cloud-sap-agent.log
Melihat log terkait Backint
Jika Anda telah mengaktifkan fitur Backint pada Agen untuk SAP Google Cloud, tinjau log berikut:
- File
backup.log
SAP HANA, yang berisi informasi tentang operasi pencadangan dan pemulihan SAP HANA. - File
backint.log
SAP HANA, yang berisi panggilan ke antarmuka pencadangan yang digunakan oleh fitur Backint dari agen dan alat pencadangan eksternal lainnya. - File log Backint Agen Google Cloud untuk SAP:
/var/log/google-cloud-sap-agent/backint.log
. File ini mencakup informasi tentang kapan fitur Backint diaktifkan, peristiwa operasional terkait, dan indikasi error komunikasi dengan Cloud Storage dan masalah konfigurasi atau izin yang terkait. - Google Cloud mencatat log di Cloud Logging, yang dapat berisi error terkait akun layanan yang digunakan oleh Agent for SAP dari Google Cloud. Untuk melihat log ini, di Konsol Google Cloud, buka halaman Logs explorer.
Masalah umum
Bagian berikut ini memberikan informasi tentang masalah umum terkait penggunaan Agen untuk SAP Google Cloud, serta penyebab dan penyelesaiannya.
Masalah: Izin IAM tidak memadai
Masalah: Log Agen Google Cloud untuk SAP menampilkan error izin IAM yang tidak memadai.
Penyebab: Akun layanan yang digunakan oleh agen tidak memiliki izin IAM yang diperlukan untuk mengakses Cloud Monitoring API. Atau, jika Anda menggunakan fitur Backint dari agen, izin untuk mengakses bucket Cloud Storage tidak memadai.
Penyelesaian: Untuk menyelesaikan masalah ini, lakukan langkah-langkah berikut:
Di Google Cloud Console, pada halaman detail instance VM, catat nama akun layanan VM. Contoh:
sap-example@example-project-123456.iam.gserviceaccount.com
.Buka halaman IAM & Admin, dan untuk akun layanan yang dimaksud, pastikan akun tersebut menyertakan peran IAM berikut:
Fitur Peran IAM yang diperlukan Pengumpulan metrik Agen Host SAP Pengumpulan metrik Process Monitoring - Viewer Compute (
roles/compute.viewer
) - Penulis Metrik
Monitoring (
roles/monitoring.metricWriter
) -
Secret Manager Secret Accessor
(
roles/secretmanager.secretAccessor
)
(Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)
Pengumpulan metrik evaluasi Workload Manager - Viewer Compute (
roles/compute.viewer
) -
Penulis Insight Workload Manager
(
roles/workloadmanager.insightWriter
) -
Secret Manager Secret Accessor (
roles/secretmanager.secretAccessor
)
(Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)
Pengumpulan metrik pemantauan SAP HANA - Viewer Compute (
roles/compute.viewer
) - Penulis Metrik
Monitoring (
roles/monitoring.metricWriter
) -
Secret Manager Secret Accessor (
roles/secretmanager.secretAccessor
)
(Diperlukan saat Anda menggunakan Secret Manager untuk mengautentikasi akun pengguna database untuk SAP HANA.)
Pencadangan dan pemulihan berbasis backint untuk SAP HANA - Storage Object Admin (
roles/storage.objectAdmin
) - Encrypter/Decrypter Cloud KMS CryptoKey (
roles/cloudkms.cryptoKeyEncrypterDecrypter
), jika Anda menggunakan kunci enkripsi yang dikelola pelanggan untuk mengenkripsi cadangan SAP HANA di Cloud Storage. Untuk mengetahui informasi tentang fitur ini, lihat Opsi enkripsi untuk cadangan.
Untuk informasi selengkapnya, lihat Izin Cloud Storage yang diperlukan.
- Viewer Compute (
Untuk mengetahui informasi selengkapnya tentang autentikasi yang diperlukan oleh Agen Google Cloud untuk SAP, lihat Autentikasi dan akses.
Untuk mengonfirmasi izin yang diperlukan agen Cloud Monitoring, lihat dokumentasi Monitoring berikut:
Masalah: Cakupan akses salah untuk akun layanan VM
Masalah: Jika Anda membatasi cakupan akses pada instance VM host, log agen Google Cloud untuk SAP mungkin menampilkan error izin IAM yang tidak memadai.
Penyebab: Agen Google Cloud untuk SAP memerlukan cakupan akses Cloud API minimum pada instance VM host. Error ini terjadi saat akun layanan tidak memiliki cakupan akses yang diperlukan.
Penyelesaian: Cakupan akses adalah metode lama untuk menentukan izin instance VM Anda. Compute Engine merekomendasikan konfigurasi instance VM Anda untuk mengizinkan semua cakupan akses ke semua Cloud API dan hanya menggunakan izin IAM akun layanan VM untuk mengontrol akses ke resource Google Cloud.
Untuk mengatasi masalah ini, sebagai praktik terbaik, tetapkan semua cakupan
akses cloud-platform
pada instance VM, lalu batasi akses API akun layanan dengan
peran IAM secara aman. Contoh:
https://www.googleapis.com/auth/cloud-platform
Jika Anda membatasi cakupan akses instance VM, Anda harus memastikan bahwa instance VM host memiliki cakupan akses berikut:
https://www.googleapis.com/auth/source.read_write
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/servicecontrol
https://www.googleapis.com/auth/service.management.readonly
https://www.googleapis.com/auth/logging.admin
https://www.googleapis.com/auth/monitoring
https://www.googleapis.com/auth/trace.append
https://www.googleapis.com/auth/devstorage.full_control
Jika Anda telah mengaktifkan pengumpulan metrik Process Monitoring atau metrik pemantauan SAP HANA, cakupan akses instance VM host juga harus memiliki akses tulis untuk memublikasikan data metrik ke project Google Cloud Anda:
https://www.googleapis.com/auth/monitoring.write
Untuk mengubah cakupan akses, Anda harus menghentikan instance VM, membuat perubahan, lalu memulai ulang instance VM. Untuk mendapatkan petunjuk, baca dokumentasi Compute Engine. Anda tidak perlu melakukan perubahan apa pun pada izin untuk peran IAM untuk masalah ini.
Masalah: Agen Host SAP tidak ada atau salah
Masalah: Log Agen Google Cloud untuk SAP menampilkan error Agen Host SAP yang tidak ada atau salah.
Penyebab: Agen Host SAP atau level patch minimum yang diperlukan untuk Agen Host SAP tidak diinstal. Agar Agen Google Cloud untuk SAP dapat berfungsi, Agen Host SAP harus diinstal di sistem SAP Anda dan level patch minimum yang diperlukan untuk Agen Host tersebut dipertahankan.
Penyelesaian: Untuk mengatasi masalah ini, instal versi Agen Host SAP yang diperlukan. Untuk mengetahui petunjuk penginstalan Agen Host SAP, lihat dokumentasi SAP.
Untuk persyaratan versi Agen Host SAP, lihat Catatan SAP berikut:
- Linux: Catatan SAP 2460297 - SAP di Linux pada Google Cloud Platform: Enhanced Monitoring
- Windows: Catatan SAP 1409604 - Virtualisasi di Windows: Enhanced Monitoring
Masalah: Penginstalan Agen Google Cloud untuk SAP gagal
Masalah: Penginstalan agen gagal saat perintah instal pengelola paket (yum
, zypper
, atau googet
) dijalankan.
Penyebab: Penginstalan agen gagal karena server host yang menjalankan agen telah dibuat tanpa alamat IP eksternal.
Penyelesaian: Untuk mengatasi masalah ini, siapkan gateway NAT yang memberi server host akses keluar ke internet. Untuk informasi tentang cara menyiapkan gateway NAT, lihat panduan deployment untuk sistem SAP Anda. Misalnya, untuk SAP NetWeaver, lihat:
- Menyiapkan gateway NAT di instance VM Compute Engine
- Panduan Deployment SAP NetWeaver di Linux
- Panduan Deployment SAP NetWeaver di Windows
Masalah: Pengumpulan metrik pemantauan SAP HANA gagal
Masalah: Saat mengupgrade dari agen pemantauan untuk SAP HANA, setelah Anda menginstal Agen Google Cloud untuk SAP, Anda akan melihat pesan error yang mirip dengan berikut ini:
tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead
Penyebab: Agen Google Cloud untuk SAP tidak dapat memulai pengumpulan metrik pemantauan SAP HANA karena instance SAP HANA target menggunakan sertifikat SSL yang ditentukan dengan Common Name (CN).
Penyelesaian: Untuk mengatasi masalah ini, selesaikan beberapa langkah berikut:
Untuk instance SAP HANA yang ingin dipantau menggunakan Agen Google Cloud untuk SAP, Anda harus beralih menggunakan sertifikat SSL Subject Alternative Name (SAN), bukan sertifikat SSL yang ditentukan dengan Nama Umum (CN).
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 Google Cloud untuk SAP 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.
Masalah: Error koneksi ditolak
Masalah: Log Agen Host SAP menampilkan error koneksi ditolak.
Penyebab: Agen Google Cloud untuk SAP tidak dapat dimulai karena port 18181
tidak tersedia. Agen Google Cloud untuk SAP memproses permintaan pada port 18181
.
Port ini harus tersedia agar agen dapat dimulai.
Penyelesaian: Untuk mengatasi masalah ini, pastikan port 18181
tersedia
untuk Agen Google Cloud untuk SAP. Jika layanan lain menggunakan port 18181
, Anda
mungkin perlu memulai ulang layanan lain tersebut atau mengonfigurasinya ulang untuk menggunakan
port lain.
Masalah: Untuk image OS SLES 15 SP4 untuk SAP dan yang lebih baru, Agen Google Cloud untuk SAP tidak berjalan
Masalah: Saat Anda menggunakan image OS "untuk SAP" SLES, Agen Google Cloud untuk SAP sudah diinstal untuk Anda. Namun, untuk image OS SLES 15 SP4 untuk SAP dan yang lebih baru, Agen bawaan untuk SAP tidak akan memulai secara mandiri.
Untuk memastikan bahwa agen sudah berjalan atau tidak, lakukan langkah-langkah berikut:
- Hubungkan ke instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
systemctl status google-cloud-sap-agent
Jika agen tidak berjalan, output berisi
inactive (dead)
. Contoh:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled) Active: inactive (dead)
Penyebab: Agen untuk SAP tidak dimulai sendiri karena ada masalah pada paket OS.
Penyelesaian: Untuk mengatasi masalah tersebut, lakukan langkah-langkah berikut:
- Hubungkan ke instance VM host atau server Solusi Bare Metal.
Jalankan perintah berikut:
sudo sed -i 's~ /usr/sap~ -/usr/sap~g' /usr/lib/systemd/system/google-cloud-sap-agent.service sudo systemctl restart google-cloud-sap-agent
Pastikan agen sedang berjalan:
systemctl status google-cloud-sap-agent
Anda akan melihat output yang mirip dengan berikut ini:
google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; disabled; vendor preset: disabled) Active: active (running) since Wed 2023-07-12 03:07:23 UTC; 7s ago Main PID: 6117 (google_cloud_sa) Tasks: 6 Memory: 8.8M (max: 1.0G limit: 1.0G available: 1015.1M) CGroup: /system.slice/google-cloud-sap-agent.service └─ 6117 /usr/bin/google_cloud_sap_agent startdaemon
Masalah: Throughput rendah
Masalah: Anda mengalami throughput yang lebih rendah dari yang diperkirakan.
Penyebab: Untuk fitur Backint dari Agen Google Cloud untuk SAP, Anda mungkin telah mengaktifkan kompresi menggunakan parameter konfigurasi compress
.
Penyelesaian: Untuk mengatasi masalah ini, pastikan kompresi tidak diaktifkan. Caranya, lakukan langkah-langkah berikut:
Sambungkan ke host SAP HANA Anda menggunakan SSH.
Buka file konfigurasi Backint Anda:
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
Ganti
SID
dengan SID sistem tempat Anda menginstal file terkait Backint.Pastikan parameter
compress
disetel kefalse
.Jika Anda membuat perubahan, simpan file konfigurasi.
Masalah: Error multi-streaming
Masalah: Anda mengalami error saat pencadangan data multi-streaming.
Penyebab: Untuk fitur Backint dari Agen Google Cloud untuk SAP, Anda mungkin telah menentukan jumlah streaming paralel yang lebih tinggi.
Penyelesaian: Untuk menyelesaikan masalah ini, lakukan langkah-langkah berikut:
Sambungkan ke host SAP HANA Anda menggunakan SSH.
Buka file konfigurasi Backint Anda:
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.json
Ganti
SID
dengan SID sistem tempat Anda menginstal file terkait Backint.Jika Anda telah menetapkan nilai untuk parameter
parallel_streams
, turunkan nilai tersebut ke1
.Jika langkah ini tidak menyelesaikan error, hubungi Layanan Pelanggan.
Masalah saat menghubungkan ke Cloud Storage
Masalah:Anda mengalami masalah konektivitas dengan bucket Cloud Storage.
Penyebab: Hal ini dapat disebabkan oleh hal berikut:
- Masalah konektivitas sementara.
- Akun layanan yang digunakan oleh Agent for SAP Google Cloud tidak memiliki izin yang diperlukan untuk mengakses Cloud Storage Anda.
- Ada masalah dengan konfigurasi Anda.
Penyelesaian: Untuk memecahkan masalah konektivitas dengan bucket Cloud Storage, periksa hal berikut:
- Coba lagi pencadangan atau pemulihan yang gagal untuk memastikan bahwa error bukan hanya masalah konektivitas sementara.
- Jika Agen Google Cloud untuk SAP menggunakan akun layanan VM Anda, pastikan VM tersebut memiliki akses ke semua cakupan cloud, atau jika Anda membatasi akses, pastikan VM tersebut memiliki akses ke
storage.googleapis.com
. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan akses ke Cloud API dan server metadata. - Jika Anda membuat akun layanan untuk digunakan dengan Agen Google Cloud untuk SAP, pastikan hal berikut:
- Akun layanan diberi peran Storage Object Admin.
- Akun layanan akan diberi peran Encrypter/Decrypter Cloud KMS CryptoKey jika menggunakan kunci enkripsi yang dikelola pelanggan untuk mengenkripsi cadangan di Cloud Storage. Untuk mengetahui informasi selengkapnya, lihat Enkripsi untuk pencadangan.
- Pastikan Anda telah menentukan parameter dengan benar di file konfigurasi Backint,
PARAMETERS.json
, dan fileglobal.ini
SAP HANA.
Anda dapat menguji akses ke bucket Cloud Storage menggunakan fitur diagnosis mandiri yang terintegrasi dalam Agent for SAP dari Google Cloud. Untuk informasi selengkapnya, lihat Diagnostik mandiri.
Masalah dengan operasi pencadangan atau pemulihan berbasis snapshot disk
Masalah: Operasi pencadangan atau pemulihan yang dilakukan untuk SAP HANA dengan menggunakan perintah hanadiskbackup
atau hanadiskrestore
agen tidak berhasil.
Penyebab: Masalah ini dapat terjadi karena salah satu alasan berikut:
- Agen mengalami error dan keluar dari operasi pencadangan atau pemulihan.
- Agen membutuhkan waktu lebih lama dari yang diperkirakan untuk membuat snapshot disk atau menguploadnya ke Cloud Storage karena ada masalah dengan layanan Google Cloud yang mendasarinya.
- Agen mengalami error tanpa ada pesan error atau berhasil yang jelas.
- Operasi pencadangan atau pemulihan gagal karena ada masalah pada level sistem operasi.
- Agen dibuat untuk menunggu lebih lama dari yang diharapkan oleh database SAP HANA Anda, yang mungkin terjadi karena database Anda mengalami beban kerja yang sangat berat.
Penyelesaian: Untuk mengatasi masalah ini, gunakan informasi berikut:
Jika operasi pencadangan tidak berhasil, lakukan hal berikut:
Pastikan agen berjalan. Jika tidak, mulai ulang agen, lalu coba lagi operasi pencadangan.
Jika agen berjalan seperti yang diharapkan, status pembuatan snapshot:
gcloud compute snapshots list --filter="sourceDisk:projects/PROJECT_ID/zones/ZONE_ID/disks/DISK_NAME"
Ganti kode berikut:
PROJECT_ID
: project Google Cloud tempat disk sumber di-deployZONE_ID
: zona Compute Engine tempat disk sumber di-deploy, misalnya,us-central1-a
DISK_NAME
: nama disk sumber
Status output dapat berupa salah satu dari hal berikut:
CREATING
,UPLOADING
, atauREADY
.Jika status pembuatan snapshot adalah
CREATING
atauUPLOADING
, sebaiknya tunggu hingga operasi ini selesai, terutama jika ini adalah snapshot pertama yang Anda buat untuk disk yang menghosting volume/hana/data
Anda.Jika operasi ini gagal, agen akan otomatis keluar dari prosedur dan memperbarui log. Anda dapat mencoba membuat cadangan lagi dengan menjalankan perintah
hanadiskbackup
. Agen menangani penyelesaian operasi pencadangan yang gagal dalam database SAP HANA dan membuat cadangan berbasis snapshot baru.Jika status pembuatan snapshot adalah
READY
, tetapi perintahhanadiskbackup
masih tampak berjalan, ini menunjukkan bahwa agen sedang menunggu SAP HANA untuk melakukan bagiannya dari prosedur pencadangan.Jika perintah
hanadiskbackup
tampaknya berjalan lebih lama dari yang diperkirakan, lakukan hal berikut untuk melanjutkan operasi normal untuk database SAP HANA Anda:Cairkan sistem file XFS yang berisi volume
/hana/data
:xfs_freeze -u PATH_TO_HANA_DATA_VOLUME
Dari database SAP HANA Anda, dapatkan ID cadangan snapshot penyimpanan yang gagal:
SELECT BACKUP_ID, STATE_NAME, COMMENT FROM M_BACKUP_CATALOG WHERE ENTRY_TYPE_NAME = 'data snapshot' and STATE_NAME = 'prepared'
Di SAP HANA, perbarui entri untuk snapshot yang gagal sebagai gagal:
BACKUP DATA FOR FULL SYSTEM CLOSE SNAPSHOT BACKUP_ID UNSUCCESSFUL 'Do not use - manually terminated';
Ganti
BACKUP_ID
denganBACKUP_ID
yang Anda ambil di langkah sebelumnya.Untuk mengatasi masalah operasi pencadangan yang gagal, hubungi Layanan Pelanggan dengan paket dukungan agen.
Jika operasi pemulihannya tidak berhasil, selesaikan langkah-langkah berikut:
Pastikan disk asli yang menghosting volume
/hana/data
terpasang ke VM host Anda. Jika tidak, lampirkan menggunakan perintahgcloud compute instances attach-disk
.Pindai ulang grup volume dan volume logis Anda:
sudo /sbin/dmsetup remove_all sudo /sbin/vgscan -v --mknodes sudo /sbin/vgchange -ay sudo /sbin/lvscan sudo mount -av
Jika pemindaian ulang tidak berhasil, mulai ulang VM host Anda. Hal ini membuat sistem operasi memindai ulang grup volume.
Di SAP HANA, pastikan volume
/hana/data
sudah aktif.Jika volume
/hana/data
masih belum aktif, hubungi Layanan Pelanggan dengan paket dukungan agen untuk menyelesaikan masalah.
Mendapatkan dukungan untuk Agen Google Cloud untuk SAP
Jika Anda memerlukan bantuan untuk menyelesaikan masalah pada Agen Google Cloud untuk SAP, kumpulkan informasi diagnostik yang diperlukan dan hubungi Cloud Customer Care. Untuk mengetahui informasi selengkapnya, lihat Informasi diagnostik Agen Google Cloud untuk SAP.