aboutsummaryrefslogtreecommitdiff
path: root/doc/eclat.conf.5
diff options
context:
space:
mode:
Diffstat (limited to 'doc/eclat.conf.5')
-rw-r--r--doc/eclat.conf.533
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.

Return to:

Send suggestions and report system problems to the System administrator.