Panduan penyelesaian masalah Agen Google Cloud untuk SAP

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:

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

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:

  1. Di Google Cloud Console, pada halaman detail instance VM, catat nama akun layanan VM. Contoh: sap-example@example-project-123456.iam.gserviceaccount.com.

  2. 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
    Pengumpulan metrik evaluasi Workload Manager
    Pengumpulan metrik pemantauan 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.

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:

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:

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:

  1. 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).

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

  3. Buka file konfigurasi Agen Google Cloud untuk SAP:

    /etc/google-cloud-sap-agent/configuration.json
  4. Di bagian hana_monitoring_configuration, tetapkan parameter enabled ke true.

  5. 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.

  6. Simpan file konfigurasi.

  7. Mulai ulang Agen Google Cloud untuk SAP agar setelan baru diterapkan:

    sudo systemctl restart google-cloud-sap-agent
  8. Pastikan agen sedang mengumpulkan metrik pemantauan SAP HANA. Untuk mengetahui petunjuknya, lihat Melihat metrik lainnya.

  9. 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:

  1. Hubungkan ke instance VM host atau server Solusi Bare Metal.
  2. 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:

  1. Hubungkan ke instance VM host atau server Solusi Bare Metal.
  2. 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
  3. 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:

  1. Sambungkan ke host SAP HANA Anda menggunakan SSH.

  2. 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.

  3. Pastikan parameter compress disetel ke false.

  4. 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:

  1. Sambungkan ke host SAP HANA Anda menggunakan SSH.

  2. 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.

  3. Jika Anda telah menetapkan nilai untuk parameter parallel_streams, turunkan nilai tersebut ke 1.

    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 file global.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:

    1. Pastikan agen berjalan. Jika tidak, mulai ulang agen, lalu coba lagi operasi pencadangan.

    2. 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-deploy
      • ZONE_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, atau READY.

    3. Jika status pembuatan snapshot adalah CREATING atau UPLOADING, 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.

    4. Jika status pembuatan snapshot adalah READY, tetapi perintah hanadiskbackup masih tampak berjalan, ini menunjukkan bahwa agen sedang menunggu SAP HANA untuk melakukan bagiannya dari prosedur pencadangan.

    5. Jika perintah hanadiskbackup tampaknya berjalan lebih lama dari yang diperkirakan, lakukan hal berikut untuk melanjutkan operasi normal untuk database SAP HANA Anda:

      1. Cairkan sistem file XFS yang berisi volume /hana/data:

        xfs_freeze -u PATH_TO_HANA_DATA_VOLUME
      2. 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'
      3. 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 dengan BACKUP_ID yang Anda ambil di langkah sebelumnya.

    6. Untuk mengatasi masalah operasi pencadangan yang gagal, hubungi Layanan Pelanggan dengan paket dukungan agen.

  • Jika operasi pemulihannya tidak berhasil, selesaikan langkah-langkah berikut:

    1. Pastikan disk asli yang menghosting volume /hana/data terpasang ke VM host Anda. Jika tidak, lampirkan menggunakan perintah gcloud compute instances attach-disk.

    2. 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
      
    3. Jika pemindaian ulang tidak berhasil, mulai ulang VM host Anda. Hal ini membuat sistem operasi memindai ulang grup volume.

    4. Di SAP HANA, pastikan volume /hana/data sudah aktif.

    5. 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.