Status | Description |
Success | The backup file is successfully created with the given parameters. |
Failed | The backup process has failed. You can diagnose the cause of failure using the -debug true parameter along with the create backup command or by checking the logs. For more information, see
Troubleshooting a Failed Backup. |
In progress | The backup process is still in progress. This message usually appears when the backup data is large and you verify the status as soon as you initiate the backup process. |
Partial | The backup of the data is partially complete. You can troubleshoot such instances by following the steps given in
Troubleshooting a Failed Backup. |
Unavailable | The specified backup file does not exist. Verify the file name and repository. |
Parameter | Description |
tenant | Name of the tenant that you want to verify backup status. If you do not provide this parameter, the value is picked from pg.gateway.elasticsearch.tenantId property in config.properties file located at IntegrationServer\instances\instance_name\packages\WmAPIGateway\config\resources\elasticsearch. |
repoName | Name of the repository where the backup can be found. If you do not provide this parameter, the value is picked from the tenant parameter. |
verbose | Option to display detailed status of the backup files in a given repository. Possible values are: ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() When you do not provide this parameter, the value for the parameter is considered as false, the backup files appear without the list of details seen above. |
format | Option to specify the format in which the details must appear. Works in combination with the verbose parameter. Available options are: ![]() ![]() For example, if you run the following command, the backup status details are displayed in plain text format: apigatewayUtil.bat status backup -name samplebackup -verbose true -format text |
logLevel | Level of log that you want to create. Log levels indicate the severity of logs. Available levels are: ![]() ![]() ![]() ![]() ![]() You can specify one of the log level with the logLevel parameter. For example, to create a log file of Warning level when listing backup files, you can run the following command: apigatewayUtil.bat list backup -logLevel warning When you provide Error as the log level, then only the error level logs are saved. When you provide Debug as the log level, then Debug, Info, Warning and Error level logs are saved. When you provide Trace as log level, then all level logs are saved. This parameter is optional. If you do not specify the parameter, then the Info level logs are saved by default. |
logFileLocation | Location where you want to save the log file. For example, to save the log file in C:/apiglogs/backups, you can provide the location as seen in the following example: apigatewayUtil.bat create backup -name samplebackup -logFileLocation C:/apiglogs/backups This parameter is optional. If you do not specify the parameter, the logs are saved in the following location SAGInstallDir/IntegrationServer/instances/instance_name/packages/WmAPIGateway/cli/logs/APIGWUtility.log |