Agen Backint Cloud Storage untuk panduan penginstalan SAP HANA

Penting: Untuk penginstalan baru, daripada menggunakan agen Backint Cloud Storage untuk SAP HANA, sebaiknya gunakan penggantinya - Agen Google Cloud untuk SAP. Mulai versi 3.0, Agent for SAP dari Google Cloud menggabungkan pengumpulan metrik Agen Host SAP dengan fitur lain seperti pencadangan dan pemulihan berbasis Backint untuk SAP HANA.

Jika Anda menggunakan agen Backint, sebaiknya Anda beralih menggunakan Agen untuk SAP Google Cloud versi 3.2 (terbaru) sesegera mungkin, tetapi sebelum dukungan untuk agen Backint dihentikan. Untuk mengetahui petunjuk upgrade, lihat Mengupgrade ke Agen Google Cloud untuk SAP dari agen Google Cloud lainnya.

Dukungan untuk agen Backint berakhir pada Februari 2025. Agen ini tidak didukung pada jenis mesin Compute Engine yang tersedia secara umum (GA) setelah Februari 2024.

Petunjuk ini menunjukkan cara menginstal dan mengonfigurasi agen Backint Cloud Storage untuk SAP HANA (agen Backint).

Untuk mengetahui informasi tentang opsi konfigurasi agen Backint, lihat agen Backint Cloud Storage untuk ringkasan SAP HANA.

Prasyarat

Sebelum dapat menginstal agen Backint, Anda harus menginstal SAP HANA terlebih dahulu. Untuk menginstal SAP HANA di Google Cloud, lihat Panduan Deployment SAP HANA.

Untuk mengetahui informasi cara menginstal SAP HANA di Solusi Bare Metal, lihat panduan perencanaan Solusi Bare Metal SAP HANA di Solusi Bare Metal.

Jika VM host tidak memiliki akses ke internet, Anda perlu mengonfigurasi Akses Google Pribadi sehingga agen Backint dapat mengakses Google Cloud API. Untuk mengonfigurasi Akses Google Pribadi, lihat Mengonfigurasi Akses Google Pribadi.

Catatan: Jika Anda perlu menginstal agen Backint di host yang bukan merupakan mesin virtual (VM) Compute Engine atau Solusi Bare Metal tanpa -mesin logam, buat insiden dengan dukungan SAP di komponen BC-OP-LNX-GOOGLE sehingga SAP dan Google Cloud dapat mengevaluasi konfigurasi Anda.

Membuat bucket Cloud Storage untuk pencadangan

Sebelum dapat mengonfigurasi agen Backint, Anda harus membuat bucket Cloud Storage untuk menyimpan cadangan.

Untuk membuat bucket Cloud Storage, gunakan Google Cloud Console.

Untuk mengetahui informasi tentang opsi bucket, lihat Menyimpan cadangan di bucket Cloud Storage.

1. Buka browser Cloud Storage di Konsol Google Cloud.

   Buka browser Cloud Storage

2. Klik CREATE BUCKET.

3. Beri nama bucket Anda, lalu klik Continue.

4. Ikuti petunjuk untuk memilih opsi bucket.

   Catatan: Opsi enkripsi yang disajikan di Google Cloud Console selama pembuatan bucket umumnya berlaku untuk objek dalam penyimpanan di bucket. Agen Backint memberikan opsi enkripsi tambahan untuk cadangan Anda yang terpisah dari opsi enkripsi bucket.

5. Klik Create.

6. Untuk mengonfigurasi izin bucket, klik tab perizinan. Secara default, sebagai pemilik bucket, Anda memiliki akses baca-tulis ke bucket. Anda juga dapat mengizinkan akun utama lain untuk mengakses bucket Anda.

Menginstal agen Backint di host SAP HANA

Agen Backint diinstal di sistem file bersama yang sama dengan database SAP HANA.

Dalam deployment penyebaran skala SAP HANA, instal agen Backint pada setiap node sistem SAP HANA. Untuk menyederhanakan administrasi, Anda dapat menyimpan file konfigurasi di lokasi bersama yang dapat diakses oleh semua node dalam deployment Anda, seperti /hana/shared.

1. Sambungkan ke host SAP HANA Anda menggunakan SSH. Jika host Anda adalah VM Compute Engine, dari halaman instance VM, Anda dapat mengeklik tombol SSH untuk instance VM Anda, atau menggunakan metode SSH yang Anda inginkan.

2. Beralihlah ke administrator sistem SAP HANA.

   sudo su - SID_LCadm
   

3. Download dan instal agen Backint.

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/install.sh
   chmod +x install.sh
   ./install.sh
   

   Catatan: jika Anda memperbarui instance agen Backint yang ada ke versi baru, ikuti petunjuk dalam Memperbarui agen Backint ke versi baru.

   Skrip install.sh akan melakukan tindakan berikut:

   • Menginstal agen Backint sebagai file JAR di /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Mendownload versi Java Runtime Environment yang kompatibel.
   • Siapkan skrip backint yang memanggil agen Backint. Jangan ubah skrip backint kecuali diperintahkan untuk melakukannya oleh Cloud Customer Care.
   • Setelah selesai, akan muncul pesan yang meminta Anda untuk mengupdate file parameter.txt dan menyiapkan autentikasi. Lihat Mengonfigurasi agen Backint dan SAP HANA untuk mengetahui detail selengkapnya.

4. Jika salah satu skenario berikut terjadi, Anda perlu membuat akun layanan untuk agen Backint:

   • Anda memerlukan agen Backint untuk menggunakan set izin resource yang berbeda dengan yang digunakan VM Compute Engine host Anda.
   • SAP HANA sedang berjalan di Solusi Bare Metal.
   • SAP HANA tidak berjalan di Google Cloud.

   Untuk membuat akun layanan bagi agen Backint:

   1. Di Konsol Google Cloud, buka halaman Service accounts.

      Buka halaman Service Accounts

   2. Pilih project Google Cloud Anda.

   3. Klik Buat Akun Layanan.

   4. Tentukan nama untuk akun layanan dan deskripsi (opsional).

   5. Klik Create and Continue.

   6. Klik Continue untuk membuat akun layanan tanpa izin.

   7. Berikan akses ke akun layanan kepada pengguna lain sebagaimana mestinya.

   8. Klik Done.

   9. Pada halaman Service accounts di Google Cloud Console, klik alamat email akun layanan yang baru saja Anda buat.

   10. Di bawah nama akun layanan, klik tab Keys.

   11. Klik menu drop-down Add Key, lalu pilih Create new key untuk membuat kunci akun layanan.

   12. Terima JSON sebagai jenis kunci dan klik Create. Kunci pribadi disimpan ke komputer Anda.

5. Upload file kunci JSON ke host SAP HANA.

   • Simpan file .json di direktori yang dapat diakses pengguna SID_LCadm, seperti /usr/sap/SID/home
   • Pastikan pengguna SID_LCadm diberi otorisasi untuk membaca file tersebut.

6. Update bucket Cloud Storage Anda untuk memberikan izin kepada akun layanan agar dapat menggunakan bucket:

   1. Klik nama bucket Anda di browser Cloud Storage.

      Buka browser Cloud Storage

   2. Klik tab Permissions.

   3. Klik Add principals.

   4. Di kolom New principals, masukkan alamat email lengkap akun layanan. Contoh:

      [e-mail]

   5. Klik drop-down Select a role dan masukkan Storage Object Admin.

   6. Klik Save.

Mengonfigurasi agen Backint dan SAP HANA

Anda mengonfigurasi agen Backint dengan menentukan parameter dalam file konfigurasi teks biasa.

Anda dapat menggunakan satu konfigurasi yang sama untuk semua jenis pencadangan (data, log, dan katalog), atau Anda dapat menggunakan konfigurasi yang berbeda untuk setiap jenis cadangan dengan membuat file konfigurasi terpisah untuk masing-masing cadangan.

Anda dapat menentukan jalur ke setiap file konfigurasi agen Backint di SAP HANA dengan menentukan parameter dalam file global.ini.

1. Konfigurasikan agen Backint dengan menentukan parameter dalam file parameters.txt. Anda dapat mengganti nama file sesuai kebutuhan.

   1. Gunakan metode pilihan Anda untuk mengedit file parameters.txt. File ini diinstal di direktori berikut.

      /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
      

      Anda dapat mengganti nama file parameters.txt dan menggunakan file konfigurasi yang berbeda untuk pencadangan data, log, dan katalog.

      Untuk deskripsi parameter konfigurasi, serta rekomendasi performa, lihat Opsi konfigurasi untuk agen Backint.

   2. Tentukan nama bucket Cloud Storage yang akan digunakan untuk pencadangan.

      #BUCKET bucket-name
      

   3. Jika Anda membuat akun layanan dan kunci pribadi untuk agen Backint, tentukan jalur ke file kunci JSON.

      #SERVICE_ACCOUNT /path/key-file-name.json

   Contoh berikut menunjukkan isi file parameters.txt yang valid. Perlu diperhatikan bahwa # dalam contoh adalah bagian dari sintaksis dan bukan berarti baris tersebut merupakan komentar.

   #BUCKET hana-backups
   #DISABLE_COMPRESSION
   #SERVICE_ACCOUNT /usr/sap/ABC/home/example-project-123456-d591d63bba6f.json

2. Opsional: Konfigurasikan agen Backint untuk mengabaikan atau menggunakan proxy untuk pencadangan dan pemulihan. Secara default, agen Backint mengabaikan proxy HTTP.

   Peringatan: Pemilihan rute cadangan melalui proxy akan berdampak negatif pada performa dan keandalan semua traffic proxy selama pengiriman atau pengambilan cadangan dari Cloud Storage. Google Cloud sangat merekomendasikan agar agen Backint mengabaikan proxy HTTP.

   Kueri ke server metadata instance harus selalu mengabaikan server proxy HTTP. Gunakan parameter proxy http atau https sebagaimana diperlukan oleh server proxy Anda.

   Untuk menentukan setelan server proxy bagi agen Backint, edit file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/jre/conf/net.properties.

   Misalnya, konfigurasi berikut menentukan server proxy HTTPS:

   http.proxyHost=proxy-host
   http.proxyPort=proxy-port
   http.nonProxyHosts=localhost|127.*|[::1]|169.254.169.254|metadata.google.internal
   https.proxyHost=proxy-host
   https.proxyPort=proxy-port
   

   Untuk mengetahui informasi selengkapnya tentang penggunaan agen Backint dengan proxy, lihat Agen Backint dan Proxy.

3. Konfigurasi SAP HANA untuk menggunakan agen Backint:

   1. Gunakan SAP HANA Studio atau SAP HANA Cockpit untuk menetapkan parameter berikut di bagian backup file konfigurasi global.ini ke nilai yang ditampilkan dalam tabel. Anda tidak perlu memulai ulang SAP HANA setelah melakukan perubahan ini.

      Jika Anda menggunakan file konfigurasi yang berbeda untuk setiap jenis cadangan yang berbeda, tentukan file konfigurasi yang berbeda seperti yang ditunjukkan dalam tabel berikut. Jika tidak, tentukan file konfigurasi yang sama untuk semua jenis.

      Parameter	Nilai
      catalog_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.txt
      catalog_backup_using_backint	true
      data_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.txt
      log_backup_parameter_file	/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.txt
      log_backup_using_backint	true

   2. Gunakan SAP HANA Studio untuk menentukan nilai yang sama bagi basepath_catalogbackup dan basepath_logbackup di bagian persistence dari file global.ini. Contoh:

      

4. Uji penginstalan dengan membuat cadangan di bucket Cloud Storage dan melakukan pemulihan dari cadangan.

5. Untuk mendukung fungsi update otomatis agen Backint, aktifkan permintaan HTTP jarak jauh dari VM SAP HANA ke https://www.googleapis.com/.

6. Secara opsional, aktifkan Cloud Logging.

   • Jika SAP HANA berjalan di VM Compute Engine, tambahkan pengendali com.google.cloud.logging.LoggingHandler ke properti com.google.cloud.partners.handlers di file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties.
   • Jika SAP HANA berjalan di luar Google Cloud, instal Google Cloud CLI dan konfigurasikan login default aplikasi menggunakan perintah gcloud auth application-default login.

Mengupdate agen Backint ke versi baru

Sebelum mengupdate agen Backint ke versi baru di lingkungan produksi, pastikan Anda menguji versi baru tersebut di lingkungan non-produksi. Untuk informasi tentang apa saja yang ditawarkan oleh versi agen Backint, lihat catatan rilis untuk versi tersebut.

Untuk mengupdate agen Backint ke versi baru:

1. Pastikan tidak ada pencadangan data yang sedang berlangsung atau dijadwalkan untuk periode yang tumpang-tindih dengan update.

2. Nonaktifkan pencadangan log otomatis dengan menetapkan parameter enable_auto_log_backup parameter SAP HANA ke no. Untuk mengetahui petunjuknya, lihat dokumen SAP HANA Mengaktifkan dan Menonaktifkan Pencadangan Log Otomatis.

3. Aktifkan permintaan HTTP jarak jauh dari host SAP HANA ke https://www.googleapis.com/.

4. Sebagai SID_LCadm, di host SAP HANA, instal versi baru:

   curl -O https://storage.googleapis.com/cloudsapdeploy/backint-gcs/update.sh
   chmod +x update.sh
   ./update.sh

   Skrip update.sh akan melakukan tindakan berikut:

   • Menginstal versi baru agen Backint di /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Mengupdate skrip backint untuk memanggil versi agen Backint baru.
   • Mengupdate nomor versi di VERSION.txt.
   • Menyimpan skrip update.sh secara lokal di /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
   • Memberikan pesan jika sudah selesai.

   Proses update tidak mengubah atau mengganti file parameters.txt Anda yang ada. Untuk menggunakan opsi baru yang diperkenalkan dalam versi baru, Anda harus menambahkan parameter yang sesuai ke file parameters.txt yang sudah ada.

   Proses update membiarkan agen Backint versi sebelumnya dalam direktori /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs, sehingga Anda dapat kembali ke versi sebelumnya jika diperlukan.

5. Aktifkan pencadangan log otomatis dengan menetapkan parameter enable_auto_log_backup parameter SAP HANA ke yes. Untuk mengetahui petunjuknya, lihat dokumen SAP HANA Mengaktifkan dan Menonaktifkan Pencadangan Log Otomatis.

6. Pantau sistem Anda agar pencadangan berhasil dilakukan.

Mengembalikan ke versi sebelumnya

Jika mengalami masalah dengan agen Backint versi baru dan dukungan Google Cloud atau SAP menyarankan untuk kembali ke versi sebelumnya, Anda dapat melakukannya dengan mengedit file skrip backint.

Anda tidak perlu menghapus parameter apa pun yang mungkin telah ditambahkan untuk versi baru di file parameter.txt. Agen Backint versi sebelumnya mengabaikan parameter dari versi yang lebih baru.

Untuk kembali ke versi sebelumnya:

1. Sebagai SID_LCadm, buka skrip backint untuk mengedit. Contoh:

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/backint

2. Ubah nama file JAR agen Backint menjadi nama file JAR versi sebelumnya.

   Misalnya, jika Anda melakukan penggantian dari versi 1.0.6 ke versi 1.0.4, Anda perlu mengubah:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.6.jar

   menjadi:

   -jar /usr/sap/ABC/SYS/global/hdb/opt/backint/backint-gcs/sap-backint-gcs-1.0.4.jar

3. Buka file VERSION.txt untuk mengedit dan tentukan nomor versi sebelumnya. Anda harus melakukan ini agar mekanisme update mengetahui versi yang Anda jalankan.

   vi /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/VERSION.txt

4. Uji agen Backint dengan memicu pencadangan.

Pemecahan masalah

Untuk memecahkan masalah dengan agen Backint untuk SAP HANA, lihat Memecahkan masalah agen Backint untuk SAP HANA.

Mendapatkan dukungan untuk agen Backint

Jika Anda memerlukan bantuan untuk menyelesaikan masalah dengan agen Backint untuk SAP HANA, kumpulkan informasi diagnostik yang diperlukan dan hubungi Cloud Customer Care. Untuk informasi selengkapnya, lihat Agen Backint untuk informasi diagnostik SAP HANA.