API Gateway 10.5 | Configuring API Gateway | API Gateway Data Management | API Gateway Backup and Restore Commands
 
API Gateway Backup and Restore Commands
You can use a command-line interface (CLI) script to back up data that is stored on API Gateway Data Store. You can use the CLI script to restore database after a data failure or hardware failure on the API Gateway instance.
In a command line, go to <Integration Server_directory>\instances\default\packages\WmAPIGateway\cli\bin and run the following commands to take a database backup or restore the database from a backup:
If you want to...
Command
Backup data
apigatewayUtil.sh create backup -name <backupFilename>
Backup custom data
apigatewayUtil.sh create backup -name <backupFile_name> -include <reference name> Possible values for the parameter reference name:
*analytics - to back up analytical data.
*assets - to back up asset data.
Delete the backed up data
apigatewayUtil.sh delete backup -name <backupFile_name>
Restore the backed up data
apigatewayUtil.sh restore backup -name <backupFile_name>
To retrieve all available backup files in the repository
apigatewayUtil.sh list backup
Delete a repository from API Gateway
apigatewayUtil.sh delete manageRepo
To retrieve all available repositories
apigatewayUtil.sh list manageRepo
To configure a repository in S3
apigatewayUtil.sh configure manageRepo -file <file_path>
Backup configurations and data
apigw-backup-tenant.sh -backupDestinationDirectory <directory_path_to_store_backup_file> -backupFileName <backup_file_name_without_spaces> -backupTemplate <file_path_to_backup_template> -packagesTemplate <file_path_to_packages_template> -help
Restore the backed up configurations and data
apigw-restore-tenant.sh -backupFileName <backup_file_name_without_spaces> -backupDestinationDirectory <directory_path_to_store_backup_file> -filesToSkip <file_path_to_files_to_skip> -skipDataRestore -help
Pre-requisites for Backing up and Restoring Data
The following points are to be considered in the API Gateway instances used for backup and restore:
*The Software AG root installation directory must be the same.
*The Integration Server instance name must be the same.
*The ports defined for the API Gateway webApp, Integration Server, and the API Gateway Data Store must be the same.