Memecahkan masalah agen Backint untuk SAP HANA

Jika terjadi error selama eksekusi pencadangan atau pemulihan, pesan error akan ditampilkan di SAP HANA Studio atau SAP HANA Cockpit, jadi periksa di sana terlebih dahulu untuk mengetahui informasi tentang penyebab error. Informasi ini mungkin ditampilkan dalam file rekaman aktivitas backup.log dan backint.log. Pastikan untuk memilih nama database yang relevan saat container database multitenant (MDC) digunakan.

Pastikan Anda menginstal agen Backint sebagai pengguna sidadm.

File log

Jika terjadi error, tinjau log berikut:

  • SAP HANA backup.log, yang berisi informasi tentang operasi pencadangan dan pemulihan SAP HANA.
  • SAP HANA backint.log, yang berisi panggilan ke antarmuka pencadangan yang digunakan oleh agen Backint dan alat pencadangan eksternal lainnya.
  • File log agen backint, yang berisi penginstalan agen Backint dan peristiwa operasional. File log agen Backint terletak di /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs. Log agen Backint dapat menyertakan indikasi error komunikasi dengan Cloud Storage dan masalah konfigurasi atau izin terkait.
  • Log Google Cloud, yang dapat berisi error terkait akun layanan yang digunakan oleh agen Backint. Untuk meninjau log Google Cloud, lihat halaman Logs Explorer di Konsol Google Cloud.

Periksa juga informasi I/O jaringan dan disk pada host SAP HANA untuk memverifikasi aktivitas.

Untuk mengetahui informasi selengkapnya tentang logging agen Backint, lihat Logging untuk agen Backint.

Terjadi masalah konektivitas

Jika agen Backint tidak dapat terhubung ke bucket Cloud Storage, tinjau langkah-langkah konfigurasinya. Secara khusus, periksa item-item berikut:

  • Coba lagi pencadangan atau pemulihan yang gagal untuk memastikan bahwa error tersebut bukan hanya masalah konektivitas sesaat.
  • Jika Anda menggunakan akun layanan VM host dengan agen Backint, cakupan akses untuk Storage tercantum sebagai Baca Tulis pada Cakupan akses Cloud API di halaman Detail instance VM di Konsol Google Cloud. Jika tidak, hentikan instance dan edit cakupan akses tersebut.
  • Jika Anda membuat akun layanan untuk agen Backint:
    • Pada tab Permissions di halaman Bucket details di Konsol Google Cloud, pastikan akun layanan agen Backint terdaftar dan memiliki Storage Object Admin.
    • Pastikan Anda membuat kunci pribadi, menyimpannya di host SAP HANA, dan menentukan dengan benar jalur ke file kunci JSON dalam file konfigurasi agen Backint, /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
  • Semua parameter ditentukan dengan benar dalam file konfigurasi agen Backint parameters.txt dan file global.ini SAP HANA.

Anda dapat menguji akses ke bucket Cloud Storage dari host SAP HANA menggunakan Google Cloud CLI. Dengan menggunakan gcloud CLI, simpan dan akses file teks di bucket Cloud Storage:

  1. Jika Anda tidak menggunakan akun layanan default, lakukan autentikasi dengan Google Cloud sebagai pengguna yang diberi otorisasi ke bucket Cloud Storage atau akun layanan agen Backint: 

    gcloud auth login user-account
     Atau: 
    gcloud auth activate-service-account --key-file=/path/key-file-name.json
     Untuk mengetahui informasi selengkapnya tentang autentikasi Cloud Storage akun layanan, lihat autentikasi gcloud CLI.

  2. Pastikan Anda dapat membuat daftar objek yang disimpan di bucket: 

    gcloud storage ls gs://bucket/

  3. Membuat file pengujian: 

    touch test.txt

  4. Pastikan Anda dapat menulis file pengujian ke bucket: 

    gcloud storage cp test.txt gs://bucket/test.txt

  5. Pastikan Anda dapat membaca file pengujian di bucket: 

    gcloud storage cp gs://bucket/test.txt

Throughput rendah

Jika throughput lebih rendah dari yang diharapkan, pastikan kompresi dinonaktifkan.

Untuk menonaktifkan kompresi, tambahkan flag #DISABLE_COMPRESSION ke file parameters.txt agen Backint.

Error pada multi-streaming

Jika terjadi error saat melakukan multi-streaming, ubah jumlah streaming menjadi satu (1) untuk melihat apakah error tersebut berkaitan dengan jumlah streaming.

Untuk mengetahui informasi selengkapnya tentang logging agen Backint, lihat Pencadangan data multi-streaming dengan agen Backint.