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: true. The backup files appear with the following details: snapshot. Name of the backup file. status. Status of the backup process. startTime. Time when the backup process was initiated. endTime. Time when the backup process was completed. Duration. Time when for the backup creation. Indices. Name of the indexes included in the backup. Successful shards. Number of successful shards in backup. Failed shards. Number of failed shards in backup. Total shards. Number of successful shards in backup. false. The backup files appear without the details listed above. 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: JSON Text 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: Info. Provides the list of regular events that occur during the process. These events are informative. Debug. Provides the events that could be useful, if you have to debug the process. Warning. Indicates unexpected events that occurred during the process. Usually, these events do not interrupt or have an immediate effect on the process. Error. Indicates the events that stop the functionality from working as designed. Trace. Provides the list of events in a much detailed manner that could be useful for debugging. 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 |