diff options
Diffstat (limited to 'doc/eclat.conf.5')
-rw-r--r-- | doc/eclat.conf.5 | 33 |
1 files changed, 32 insertions, 1 deletions
diff --git a/doc/eclat.conf.5 b/doc/eclat.conf.5 index c896dba..bc6a567 100644 --- a/doc/eclat.conf.5 +++ b/doc/eclat.conf.5 @@ -13,7 +13,7 @@ .\" .\" You should have received a copy of the GNU General Public License .\" along with Eclat. If not, see <http://www.gnu.org/licenses/>. -.TH ECLAT.CONF 5 "November 19, 2015" "ECLAT" "Eclat User Reference" +.TH ECLAT.CONF 5 "March 15, 2018" "ECLAT" "Eclat User Reference" .SH NAME eclat.conf \- configuration file for .BR eclat (1). @@ -469,6 +469,37 @@ This is a shortcut for \fBauthentication\-provider file \fIname\fR. \fBsignature\-version\fR \fIN\fR; Declares the signature version. Valid values for \fIN\fR are \fB2\fR, which is the default, and \fB4\fR, which provides a better security. +.SH RETRY ON ERRORS +If AWS responds with a \fBRequestLimitExceeded\fR code, \fBeclat\fR +retries the request using exponential backoff with jitter algorithm. +The algorithm is controlled by two configuration values: +.B max\-retry\-interval +and +.BR total\-retry\-timeout . +When the \fBRequestLimitExceeded\fR error is returned, \fBeclat\fR +will sleep for up to 2 seconds and then retry the request. For each +subsequent \fBRequestLimitExceeded\fR error, it will calculate the +timeout using the following formula: +.EX + t = rand(0, min(M, 2 ** N)) + 1 +.EE +where N is the attempt number, M is the value of max-retry-interval +parameter, 'rand(a,b)' selects the integer random number X such that +0 <= X <= b, and '**' is the power operator. The attempts to resend +the request will continue until either a response other than +\fBRequestLimitExceeded\fR is received (be it a response to the query or +another error response), or the total time spent in the retry loop +becomes equal to or greater than +.BR total-retry-timeout , +whichever occurs +first. +.PP +Default values are: +.PP +.EX +max-retry-interval 600; +total-retry-timeout 1800; +.EE .SH INSTANCE STORE CONFIGURATION The \fBinstance\-store\fR compound statement configures HTTP access to the instance store. By default, \fBeclat\fR uses standard AWS values. |