Mengonfigurasi pencadangan dan pemulihan berbasis Backint untuk SAP HANA

Panduan ini menunjukkan cara mengonfigurasi Agen Google Clouduntuk SAP agar dapat melakukan pencadangan dan pemulihan berbasis Backint untuk SAP HANA.

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

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

Sebelum memulai

• Validasi penginstalan versi 3.8 (terbaru) AgenGoogle Clouduntuk SAP. 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. Google Cloud
• 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. Google Cloud
• Jika Anda perlu mengaktifkan fitur ini untuk instance Agen untuk SAPGoogle Cloudyang 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 agar SAP dan Google Cloud dapat mengevaluasi konfigurasi Anda.
• Instal SAP HANA:
  • Untuk mengetahui informasi tentang mengotomatiskan penginstalan SAP HANA diGoogle Cloud menggunakan Terraform, lihat panduan deployment untuk skenario Anda.
  • Untuk mengetahui informasi cara menginstal SAP HANA di Solusi Bare Metal, lihat panduan perencanaan SAP HANA di Solusi Bare Metal.

Membuat bucket Cloud Storage

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

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

Untuk membuat bucket Cloud Storage:

Google Cloud console

1. In the Google Cloud console, go to the Cloud Storage Buckets page.

   Go to Buckets

2. Click Create.
3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
   1. In the Get started section, do the following:
      • Enter a globally unique name that meets the bucket naming requirements.
      • To add a bucket label, expand the Labels section (), click Add label, and specify a key and a value for your label.
   2. In the Choose where to store your data section, do the following:
      1. Select a Location type.
      2. Choose a location where your bucket's data is permanently stored from the Location type drop-down menu.
         • If you select the dual-region location type, you can also choose to enable turbo replication by using the relevant checkbox.
      3. To set up cross-bucket replication, select Add cross-bucket replication via Storage Transfer Service and follow these steps:

         Set up cross-bucket replication

         1. In the Bucket menu, select a bucket.

         2. In the Replication settings section, click Configure to configure settings for the replication job.

            The Configure cross-bucket replication pane appears.

            • To filter objects to replicate by object name prefix, enter a prefix that you want to include or exclude objects from, then click Add a prefix.
            • To set a storage class for the replicated objects, select a storage class from the Storage class menu. If you skip this step, the replicated objects will use the destination bucket's storage class by default.
            • Click Done.
   3. In the Choose how to store your data section, do the following:
      1. Select a default storage class for the bucket or Autoclass for automatic storage class management of your bucket's data.
      2. To enable hierarchical namespace, in the Optimize storage for data-intensive workloads section, select Enable hierarchical namespace on this bucket.
         Note: You cannot enable hierarchical namespace in existing buckets.
   4. In the Choose how to control access to objects section, select whether or not your bucket enforces public access prevention, and select an access control method for your bucket's objects.
      Note: You cannot change the Prevent public access setting if this setting is enforced at an organization policy.
   5. In the Choose how to protect object data section, do the following:
      • Select any of the options under Data protection that you want to set for your bucket.
        • To enable soft delete, click the Soft delete policy (For data recovery) checkbox, and specify the number of days you want to retain objects after deletion.
        • To set Object Versioning, click the Object versioning (For version control) checkbox, and specify the maximum number of versions per object and the number of days after which the noncurrent versions expire.
        • To enable the retention policy on objects and buckets, click the Retention (For compliance) checkbox, and then do the following:
          • To enable Object Retention Lock, click the Enable object retention checkbox.
          • To enable Bucket Lock, click the Set bucket retention policy checkbox, and choose a unit of time and a length of time for your retention period.
      • To choose how your object data will be encrypted, expand the Data encryption section (), and select a Data encryption method.
4. Click Create.

Command line

Create a Cloud Storage bucket and configure it as follows:
• Ganti STORAGE_CLASS dengan kelas penyimpanan pilihan Anda.
• Ganti LOCATION dengan lokasi pilihan Anda (ASIA, EU, atau US)
• Ganti BUCKET_NAME dengan nama bucket yang memenuhi persyaratan nama bucket.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Catatan: Opsi enkripsi yang disajikan di konsol Google Cloud selama pembuatan bucket umumnya berlaku untuk objek dalam penyimpanan di bucket. Fitur Backint dari Agen Google Clouduntuk SAP menyediakan opsi enkripsi tambahan untuk cadangan Anda yang terpisah dari opsi enkripsi bucket. Untuk mengetahui informasi selengkapnya, lihat Opsi enkripsi untuk cadangan.

Menetapkan peran IAM

Untuk mengizinkan Agen Google Cloud's untuk SAP 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 Anda 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.

Untuk tingkat akses terperinci, Anda dapat menetapkan izin IAM berikut ke peran kustom untuk akun layanan Anda di tingkat project:

• storage.objects.list
• storage.objects.create

Anda juga harus menetapkan Kebijakan IAM di bucket dengan memberikan izin IAM berikut kepada prinsipal Anda:

• storage.objects.get
• storage.objects.update
• storage.objects.delete

Tambahkan izin berikut jika Anda ingin melakukan upload multibagian:

• storage.multipartUploads.create
• storage.multipartUploads.abort

Untuk mengetahui informasi selengkapnya tentang cara membuat peran khusus, lihat artikel Membuat dan mengelola peran khusus. Untuk mengetahui informasi selengkapnya tentang pemberian peran kustom kepada akun utama untuk akses tingkat bucket, lihat Menambahkan akun utama ke kebijakan tingkat bucket.

Mengaktifkan akses ke Cloud API dan server metadata

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

• 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 Clouduntuk 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 petunjuknya, lihat Mengonfigurasi Akses Google Pribadi.

Mengaktifkan fitur Backint

Untuk mengaktifkan fitur Backint Agent for SAP Google Cloud, 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 konsol Google Cloud , Anda dapat mengklik tombol SSH untuk instance Anda, atau menggunakan metode SSH pilihan Anda.

2. Beralihlah ke administrator sistem SAP HANA:

   sudo su - SID_LCadm

   Ganti SID_LC dengan SID. Gunakan huruf kecil untuk setiap huruf.

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

3. Aktifkan fitur Backint untuk Agen Google Clouduntuk 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 Agent untuk SAP dari Google Cloudakan diinstal di direktori /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/. Hal ini mencakup file yang diperlukan untuk mengintegrasikan agen dengan SAP HANA. Skrip ini juga mendeteksi agen Backint Cloud Storage untuk SAP HANA di host Anda, menonaktifkan agen tersebut, dan menyalin filenya ke direktori yang dapat dipulihkan di host Anda. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade dari agen Backint.

4. Konfigurasi fitur Backint:

   Perintah jalankan

   • Jika database SAP HANA Anda berjalan di instance Compute Engine atau server Solusi Bare Metal, jalankan perintah configurebackint untuk mengonfigurasi fitur Backint agen. Sebaiknya gunakan pendekatan ini daripada 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, konfigurasi 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 Anda
     • 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 berenkode 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.

   Edit 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. Untuk mengizinkan Agen Google Clouduntuk SAP melakukan operasi pencadangan dan pemulihan berbasis Backint untuk sistem SAP HANA Anda, edit file konfigurasi, lalu tentukan parameter berikut:

      • bucket: tentukan nama bucket Cloud Storage tempat Anda ingin menyimpan cadangan SAP HANA
      • service_account_key: jika Anda telah membuat akun layanan untuk Agen Google Clouduntuk 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 menyetel juga hal berikut:

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

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

   5. Simpan file konfigurasi.

Perhatian: Nilai default untuk parameter konfigurasi Backint dioptimalkan untuk performa sebagian besar sistem. Oleh karena itu, sebelum mengedit nilai parameter default apa pun, pastikan untuk menguji nilai baru untuk performa di lingkungan non-produksi.

Menyesuaikan file konfigurasi Backint

Secara opsional, setelah mengaktifkan fitur Backint Agen Google Clouduntuk 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 untuk SAP Google Cloud.

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

  Pastikan untuk menyetel nama unik untuk setiap file konfigurasi.

• Pindahkan file konfigurasi ini ke direktori lain. Misalnya, dalam deployment skala horizontal, Anda dapat menyimpan file konfigurasi terkait Backint dari semua node Anda dalam direktori bersama yang dapat diakses oleh node. Hal ini dapat mempermudah 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 Anda. Untuk mengetahui petunjuknya, lihat Mengonfigurasi SAP HANA untuk fitur Backint.

Mengonfigurasi SAP HANA untuk fitur Backint

Setelah mengaktifkan fitur Backint Agen Google Clouduntuk SAP, Anda harus mengonfigurasi sistem SAP HANA untuk menggunakan fitur ini:

Catatan: Jika database SAP HANA Anda menggunakan fitur Isolasi database, Anda memerlukan konfigurasi tambahan untuk melakukan pencadangan dan pemulihan berbasis Backint. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Backint dengan database tingkat isolasi tinggi.

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 pencadangan SAP HANA, tentukan nilai true.
   log_backup_parameter_file	Jika Anda menggunakan file konfigurasi terpisah untuk volume log pencadangan 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 cadangan SAP HANA, tentukan nilai true.
   catalog_backup_parameter_file	Jika Anda menggunakan file konfigurasi terpisah untuk katalog cadangan 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 Agent for SAP dari Google Cloud:

   [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: tentukan direktori di sistem file Anda tempat SAP HANA dapat menyimpan cadangan log jika tidak dapat terhubung ke bucket Cloud Storage Anda; pastikan direktori ini memiliki ruang yang cukup untuk menyimpan cadangan.
   • basepath_catalogbackup: tentukan 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 ruang yang cukup untuk menyimpan cadangan.

   

Memvalidasi penyiapan untuk pencadangan dan pemulihan berbasis Backint

Anda dapat memvalidasi apakah Anda telah menyiapkan Google Cloud konfigurasi yang benar untuk menggunakan agen guna melakukan pencadangan dan pemulihan berbasis Backint untuk sistem SAP HANA Anda. Anda melakukan validasi ini dengan menjalankan perintah status agen, yang didukung dari agen versi 3.7.

Untuk melakukannya, selesaikan langkah-langkah berikut:

1. Buat koneksi SSH dengan instance Compute Engine atau server Solusi Bare Metal Anda.

2. Jalankan perintah berikut:

   sudo /usr/bin/google_cloud_sap_agent status -b="BACKINT_PARAM_FILE_PATH"
   

   Jika penyiapan Google Cloud Anda untuk pencadangan dan pemulihan berbasis Backint sudah benar, output akan mencakup hal berikut. Konfigurasi Anda akan memiliki nilai yang berbeda untuk parameter konfigurasi yang terkait dengan Backint.

   Agent Status:
       ...
       Systemd Service Enabled: True
       Systemd Service Running: True
       Cloud API Full Scopes: True
       Configuration File: /etc/google-cloud-sap-agent/configuration.json
       Configuration Valid: True
   ...
   ----------------------------------------------------------------------------
   Backint: Enabled
       Status: Fully Functional
       IAM Permissions: All granted
       Configuration:
           bucket:           my-bucket                                                           (configuration file)
           log_to_cloud:     true                                                                (default)
           parallel_streams: 16                                                                  (configuration file)
           param_file:       /usr/sap/NS1/SYS/global/hdb/opt/backint/backint-gcs/parameters.json (configuration file)
           threads:          32                                                                  (configuration file)
   ...

Memvalidasi pencadangan dan pemulihan

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

Catatan: Untuk digunakan dengan deployment penyebaran skala SAP HANA, Anda harus menginstal AgenGoogle Clouduntuk SAP dan mengaktifkan fitur ini di setiap node sistem SAP HANA Anda.

Untuk pengujian, Anda dapat menggunakan alat diagnostik mandiri bawaan agen. Anda memerlukan ruang disk yang tersedia 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 mengetahui informasi selengkapnya tentang parameter ini, lihat deskripsinya di Parameter konfigurasi.

Jika Anda telah menginstal agen Backint di host, maka saat pertama kali Anda menggunakan Agen Google Clouduntuk SAP guna melakukan operasi pencadangan, AgenGoogle Clouduntuk 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 yang sudah selesai untuk fitur Backint dari Agen Google Clouduntuk 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 AgenGoogle Clouduntuk SAP yang khusus untuk fitur Backint.

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

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

Perhatian: Nilai default untuk parameter konfigurasi Backint dioptimalkan untuk performa sebagian besar sistem. Oleh karena itu, sebelum mengedit nilai parameter default apa pun, pastikan untuk menguji nilai baru untuk performa di lingkungan non-produksi.

Parameter
bucket	String Tentukan nama bucket Cloud Storage yang menjadi tujuan penulisan dan pembacaan oleh Agen Google Clouduntuk SAP. Agen membuat objek cadangan dengan kelas penyimpanan bucket dan mendukung semua kelas penyimpanan. Agen menggunakan enkripsi default Compute Engine untuk mengenkripsi data dalam penyimpanan.
recovery_bucket	String Opsional. Tentukan nama bucket Cloud Storage yang dibaca agen selama operasi RESTORE. Jika Anda tidak menentukan parameter ini, agen akan menggunakan bucket yang ditentukan untuk parameter bucket untuk semua operasi: BACKUP, RESTORE, INQUIRE, DELETE, dan DIAGNOSE. Meskipun kami merekomendasikan penggunaan parameter ini untuk menyederhanakan pengelolaan konfigurasi untuk operasi penyalinan sistem dan refresh 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 Clouduntuk SAP, ke Cloud Logging, tentukan true. Nilai defaultnya adalah true. Jika database SAP HANA Anda berjalan di lingkungan lokal, maka Anda harus menetapkan nilai parameter ini ke false. Untuk mengetahui informasi tentang file log terkait Backint, lihat Logging.
log_level	String Opsional. Tentukan tingkat logging untuk fitur Backint dari Agen Google Clouduntuk 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's untuk SAP akan mengaktifkan kompresi saat menulis cadangan ke bucket Cloud Storage. Nilai defaultnya adalah false. Sebaiknya Anda tidak mengaktifkan kompresi. Meskipun kompresi mengurangi biaya penyimpanan untuk pencadangan di Cloud Storage, kompresi memerlukan lebih banyak pemrosesan CPU selama operasi pencadangan dan memperlambat throughput pencadangan efektif. Terlepas dari parameter ini,Agen Google Clouduntuk SAP mendukung file cadangan terkompresi dan tidak terkompresi selama operasi pemulihan.
encryption_key	String Opsional. Tentukan jalur ke kunci enkripsi yang disediakan pelanggan yang telah Anda konfigurasi untuk digunakan bucket Cloud Storage guna 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 konfigurasi untuk digunakan bucket Cloud Storage Anda dalam 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 Google Cloud project 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, maka 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's untuk SAP. Untuk mengetahui 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 yang menjadi tujuan penulisan dan pembacaan oleh Agen Google Clouduntuk SAP. Anda dapat menggunakan parameter ini untuk mengatur cadangan dari berbagai instance SAP HANA dalam bucket Cloud Storage yang sama. Anda dapat menentukan satu folder, seperti folder1 atau jalur multi-level dari folder, seperti folder1/folder2/folder3. Awalan ini disisipkan sebagai folder di antara nilai BUCKET_NAME dan SID di jalur untuk cadangan SAP HANA Anda di Cloud Storage. Untuk informasi selengkapnya, lihat Penyesuaian yang didukung. Parameter ini tersedia mulai dari agen versi 3.1. Peringatan: Mengubah nilai parameter ini akan mengubah jalur untuk file cadangan Anda, yang dapat menyebabkan kegagalan selama operasi pemulihan database. Oleh karena itu, sebelum Anda mengubah nilai parameter ini, pastikan untuk menguji pencadangan dan pemulihan dengan nilai parameter baru di lingkungan non-produksi.
recovery_folder_prefix	String Opsional. Tentukan untuk menyetel awalan bagi folder di bucket Cloud Storage yang dibaca agen selama operasi RESTORE. Anda dapat menggunakan parameter ini untuk mengatur cadangan dari berbagai instance SAP HANA dalam bucket Cloud Storage yang sama. Anda dapat menentukan satu folder, seperti folder1 atau jalur folder multi-level, seperti folder1/folder2/folder3. Untuk mengetahui informasi selengkapnya, lihat Penyesuaian yang didukung. Parameter ini tersedia mulai dari agen versi 3.1. Meskipun kami merekomendasikan penggunaan parameter ini untuk menyederhanakan pengelolaan konfigurasi untuk operasi penyalinan sistem dan refresh sistem, parameter ini tidak kompatibel dengan argumen CHECK ACCESS USING BACKINT selama operasi pemulihan SAP HANA. Peringatan: Mengubah nilai parameter ini akan mengubah jalur untuk file cadangan Anda, yang dapat menyebabkan kegagalan selama operasi pemulihan database. Oleh karena itu, sebelum Anda mengubah nilai parameter ini, pastikan untuk menguji pencadangan dan pemulihan dengan nilai parameter baru di lingkungan non-produksi.
shorten_folder_path	Boolean Opsional. Tentukan untuk memperpendek jalur objek di bucket Cloud Storage yang dibaca dan ditulis oleh agen selama semua operasi Backint. Untuk mengetahui informasi selengkapnya, lihat Penyesuaian yang didukung. Parameter ini tersedia mulai dari agen versi 3.3. Peringatan: Mengubah nilai parameter ini akan mengubah jalur untuk file cadangan Anda, yang dapat menyebabkan kegagalan selama operasi pemulihan database. Oleh karena itu, sebelum Anda mengubah nilai parameter ini, pastikan untuk menguji pencadangan dan pemulihan dengan nilai parameter baru di lingkungan non-produksi.
retries	Int Menentukan frekuensi maksimum Agen Google Clouduntuk 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 aliran upload paralel yang dapat digunakan oleh Agen Google Clouduntuk 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. 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 menyetel xml_multipart_upload ke true, tetapi tidak menentukan parallel_streams, maka parallel_streams akan otomatis diberi nilai 16. Sebaiknya gunakan xml_multipart_upload hanya untuk memparalelkan pencadangan log atau katalog. Untuk memparalelkan pencadangan data, sebaiknya tetapkan parallel_data_backup_backint_channels di bagian backup file global.ini. Untuk mengetahui 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 sedang diupload akan dihapus. Sebaiknya Anda juga menetapkan kondisi siklus proses untuk AbortIncompleteMultipartUpload untuk memastikan data dihapus jika operasi upload gagal.
parallel_recovery_streams	Int Opsional. Tentukan parameter ini untuk mengaktifkan download paralel cadangan dari bucket Cloud Storage Anda. Nilai yang Anda tentukan untuk parameter ini adalah jumlah maksimum aliran download paralel yang dapat digunakan oleh Agen Google Clouduntuk SAP. Nilai maksimumnya adalah 32. Setiap nilai yang melebihi nilai ini akan dibatasi hingga 32. Nilai defaultnya adalah 1, yang menonaktifkan download paralel. Parameter ini didukung mulai agen versi 3.7. Sebaiknya gunakan parallel_recovery_streams hanya untuk memparalelkan download cadangan log atau katalog. Untuk memparalelkan download cadangan data, sebaiknya tetapkan parameter parallel_data_backup_backint_channels di bagian backup file global.ini. Untuk informasi tentang cara membuat file parameter terpisah untuk pencadangan log dan data, atau cara menetapkan nilai untuk parameter parallel_data_backup_backint_channels, lihat Mengonfigurasi SAP HANA untuk fitur Backint. Jangan aktifkan pemulihan paralel saat mendownload cadangan terkompresi, yang Anda buat dengan menentukan parameter compress. agen keluar dengan status 1.
storage_class	String Opsional. Tentukan kelas penyimpanan yang akan digunakan untuk menulis cadangan ke bucket Cloud Storage. Kelas penyimpanan yang tersedia adalah sebagai berikut: STANDARD NEARLINE COLDLINE ARCHIVE Mulai dari agen versi 3.7, nilai defaultnya adalah kelas penyimpanan bucket Cloud Storage Anda. Untuk agen versi sebelumnya, nilai defaultnya adalah STANDARD. Parameter ini tersedia mulai agen versi 3.2.
metadata	Map<String, String> Opsional. Tentukan kolom key:value untuk disimpan sebagai metadata objek saat menulis cadangan ke bucket Cloud Storage. Parameter ini tersedia mulai dari 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 filenya. Peringatan: Kunci X-Backup-Type tidak boleh diganti dengan metadata kustom.
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 dalam Custom-Time. Parameter ini tersedia mulai dari agen versi 3.4. Anda dapat menetapkan parameter ini dengan nilai UTCNow, yang menetapkan metadata Custom-Time dengan tanggal dan waktu UTC saat cadangan dibuat. Mulai dari agen versi 3.6, Anda dapat menetapkan tanggal mendatang untuk metadata Custom-Time menggunakan UTCNow+NUMBERd. Misalnya, untuk menyetel Custom-Time menjadi 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 dan waktu dalam file PARAMETERS.json Anda: { "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 Clouduntuk SAP. Saat Anda menyetel parameter ini, throughput mungkin bervariasi, tetapi tidak akan melebihi batas yang ditentukan.
service_account_key	String Jika Agen Google Clouduntuk SAP tidak berjalan di instance Compute Engine, tentukan jalur yang sepenuhnya memenuhi syarat ke akun layanan Google Cloud yang dienkode JSON. Jika Agen Google Clouduntuk SAP berjalan di instance Compute Engine, sebaiknya jangan tentukan parameter ini dan gunakan autentikasi default Compute Engine. Menentukan parameter ini akan mengarahkan Agen Google Clouduntuk SAP agar 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 dari agen versi 3.3. Agar alat diagnostik mandiri dapat beroperasi dengan lancar, Anda harus memastikan bahwa penyimpanan yang tersedia di sistem file Anda minimal 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 dari 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 akan mengirimkan metrik yang dikumpulkan ke Cloud Monitoring. Parameter ini tersedia mulai dari 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 Anda diminta untuk melakukannya 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 Anda diminta untuk melakukannya oleh Customer Care. Nilai defaultnya jarang perlu diubah. Tentukan jumlah waktu maksimum, dalam milidetik, yang ditunggu Agen Google Cloud's untuk SAP untuk 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 Anda diminta untuk melakukannya 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 Clouduntuk 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 buffer sendiri untuk memproses permintaan HTTPS.
retry_backoff_initial	Int Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika Anda diminta untuk melakukannya 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 Anda diminta untuk melakukannya 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 Anda diminta untuk melakukannya oleh Customer Care. Nilai defaultnya jarang perlu diubah. Tentukan pengganda untuk periode percobaan ulang yang digunakan dalam percobaan ulang jaringan backoff eksponensial. Pengali harus lebih besar dari 1 dan nilai defaultnya adalah 2.
log_delay_sec	Int Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika Anda diminta untuk melakukannya oleh Customer Care. Nilai defaultnya jarang perlu diubah. Tentukan penundaan logging, dalam detik, untuk pembaruan progres selama pembacaan dan penulisan ke bucket Cloud Storage. Nilai defaultnya adalah 60.
client_endpoint	String Ini adalah parameter penyesuaian lanjutan opsional. Jangan ubah parameter ini kecuali jika Anda diminta untuk melakukannya oleh Customer Care. Nilai defaultnya jarang perlu diubah. Tentukan endpoint klien Cloud Storage. Nilai defaultnya adalah storage.googleapis.com.
object_retention_time	String Opsional. Tentukan tanggal dan waktu hingga cadangan harus dipertahankan di bucket Cloud Storage Anda. Parameter ini didukung mulai agen versi 3.7. Anda dapat menetapkan parameter ini dengan nilai berikut: UTCNow+NUMBERd: menetapkan waktu retensi ke tanggal mendatang. Misalnya, untuk menyetel waktu retensi ke 30 hari sejak waktu pembuatan cadangan, tetapkan "object_retention_time": "UTCNow+30d" dalam file konfigurasi Backint Anda. Stempel waktu tertentu yang direpresentasikan dalam format RFC 3339 YYYY-MM-DD'T'HH:MM:SS.SS'Z' atau YYYY-MM-DD'T'HH:MM:SS'Z' saat milidetik adalah nol. Misalnya, 2024-06-25T13:25:00Z. Jika menentukan parameter ini, Anda juga perlu menentukan object_retention_mode. Untuk mengetahui informasi selengkapnya tentang parameter ini, lihat Penyesuaian yang didukung.
object_retention_mode	String Opsional. Tentukan mode retensi yang ingin Anda tetapkan untuk konfigurasi retensi cadangan yang Anda upload ke bucket Cloud Storage Anda. Nilai yang didukung adalah Locked dan Unlocked. Parameter ini didukung mulai agen versi 3.7. Jika menentukan parameter ini, Anda juga perlu menentukan object_retention_time. Untuk mengetahui informasi selengkapnya tentang parameter ini, lihat Penyesuaian yang didukung.

Pemecahan masalah

Untuk memecahkan masalah terkait AgenGoogle Clouduntuk SAP versi 3.8 (terbaru), lihat Panduan pemecahan masalah AgenGoogle Clouduntuk SAP.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah pada Agen Google Clouduntuk SAP, kumpulkan informasi diagnostik yang diperlukan dan hubungi Cloud Customer Care. Untuk informasi selengkapnya, lihat Informasi diagnostik AgenGoogle Clouduntuk SAP untuk SAP HANA.

Langkah berikutnya

• Untuk mempelajari cara membuat cadangan berbasis Backint dan memulihkan database SAP HANA menggunakan cadangan tersebut, lihat mencadangkan dan memulihkan SAP HANA menggunakan Backint.