Error handling
retry_count and retry_delay
--retry_count=<number of attempts>
--retry_delay=<delay>
These parameters are used with the backup and recovery commands only.
When a recoverable error occurs, the software re-attempts to perform the unsuccessful operation. You can set the number of attempts and the time interval between attempts. The attempts will be stopped as soon as the operation succeeds OR the specified number of attempts is performed, depending on which comes first.
You need to specify both parameters. The --retry_delay parameter must directly follow the --retry_count parameter.
Example: --retry_count=10--retry_delay=20s
If the parameters are not specified, the number of attempts is 5 and the time interval between attempts is 30 seconds (as if you typed --retry_count=5--retry_delay=30s). To completely disable re-attempts, specify --retry_count=0.
The interval may be set in seconds (s, by default), minutes (m) or hours (h).
Examples:
- 10-second interval:
--retry_delay=10or--retry_delay=10s - 1-minute interval:
--retry_delay=1m - 1-hour interval:
--retry_delay=1h
vmsnapshot_retry_count and vmsnapshot_retry_delay
These parameters are used with the backup vm command only when backing up VMware virtual machines by using quiesced virtual machine snapshots (--vmsnapshot_quiesce=true).
When taking a virtual machine snapshot fails, the program re-attempts to perform the unsuccessful operation. You can set the time interval and the number of attempts. The attempts will be stopped as soon as the operation succeeds OR the specified number of attempts are performed, depending on which comes first. If all attempts to take a quiesced snapshot fail, the program will try to take a non-quiesced snapshot. If taking a non-quiesced snapshot also fails, the operation will fail.
You need to specify both parameters. The --vmsnapshot_retry_delay parameter must directly follow the --vmsnapshot_retry_count parameter.
Example: --vmsnapshot_retry_count=10--vmsnapshot_retry_delay=20s
If the parameters are not specified, the number of attempts is 3 and the time interval between attempts is 5 minutes (as if you typed --vmsnapshot_retry_count=3--vmsnapshot_retry_delay=5m). To completely disable re-attempts, specify --vmsnapshot_retry_count=0.
The interval may be set in seconds (s, by default), minutes (m) or hours (h).
Examples:
- 10-second interval:
--vmsnapshot_retry_delay=10or--vmsnapshot_retry_delay=10s - 1-minute interval:
--vmsnapshot_retry_delay=1m - 1-hour interval:
--vmsnapshot_retry_delay=1h