webMethods and Intelligent Business Operations 10.2 | API Gateway Configuration Guide | API Gateway Data Management | Restoring Data
 
Restoring Data
You use the command tool apigw-restore-tenant.[bat|sh] to restore previously archived configuration files and data on an API Gateway instance.
Note: Restoring overwrites the existing content in your API Gateway instance.
Prerequisites for Restoring in a Distributed Environment
The following points are to be considered if API Gateway is installed in a clustered high availability setup:
*The Event Data Store must be active in only a single node in the cluster.
*The API Gateway instance should be up and running.
* To restore configurations and data
*Run the command apigw-restore-tenant.[bat|sh].
The syntax is of the format: C:\SoftwareAG\IntegrationServer\instances\default\packages\WmAPIGateway\cli\bin>apigw-restore-tenant.bat|sh -backupFileName <backup_file_name_without_spaces> -backupDestinationDirectory <directory_path_to_store_backup_file> -filesToSkip <file_path_to_files_to_skip> -skipDataRestore -help
The input parameters are:
Parameter
Description
-backupDestinationDirectory
Mandatory. The path to the destination folder where the backup is available, for example: C:\SoftwareAG\AnotherBackupLocation
Specify this option only if you want the backup is available in a local directory or NFS itself.
-backupFileName
Mandatory. The file name for the database backup.
Note: The file name must not contain any spaces.
-filesToSkip
Optional. The path to the restore file, for example: C:\SoftwareAG\skip-files.txt
Note: The paths specified in the restore file should be relative to the Software AG root installation folder <SAGInstallDir>
Default value is C:\SoftwareAG\IntegrationServer\instances\{instance_name}\packages\WmAPIGateway\cli\bin\conf\skip-files.txt.
The restore file (skip-files.txt) contains a list of configuration files and folders that need to be restored in the API Gateway instance, with one file or folder name in each line. If you do not want to restore a specific configuration file, you can remove it from this restore file.
-skipDataRestore
Optional. Skips the restoring of the Event Data Store (Elastic Search) data during the restore process.
-help
Optional. Prints the help text summarizing the input parameters of this command.
The apigw-restore-tenant command creates a restore log file named restore-tenant.log in the <SAGInstallDir>\IntegrationServer\instances\{instance_name}\packages\WmAPIGateway\cli\bin directory.
Note: The apigw-restore-tenant command automatically restarts the API Gateway instance.
Postrequisites in a Distributed Environment
*If the Event Data Store in active node does not start automatically, manually restart the Event Data Store.
*Start the Event Data Store in all other nodes in the cluster. This is important to synchronize the data on a restored API Gateway instance with all other nodes in the cluster.
*The API Gateway configuration files should be restored separately for each individual API Gateway instance in the clustered environment.
Run the command apigw-restore-tenant with the parameter -skipDataRestore. This restores the API Gateway configuration files without restoring the Event Data Store data in all other nodes in the cluster.

Copyright © 2015- 2018 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release