Updated on 2023-05-29 GMT+08:00

Modifying the Backint Agent Configuration File

You can configure Backint Agent by modifying the parameters in its configuration file.

1. Run the following command to go to the directory where the configuration file is located:

cd /usr/sap/{SID}/SYS/global/hdb/opt/hdbconfig

Replace {SID} in the directory with the actual system ID. Example command:

/usr/sap/S99/SYS/global/hdb/opt/hdbconfig

2. Run the following command to modify the file:

vi hw-backint-agent.conf

You must set BUCKET, LOGLEVEL, and SID in the configuration file.

  • BUCKET: specifies the name of the OBS bucket where Backint Agent reads and writes data. This OBS bucket will be used to store backups.
  • LOGLEVEL: specifies to what extent the log details can be. You only need to set it to INFO. DEBUG is used only for troubleshooting after a fault occurs.
  • SID: specifies the system ID (SID) used during SAP HANA system installation.
  • THREADNUM: specifies the number of concurrent backup and restoration tasks. The value ranges from 1 to 20. The default value is 8. Set this parameter based on the server specifications.
  • BACKUPSIZE: indicates the data volume uploaded by each thread during backup and restoration (unit: MB). The data volume can be set to a value ranging from 1 to 2047 (unit: MB). The default value is 200.

When Backint is used for backup or restoration, certain memory is occupied. Peak usage = 2 x THREADNUM x BACKUPSIZE. Configure these parameters properly based on the memory of the server. For oversized backup, the value of BACKUPSIZE cannot be too small. Backup size = BACKUPSIZE x 10000

The following example shows the valid content of the hw-backint-agent.conf file.

BUCKET=xxx

LOGLEVEL=INFO

SID=S01

THREADNUM=8

BACKUPSIZE=200

3. After the file is modified, press Esc, and then press Shift and : at the same time. Enter wq! to save and exit.