Mengonfigurasi pencadangan dan pemulihan berbasis Backint untuk SAP HANA

Panduan ini menunjukkan cara mengonfigurasi Agen Google Cloud untuk SAP guna melakukan pencadangan dan pemulihan berbasis Backint untuk SAP HANA.

Untuk informasi konseptual tentang fitur ini, yang dapat membantu dalam merencanakan penerapan, lihat Pencadangan dan pemulihan untuk SAP HANA menggunakan Backint.

Untuk informasi tentang cara membuat cadangan berbasis Backint dan memulihkan SAP HANA dengan menggunakannya, lihat Mencadangkan dan memulihkan SAP HANA menggunakan Backint.

Sebelum memulai

  • Validasi penginstalan Agen Google Cloud untuk SAP versi 3.6 (terbaru). Untuk mengetahui petunjuknya, lihat panduan penginstalan untuk skenario Anda.
  • Jika Anda telah menginstal agen di server Solusi Bare Metal, pastikan Anda telah menyelesaikan prasyarat yang diperlukan dan menyiapkan akun layanan. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Agen Google Cloud untuk SAP di Linux.
  • Jika database SAP HANA Anda berjalan di lingkungan lokal, pastikan untuk menyiapkan akun layanan dan kuncinya. Untuk mengetahui informasi tentang cara melakukannya, lihat Mengonfigurasi Agen Google Cloud untuk SAP di Linux.
  • Jika Anda perlu mengaktifkan fitur ini untuk instance Agen Google Cloud untuk SAP yang berjalan di host selain instance Compute Engine atau server Solusi Bare Metal, Anda harus membuat insiden dengan dukungan SAP di komponen BC-OP-LNX-GOOGLE sehingga SAP dan Google Cloud dapat mengevaluasi konfigurasi Anda.
  • Menginstal SAP HANA:

Membuat bucket Cloud Storage

Sebelum mengaktifkan fitur Backint Agen Google Cloud untuk SAP, pastikan ada bucket Cloud Storage untuk menyimpan cadangan Anda. Jika memiliki bucket Cloud Storage, Anda dapat melewati bagian ini.

Untuk informasi tentang cara menyimpan cadangan di bucket Cloud Storage, lihat Menyimpan cadangan di bucket Cloud Storage.

Untuk membuat bucket Cloud Storage:

Konsol Google Cloud

  1. Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.

    Buka halaman Bucket

  2. Klik Buat bucket.
  3. Di halaman Buat bucket, masukkan informasi bucket Anda. Untuk melanjutkan ke langkah berikutnya, klik Lanjutkan.
    • Untuk Beri nama bucket, masukkan nama yang memenuhi persyaratan penamaan bucket.
    • Untuk Pilih tempat untuk menyimpan data, lakukan tindakan berikut:
      • Pilih opsi Jenis lokasi.
      • Pilih opsi Lokasi.
    • Untuk Memilih kelas penyimpanan default untuk data Anda, pilih kelas penyimpanan.
    • Untuk Memilih cara mengontrol akses ke objek, pilih opsi Kontrol akses.
    • Untuk Setelan lanjutan (opsional), tentukan metode enkripsi, kebijakan retensi, atau label bucket.
  4. Klik Buat.

Command line

    Buat bucket Cloud Storage dan konfigurasikan sebagai berikut: 
    gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Menetapkan peran IAM

Agar Agen Google Cloud untuk SAP dapat melakukan operasi pencadangan dan pemulihan untuk SAP HANA, Anda harus memastikan bahwa akun layanan yang digunakan oleh instance Compute Engine atau server Solusi Bare Metal menyertakan peran IAM Storage Object Admin (storage.objectAdmin).

Untuk menambahkan peran ini ke akun layanan Anda, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka halaman IAM.

    Buka IAM

  2. Pilih project Google Cloud Anda.

  3. Identifikasi akun layanan tempat Anda ingin menambahkan peran.

    • Jika akun layanan belum ada dalam daftar akun utama, akun layanan tidak memiliki peran yang ditetapkan pada akun tersebut. Klik Add, lalu masukkan alamat email akun layanan.
    • Jika akun layanan sudah ada di daftar utama, berarti akun tersebut sudah memiliki peran. Klik tombol Edit untuk akun layanan yang ingin diedit.

  4. Dari daftar peran yang tersedia, pilih Storage Object Admin.

  5. Klik Add atau Save untuk menerapkan peran ke akun layanan.

Mengaktifkan akses ke Cloud API dan server metadata

Agen Google Cloud untuk SAP memerlukan akses ke alamat IP dan host Google Cloud berikut selama operasi pencadangan dan pemulihan:

  • Untuk mengakses Cloud Storage, storage.googleapis.com.
  • Untuk server metadata instance Compute Engine:
    • oauth2.googleapis.com, untuk autentikasi
    • 169.254.169.254
    • metadata.google.internal

Jika Agen Google Cloud untuk SAP dan sistem SAP HANA Anda berjalan di instance Compute Engine yang tidak memiliki akses ke internet, Anda harus mengonfigurasi Akses Google Pribadi agar agen dapat berinteraksi dengan Cloud Storage dan, jika menggunakan akun layanan khusus, mengautentikasi dirinya dengan Google Cloud. Untuk mengetahui petunjuknya, lihat Mengonfigurasi Akses Google Pribadi.

Mengaktifkan fitur Backint

Untuk mengaktifkan fitur Backint Agen Google Cloud untuk SAP, selesaikan langkah-langkah berikut:

  1. Sambungkan ke host SAP HANA Anda menggunakan SSH.

    Jika host Anda adalah instance Compute Engine, dari halaman Instance VM di Google Cloud Console, Anda dapat mengklik tombol SSH untuk instance, atau menggunakan metode SSH yang Anda inginkan.

  2. Beralihlah ke administrator sistem SAP HANA:

    sudo su - SID_LCadm

    Ganti SID_LC dengan SID. Gunakan huruf kecil untuk huruf apa pun.

    Perintah ini juga menetapkan beberapa variabel lingkungan, termasuk $SAPSYSTEMNAME, yang ditetapkan dengan SID database SAP HANA Anda.

  3. Aktifkan fitur Backint untuk Agen Google Cloud untuk SAP:

    /usr/bin/google_cloud_sap_agent installbackint

    Atau, untuk menginstal file terkait Backint di host dengan SID yang berbeda, sertakan tanda sid:

    /usr/bin/google_cloud_sap_agent installbackint -sid=DIFFERENT_SID_LC

    Ganti DIFFERENT_SID_LC dengan SID instance SAP HANA yang diperlukan. Gunakan huruf kecil untuk setiap huruf.

    Setelah perintah berhasil dijalankan, semua file yang terkait dengan fitur Backint Agen Google Cloud untuk SAP akan diinstal di direktori /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Ini mencakup file yang diperlukan untuk mengintegrasikan agen dengan SAP HANA. Alat ini juga mendeteksi agen Backint Cloud Storage untuk SAP HANA di host Anda, menonaktifkan agen tersebut, dan menyalin file-nya ke direktori yang dapat dipulihkan di host Anda. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade dari agen Backint.

  4. Konfigurasikan fitur Backint:

    Perintah jalankan

    • Jika database SAP HANA Anda berjalan di instance Compute Engine atau server Solusi Bare Metal, untuk mengonfigurasi fitur Backint agen, jalankan perintah configurebackint. Sebaiknya gunakan pendekatan ini, bukan mengedit file konfigurasi Backint agen.

      /usr/bin/google_cloud_sap_agent configurebackint \
 -f="PATH_TO_PARAMETERS_FILE" \
 -bucket="BUCKET_NAME"

    • Jika database SAP HANA Anda berjalan di lingkungan lokal, konfigurasikan fitur Backint agen dengan menjalankan perintah berikut:

      /usr/bin/google_cloud_sap_agent configurebackint \
 -f="PATH_TO_PARAMETERS_FILE" \
 -bucket="BUCKET_NAME" \
 -service_account_key="PATH_TO_KEY" \
 -log_to_cloud=false \
 -send_metrics_to_monitoring=false

      Ganti kode berikut:

      • PATH_TO_PARAMETERS_FILE: jalur ke file konfigurasi Backint PARAMETERS.json
      • BUCKET_NAME: nama bucket Cloud Storage tempat Anda ingin menyimpan cadangan SAP HANA
      • PATH_TO_KEY: jalur yang sepenuhnya memenuhi syarat ke kunci akun layanan Google Cloud yang dienkode JSON yang Anda siapkan

    Jika perlu, Anda dapat menetapkan lebih banyak parameter saat menjalankan perintah ini. Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.

    Mengedit file konfigurasi

    Sebagai alternatif untuk menjalankan perintah configurebackint agen, Anda dapat mengedit file konfigurasi Backint sebagai berikut:

    1. Buka file konfigurasi Backint:

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

      Ganti SID dengan SID sistem SAP tempat Anda menginstal file terkait Backint.

      Berikut adalah contoh isi file konfigurasi:

      {
 "bucket": "",
 "log_to_cloud": true
}

    2. Agar Agen Google Cloud untuk SAP dapat melakukan operasi pencadangan dan pemulihan berbasis Backint untuk sistem SAP HANA Anda, edit file konfigurasi, lalu tentukan parameter berikut:

      • bucket: menentukan nama bucket Cloud Storage tempat Anda ingin menyimpan cadangan SAP HANA
      • service_account_key: jika Anda telah membuat akun layanan untuk Agen Google Cloud untuk SAP, tentukan jalur absolut ke direktori di host tempat Anda mengupload kunci akun layanan yang dienkode JSON yang sesuai

      Untuk mengetahui informasi selengkapnya, lihat Pertimbangan akun layanan.

    3. Jika database SAP HANA Anda berjalan di lingkungan lokal, pastikan untuk juga menetapkan hal berikut:

      • "log_to_cloud": false
      • "send_metrics_to_monitoring": false

    4. Secara opsional, Anda dapat mengubah parameter konfigurasi lainnya. Untuk mengetahui informasi tentang parameter ini, lihat Parameter konfigurasi.

    5. Simpan file konfigurasi.

Menyesuaikan file konfigurasi Backint

Secara opsional, setelah mengaktifkan fitur Backint Agen Google Cloud untuk SAP, Anda dapat melakukan penyesuaian berikut:

  • Ganti nama file parameters.json.

    Untuk menunjukkan penggantian nama ini, file ini disebut sebagai PARAMETERS.json dalam dokumentasi Agen Google Cloud untuk SAP.

  • Buat file konfigurasi terpisah untuk setiap hal berikut: volume data SAP HANA, volume log SAP HANA, dan katalog cadangan SAP HANA.

    Pastikan untuk menetapkan nama unik untuk setiap file konfigurasi.

  • Pindahkan file konfigurasi ini ke direktori lain. Misalnya, dalam deployment skala besar, Anda dapat menyimpan file konfigurasi terkait Backint dari semua node di direktori bersama yang dapat diakses oleh node. Hal ini dapat memudahkan Anda mengelola file tersebut.

Jika Anda melakukan penyesuaian ini, pastikan untuk menentukan nama file dan jalurnya dengan tepat untuk parameter dalam file global.ini SAP HANA. Untuk mengetahui petunjuknya, lihat Mengonfigurasi SAP HANA untuk fitur Backint.

Mengonfigurasi SAP HANA untuk fitur Backint

Setelah mengaktifkan fitur Backint dari Agen Google Cloud untuk SAP, Anda perlu mengonfigurasi sistem SAP HANA untuk menggunakan fitur ini:

  1. Gunakan SAP HANA Studio atau SAP HANA Cockpit untuk mengedit file konfigurasi global.ini.

  2. Di bagian backup file global.ini, tentukan nilai untuk parameter berikut:

    Parameter Nilai
    data_backup_parameter_file /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_DATA.json.
    parallel_data_backup_backint_channels Untuk pencadangan data multi-streaming, tentukan jumlah saluran dengan mempertimbangkan jenis bucket Cloud Storage yang Anda gunakan, performa yang diperlukan, dan throughput disk.
    log_backup_using_backint Jika Anda menggunakan file konfigurasi terpisah untuk volume log cadangan SAP HANA, tentukan nilai true.
    log_backup_parameter_file

    Jika Anda menggunakan file konfigurasi terpisah untuk volume log cadangan SAP HANA, tentukan nilai berikut: /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_LOG.json.

    Ganti PARAMETERS_LOG dengan nama file konfigurasi yang Anda gunakan untuk pencadangan volume log SAP HANA.
    catalog_backup_using_backint Jika Anda menggunakan file konfigurasi terpisah untuk katalog pencadangan SAP HANA, tentukan nilai true.
    catalog_backup_parameter_file

    Jika Anda menggunakan file konfigurasi terpisah untuk katalog pencadangan SAP HANA, tentukan nilai berikut: /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/PARAMETERS_CATALOG.json.

    Ganti PARAMETERS_CATALOG dengan nama file konfigurasi yang Anda gunakan untuk pencadangan katalog pencadangan SAP HANA.

    Berikut adalah contoh file global.ini yang dikonfigurasi untuk menggunakan fitur Backint Agen Google Cloud untuk SAP:

    [backup]
log_backup_using_backint = true
catalog_backup_using_backint = true
parallel_data_backup_backint_channels = 16
catalog_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-catalog.json
data_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-data.json
log_backup_parameter_file = /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters-log.json

  3. Di bagian persistence file global.ini, tentukan nilai untuk parameter berikut:

    • basepath_logbackup: menentukan direktori di sistem file tempat SAP HANA dapat menyimpan cadangan log saat tidak dapat terhubung ke bucket Cloud Storage Anda; pastikan direktori ini memiliki cukup ruang untuk menyimpan cadangan.
    • basepath_catalogbackup: menentukan direktori di sistem file Anda tempat SAP HANA dapat menyimpan cadangan katalog cadangan SAP HANA saat tidak dapat terhubung ke bucket Cloud Storage Anda; pastikan direktori ini memiliki cukup ruang untuk menyimpan cadangan.

    Parameter basepath_catalogbackup dan basepath_logbackup menampilkan nilai yang sama di bagian persistensi file global.ini

Memvalidasi pencadangan dan pemulihan

Setelah Anda mengaktifkan fitur Backint Agen Google Cloud untuk SAP, pastikan untuk memvalidasinya dengan membuat dan memulihkan cadangan di sistem pengujian.

Untuk pengujian, Anda dapat menggunakan alat diagnostik mandiri bawaan agen. Anda memerlukan ruang disk minimal 18 GB di sistem file untuk menjalankan alat bawaan ini. Untuk menggunakan alat bawaan ini guna memvalidasi pencadangan dan pemulihan, jalankan perintah berikut:

sudo /usr/bin/google_cloud_sap_agent backint -u=IDENTIFIER -p=PATH_TO_PARAMETERS_FILE -f=diagnose

Ganti kode berikut:

  • IDENTIFIER: nilai yang mengidentifikasi eksekusi perintah. ID ini digunakan untuk memberi nama folder sementara yang dibuat di bucket Cloud Storage saat melakukan diagnostik.
  • PATH_TO_PARAMETERS_FILE: jalur ke file PARAMETERS.json Anda

Saat menggunakan alat ini, Anda dapat menggunakan parameter opsional diagnose_file_max_size_gb dan diagnose_tmp_directory. Untuk informasi selengkapnya tentang parameter ini, lihat deskripsinya di Parameter konfigurasi.

Jika Anda telah menginstal agen Backint di host, saat pertama kali menggunakan Agen Google Cloud untuk SAP guna melakukan operasi pencadangan, Agen Google Cloud untuk SAP akan membuat file konfigurasi teks versi JSON. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade dari agen Backint.

Contoh file konfigurasi

Berikut adalah file konfigurasi PARAMETERS.json lengkap dari fitur Backint Agen Google Cloud untuk SAP:

{
  "bucket": "example-bucket-backup",
  "recovery_bucket": "example-bucket-recovery",
  "parallel_streams": 8,
  "service_account_key": "path/to/key/file.json",
  "rate_limit_mb": 100,
  "log_to_cloud": true,
  "log_level": "DEBUG"
}

Parameter konfigurasi

Tabel berikut menjelaskan parameter konfigurasi Agent for SAP Google Cloud yang khusus untuk fitur Backint.

Untuk mengetahui informasi tentang pemetaan antara parameter konfigurasi agen Backint dan Agen Google Cloud untuk SAP, lihat Pemetaan parameter konfigurasi.

Untuk informasi tentang parameter konfigurasi Agen Google Cloud untuk SAP, termasuk parameter yang terkait dengan pengumpulan metrik, lihat panduan penginstalan untuk skenario Anda.

Parameter
bucket

String

Tentukan nama bucket Cloud Storage yang menjadi tujuan penulisan dan pembacaan oleh Agent for SAP Google Cloud. Agen membuat objek cadangan dengan class penyimpanan bucket dan mendukung semua class penyimpanan. Agen menggunakan enkripsi default Compute Engine untuk mengenkripsi data dalam penyimpanan.
recovery_bucket

String

Opsional. Tentukan nama bucket Cloud Storage yang dibaca oleh agen selama operasi RESTORE. Jika Anda tidak menentukan parameter ini, agen akan menggunakan bucket yang ditentukan untuk parameter bucket untuk semua operasi: operasi BACKUP, RESTORE, INQUIRE, DELETE, dan DIAGNOSE.

Meskipun kami merekomendasikan penggunaan parameter ini untuk menyederhanakan pengelolaan konfigurasi untuk operasi salinan sistem dan pembaruan sistem, parameter ini tidak kompatibel dengan argumen CHECK ACCESS USING BACKINT selama operasi pemulihan SAP HANA.

log_to_cloud

Boolean

Opsional. Untuk mengalihkan log terkait Backint dari Agen Google Cloud untuk SAP, ke Cloud Logging, tentukan true. Nilai defaultnya adalah true.

Jika database SAP HANA Anda berjalan di lingkungan lokal, Anda harus menetapkan nilai parameter ini ke false.

Untuk mengetahui informasi tentang file log terkait Backint, lihat Logging.
log_level

String

Opsional. Tentukan level logging untuk fitur Backint dari Agen Google Cloud untuk SAP, tetapkan nilai yang diperlukan. Level log yang tersedia adalah sebagai berikut:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

Nilai defaultnya adalah INFO. Jangan ubah level logging kecuali jika Anda diarahkan oleh Cloud Customer Care.
compress

Boolean

Opsional. Tentukan apakah Agen Google Cloud untuk SAP akan mengaktifkan kompresi saat menulis cadangan ke bucket Cloud Storage. Nilai defaultnya adalah false.

Sebaiknya jangan aktifkan kompresi. Meskipun kompresi mengurangi biaya penyimpanan untuk pencadangan di Cloud Storage, kompresi memerlukan lebih banyak pemrosesan CPU selama operasi pencadangan dan memperlambat throughput pencadangan yang efektif.

Terlepas dari parameter ini, Agen Google Cloud untuk SAP mendukung file cadangan yang dikompresi dan tidak dikompresi selama operasi pemulihan.
encryption_key

String

Opsional. Tentukan jalur ke kunci enkripsi yang disediakan pelanggan yang telah Anda konfigurasikan untuk bucket Cloud Storage yang akan digunakan untuk mengenkripsi cadangan. Pastikan untuk menentukan jalur yang sepenuhnya memenuhi syarat ke kunci AES-256 yang dienkode base64.

Anda tidak dapat menentukan parameter encryption_key dengan parameter kms_key atau parallel_streams.
kms_key

String

Opsional. Tentukan jalur ke kunci enkripsi yang dikelola pelanggan yang telah Anda konfigurasikan untuk bucket Cloud Storage yang akan digunakan untuk mengenkripsi cadangan. Tentukan jalur menggunakan format projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KEY_RING_NAME/cryptoKeys/KMS_KEY_NAME, dengan:

  • KMS_PROJECT_ID: ID project Google Cloud tempat kunci KMS berada
  • LOCATION: Lokasi Cloud KMS tempat kunci KMS Anda berada
  • KEY_RING_NAME: nama key ring yang berisi kunci KMS
  • KMS_KEY_NAME: nama kunci KMS

Jika sistem SAP HANA Anda berjalan di instance Compute Engine, kunci tersebut harus dapat diakses oleh instance tersebut. Jika sistem SAP HANA Anda berjalan di host selain instance Compute Engine, kunci Cloud KMS harus dapat diakses oleh akun layanan yang digunakan oleh Agen Google Cloud untuk SAP. Untuk informasi selengkapnya, lihat Akun layanan.

Anda tidak dapat menentukan parameter kms_key dengan parameter encryption_key atau parallel_streams.
folder_prefix

String

Opsional. Tentukan untuk menetapkan awalan bagi folder di bucket Cloud Storage tempat Agen Google Cloud untuk SAP menulis dan membaca. Anda dapat menggunakan parameter ini untuk mengatur pencadangan instance SAP HANA yang berbeda di bucket Cloud Storage yang sama. Anda dapat menentukan satu folder, seperti folder1 atau jalur folder multi-level, seperti folder1/folder2/folder3.

Awalan ini disisipkan sebagai folder di antara nilai BUCKET_NAME dan SID di jalur untuk pencadangan SAP HANA Anda di Cloud Storage. Untuk informasi selengkapnya, lihat Penyesuaian yang didukung.

Parameter ini tersedia mulai agen versi 3.1.
recovery_folder_prefix

String

Opsional. Tentukan untuk menetapkan awalan bagi folder di bucket Cloud Storage yang dibaca agen selama operasi RESTORE. Anda dapat menggunakan parameter ini untuk mengatur cadangan instance SAP HANA yang berbeda di bucket Cloud Storage yang sama. Anda dapat menentukan satu folder, seperti folder1 atau jalur folder multi-level, seperti folder1/folder2/folder3. Untuk informasi selengkapnya, lihat Penyesuaian yang didukung.

Parameter ini tersedia mulai agen versi 3.1.

Meskipun kami merekomendasikan penggunaan parameter ini untuk menyederhanakan pengelolaan konfigurasi untuk operasi salinan sistem dan pembaruan sistem, parameter ini tidak kompatibel dengan argumen CHECK ACCESS USING BACKINT selama operasi pemulihan SAP HANA.

shorten_folder_path

Boolean

Opsional. Tentukan untuk mempersingkat jalur objek di bucket Cloud Storage yang dibaca dan ditulis oleh agen selama semua operasi Backint. Untuk informasi selengkapnya, lihat Penyesuaian yang didukung.

Parameter ini tersedia mulai agen versi 3.3.
retries

Int

Menentukan frekuensi maksimum Agen Google Cloud untuk SAP mencoba kembali upaya baca atau tulis yang gagal ke Cloud Storage. Nilai defaultnya adalah 5, yang juga merupakan nilai yang direkomendasikan.
parallel_streams

Int

Opsional. Tentukan parameter ini untuk mengaktifkan upload paralel cadangan ke bucket Cloud Storage Anda. Nilai yang Anda tentukan untuk parameter ini adalah jumlah maksimum streaming upload paralel yang dapat digunakan oleh Agen Google Cloud untuk SAP. Nilai maksimumnya adalah 32. Setiap nilai yang melebihi nilai ini akan dibatasi hingga 32.

Nilai defaultnya adalah 1, yang menonaktifkan upload paralel.

Jika ingin mengaktifkan upload paralel untuk data streaming, atau jika bucket Cloud Storage Anda memiliki kebijakan retensi, Anda juga harus menetapkan xml_multipart_upload ke true.

Jangan aktifkan upload paralel jika salah satu hal berikut berlaku:

  • Bucket Cloud Storage target menggunakan kebijakan retensi.
  • Anda telah menentukan parameter encryption_key atau kms_key.

Jika salah satu kondisi sebelumnya terpenuhi, agen akan keluar dengan status 1. Untuk mengetahui informasi tentang upload paralel, lihat Upload paralel.
xml_multipart_upload

Boolean

Opsional. Menentukan apakah metode upload multibagian XML API digunakan saat menulis cadangan ke bucket Cloud Storage atau tidak. Nilai defaultnya adalah false.

Parameter ini tersedia mulai agen versi 3.2.

Untuk menggunakan metode upload multibagian XML API, parallel_streams harus memiliki nilai yang lebih besar dari 1. Jika Anda menetapkan xml_multipart_upload ke true, tetapi tidak menentukan parallel_streams, parallel_streams akan otomatis diberi nilai 16.

Sebaiknya gunakan xml_multipart_upload hanya untuk melakukan paralelisasi pencadangan log atau katalog. Untuk melakukan paralelisasi pencadangan data, sebaiknya tetapkan parallel_data_backup_backint_channels di bagian backup file global.ini Anda.

Untuk informasi tentang cara membuat file parameter terpisah untuk pencadangan log dan data, atau cara menetapkan nilai untuk parallel_data_backup_backint_channels, lihat Mengonfigurasi SAP HANA untuk fitur Backint.

Jika terjadi kegagalan, upload multipart XML akan dibatalkan secara otomatis dan data yang diupload akan dihapus. Sebaiknya tetapkan kondisi siklus proses untuk AbortIncompleteMultipartUpload guna memastikan data dihapus jika operasi upload gagal.
storage_class

String

Opsional. Tentukan class penyimpanan yang digunakan saat menulis cadangan ke bucket Cloud Storage. Class penyimpanan yang tersedia adalah sebagai berikut:

  • STANDARD
  • NEARLINE
  • COLDLINE
  • ARCHIVE

Nilai defaultnya adalah STANDARD.

Parameter ini tersedia mulai agen versi 3.2.
metadata

Map<String, String>

Opsional. Tentukan kolom kunci:nilai untuk disimpan sebagai metadata untuk objek saat menulis cadangan ke bucket Cloud Storage.

Parameter ini tersedia mulai agen versi 3.3.

Format dalam contoh file konfigurasi PARAMETERS.json adalah sebagai berikut:

{
  "bucket": "example-bucket-backup",
  "metadata": {"key1": "value1", "key2": "value2"},
  "log_to_cloud": true
}

Metadata default yang ditulis adalah {"X-Backup-Type": "PIPE"} atau {"X-Backup-Type": "FILE"}, bergantung pada jenis file.

custom_time

String

Opsional. Tentukan tanggal dan waktu yang ingin Anda tetapkan untuk metadata Custom-Time untuk cadangan yang Anda upload ke Cloud Storage. Anda harus menentukan tanggal dan waktu dalam format yang ditentukan di Custom-Time.

Parameter ini tersedia mulai agen versi 3.4.

Anda dapat menetapkan parameter ini dengan nilai UTCNow, yang menetapkan metadata Custom-Time dengan tanggal dan waktu UTC saat pencadangan dibuat.

Dari agen versi 3.6, Anda dapat menetapkan tanggal mendatang untuk metadata Custom-Time menggunakan UTCNow+NUMBERd. Misalnya, untuk menetapkan Custom-Time ke 30 hari dari waktu pembuatan cadangan, tetapkan konfigurasi Anda seperti contoh berikut: 

{
  "bucket": "example-bucket-backup",
  "custom_time": "UTCNow+30d",
  "log_to_cloud": true
}

Berikut adalah contoh cara menentukan parameter ini dengan nilai tanggal-waktu dalam file PARAMETERS.json:

{
  "bucket": "example-bucket-backup",
  "custom_time": "2024-06-25T13:25:00Z",
  "log_to_cloud": true
}
rate_limit_mb

Int

Opsional. Tentukan batas atas, dalam MB, untuk bandwidth jaringan keluar Compute Engine selama operasi pencadangan atau pemulihan. Secara default, Google Cloud tidak membatasi bandwidth jaringan untuk Agen Google Cloud untuk SAP. Saat Anda menetapkan parameter ini, throughput mungkin bervariasi, tetapi tidak akan melebihi batas yang ditentukan.
service_account_key

String

Jika Agen Google Cloud untuk SAP tidak berjalan di instance Compute Engine, tentukan jalur yang sepenuhnya memenuhi syarat ke akun layanan Google Cloud yang dienkode JSON. Jika Agen Google Cloud untuk SAP berjalan di instance Compute Engine, sebaiknya jangan tentukan parameter ini, dan gunakan autentikasi default Compute Engine.

Menentukan parameter ini akan mengarahkan Agen Google Cloud untuk SAP menggunakan kunci akun layanan saat melakukan autentikasi ke Cloud Storage.
diagnose_file_max_size_gb

Int

Opsional. Tentukan batas atas untuk ukuran file sementara, dalam GB, yang dibuat dan dihapus oleh alat diagnostik mandiri agen. Nilai defaultnya adalah 16 GB.

Parameter ini tersedia mulai agen versi 3.3.

Agar alat diagnostik mandiri berhasil beroperasi, Anda harus memastikan bahwa penyimpanan yang tersedia di sistem file Anda setidaknya 2-3 GB lebih besar dari nilai diagnose_file_max_size_gb.
diagnose_tmp_directory

String

Opsional. Tentukan direktori yang digunakan untuk membaca dan menulis file sementara untuk alat diagnostik mandiri agen. Nilai defaultnya adalah /tmp/backint-diagnose.

Parameter ini tersedia mulai agen versi 3.3.
send_metrics_to_monitoring

Boolean

Opsional. Menentukan apakah agen dapat mengumpulkan metrik yang terkait dengan status dan throughput file yang diupload atau didownload selama operasi Backint. Agen mengirimkan metrik yang dikumpulkan ke Cloud Monitoring.

Parameter ini tersedia mulai agen versi 3.3.

Nilai defaultnya adalah true. Jika database SAP HANA Anda berjalan di lingkungan lokal, Anda harus menetapkan nilai parameter ini ke false. Untuk mengetahui informasi tentang metrik terkait Backint, lihat Pengumpulan metrik Backint.
threads

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan jumlah thread pekerja. Nilai defaultnya adalah jumlah prosesor di host.
file_read_timeout_ms

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan jumlah waktu maksimum, dalam milidetik, yang ditunggu Agen Google Cloud untuk SAP guna membuka file cadangan. Nilai default-nya adalah 60000 (60 detik).
buffer_size_mb

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan parameter ini untuk mengontrol ukuran permintaan HTTPS ke Cloud Storage selama operasi pencadangan atau pemulihan. Ukuran buffer default adalah 100 MB, yang berarti bahwa satu aliran permintaan HTTPS ke atau dari Cloud Storage tetap terbuka hingga data sebesar 100 MB ditransfer. Ukuran buffer maksimum adalah 250 MB.

Karena Agen Google Cloud untuk SAP mencoba ulang permintaan HTTPS yang gagal beberapa kali sebelum menggagalkan operasi, ukuran buffer yang lebih kecil dari 100 MB akan menghasilkan lebih sedikit data yang perlu dikirim ulang jika permintaan gagal. Ukuran buffer yang lebih besar dapat meningkatkan throughput, tetapi memerlukan lebih banyak penggunaan memori dan lebih banyak waktu untuk mengirim ulang data jika terjadi kegagalan permintaan.

Jika Anda menggunakan parameter parallel_streams, penggunaan memori yang diperlukan harus dikalikan dengan nilai tersebut karena setiap streaming memerlukan buffering-nya sendiri untuk memproses permintaan HTTPS.
retry_backoff_initial

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan nilai awal, dalam detik, untuk periode percobaan ulang yang digunakan dalam percobaan ulang jaringan backoff eksponensial. Nilai defaultnya adalah 10.
retry_backoff_max

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan nilai maksimum, dalam detik, untuk periode percobaan ulang yang digunakan dalam percobaan ulang jaringan backoff eksponensial. Nilai defaultnya adalah 300.
retry_backoff_multiplier

Float

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan pengganda untuk periode percobaan ulang yang digunakan dalam percobaan ulang jaringan backoff eksponensial. Pengganda harus lebih besar dari 1 dan nilai default-nya adalah 2.
log_delay_sec

Int

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Menentukan penundaan logging, dalam detik, untuk pembaruan progres selama operasi baca dan tulis ke bucket Cloud Storage. Nilai defaultnya adalah 60.
client_endpoint

String

Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika diminta oleh Customer Care. Nilai defaultnya jarang perlu diubah.

Tentukan endpoint klien Cloud Storage. Nilai defaultnya adalah storage.googleapis.com.

Pemecahan masalah

Untuk memecahkan masalah terkait Agen Google Cloud untuk SAP versi 3.6 (terbaru), lihat Panduan pemecahan masalah Agen Google Cloud untuk SAP.

Mendapatkan dukungan

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 untuk SAP HANA.

Langkah selanjutnya