mirror of https://github.com/Awuqing/BackupX.git synced 2026-05-19 23:30:53 +08:00

Files

Wu Qing bc3d03de7e 文档: 新增 Docusaurus 官网与双语文档，README 切换为英文默认 (#39 )

- 新建 docs-site/ Docusaurus 项目，支持 en + zh-Hans 双语
- 从 README 迁移内容为独立文档页面：
  - Getting Started（安装、快速开始）
  - Deployment（Docker、裸机、Nginx、配置参考）
  - Features（备份类型、存储后端、SAP HANA、多节点集群、通知）
  - Reference（API、CLI）
  - Development（开发、贡献）
- 自定义 BackupX 主题色、logo、落地页组件
- 新增 .github/workflows/docs.yml，Actions 自动构建并发布到 GitHub Pages
- README.md 切换为英文，中文版挪到 README.zh-CN.md，两者均精简为导航型
- 配置站点 URL：https://awuqing.github.io/BackupX/

2026-04-17 13:19:41 +08:00

2.7 KiB

Raw Blame History

sidebar_position, title, description

sidebar_position	title	description
3	SAP HANA Support	Two SAP HANA backup modes — managed hdbsql runner and native Backint protocol agent.

SAP HANA Support

BackupX provides two SAP HANA backup modes. Pick whichever fits your operations workflow.

Mode 1: hdbsql Runner (console-managed)

Create a SAP HANA backup task in the Web console. The backend invokes hdbsql to execute the backup. Use this when BackupX should own the schedule.

Source configuration supports:

Field	Options	Description
Backup type	`data` / `log`	Data or log backup
Backup level	`full` / `incremental` / `differential`	Auto-disabled for log backups
Parallel channels	`1 ~ 32`	Multi-path SQL (`BACKUP DATA USING FILE ('c1', 'c2', ...)`)
Retry count	`1 ~ 10`	Exponential backoff (`5s × attempt²`)
Instance number	Optional	Inferred from port or specified manually

Mode 2: Backint Protocol Agent (HANA native)

BackupX ships a built-in Backint Agent. SAP HANA calls it via the native BACKUP DATA USING BACKINT syntax, and data is routed automatically to any BackupX storage target (S3 / OSS / COS / WebDAV / 70+ backends).

1. Parameter file

#STORAGE_TYPE = s3
#STORAGE_CONFIG_JSON = /opt/backupx/storage.json
#PARALLEL_FACTOR = 4
#COMPRESS = true
#KEY_PREFIX = hana-backup
#CATALOG_DB = /opt/backupx/backint_catalog.db
#LOG_FILE = /var/log/backupx/backint.log

2. Storage config (same schema as storage targets)

{
  "endpoint": "https://s3.amazonaws.com",
  "region": "us-east-1",
  "bucket": "hana-prod",
  "accessKeyId": "AKIA...",
  "secretAccessKey": "..."
}

3. Create the hdbbackint symlink

ln -s /opt/backupx/backupx /usr/sap/<SID>/SYS/global/hdb/opt/hdbbackint

4. Enable Backint in HANA `global.ini`

[backup]
data_backup_using_backint = true
catalog_backup_using_backint = true
log_backup_using_backint = true
data_backup_parameter_file = /opt/backupx/backint_params.ini
log_backup_parameter_file = /opt/backupx/backint_params.ini

5. Manual CLI invocation (troubleshooting)

backupx backint -f backup  -i input.txt -o output.txt -p backint_params.ini
backupx backint -f restore -i input.txt -o output.txt -p backint_params.ini
backupx backint -f inquire -i input.txt -o output.txt -p backint_params.ini
backupx backint -f delete  -i input.txt -o output.txt -p backint_params.ini

The Backint Agent maintains an EBID ↔ object-key catalog in a local SQLite DB. All operations follow the SAP HANA Backint protocol (#PIPE / #SAVED / #RESTORED / #BACKUP / #NOTFOUND / #DELETED / #ERROR).

2.7 KiB Raw Blame History Unescape Escape