summaryrefslogtreecommitdiff
path: root/docs/api_reference/C/repelect.html
diff options
context:
space:
mode:
authorLorry Tar Creator <lorry-tar-importer@baserock.org>2015-02-17 17:25:57 +0000
committer <>2015-03-17 16:26:24 +0000
commit780b92ada9afcf1d58085a83a0b9e6bc982203d1 (patch)
tree598f8b9fa431b228d29897e798de4ac0c1d3d970 /docs/api_reference/C/repelect.html
parent7a2660ba9cc2dc03a69ddfcfd95369395cc87444 (diff)
downloadberkeleydb-master.tar.gz
Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz.HEADdb-6.1.23master
Diffstat (limited to 'docs/api_reference/C/repelect.html')
-rw-r--r--docs/api_reference/C/repelect.html36
1 files changed, 22 insertions, 14 deletions
diff --git a/docs/api_reference/C/repelect.html b/docs/api_reference/C/repelect.html
index 2d42f584..7edf5555 100644
--- a/docs/api_reference/C/repelect.html
+++ b/docs/api_reference/C/repelect.html
@@ -14,7 +14,7 @@
<body>
<div xmlns="" class="navheader">
<div class="libver">
- <p>Library Version 11.2.5.3</p>
+ <p>Library Version 12.1.6.1</p>
</div>
<table width="100%" summary="Navigation header">
<tr>
@@ -100,7 +100,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp61907368"></a>How Elections are Held</h3>
+ <h3 class="title"><a id="idp3600992"></a>How Elections are Held</h3>
</div>
</div>
</div>
@@ -113,6 +113,12 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
votes for it to become the new master, then it will become the new master.
</p>
<p>
+ Replication view sites never participate in elections. Values
+ chosen for <span class="bold"><strong>nsites</strong></span> and
+ <span class="bold"><strong>nvotes</strong></span> must not include
+ any replication view sites.
+ </p>
+ <p>
We recommend <span class="bold"><strong>nvotes</strong></span> be set to at least:
</p>
<pre class="programlisting"> (sites participating in the election / 2) + 1</pre>
@@ -129,7 +135,8 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<pre class="programlisting"> number of sites in the replication group - 1</pre>
<p>
when choosing a new master after a current master fails. This allows the group to reach a consensus
- without having to wait for the timeout to expire.
+ without having to wait for the timeout to expire or for
+ the failed master to restart.
</p>
<p>
When choosing a master from among a group of client sites all restarting at the same time, it makes
@@ -151,7 +158,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp61898656"></a>Parameters</h3>
+ <h3 class="title"><a id="idp3602824"></a>Parameters</h3>
</div>
</div>
</div>
@@ -159,13 +166,13 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp61911480"></a>nsites</h4>
+ <h4 class="title"><a id="idp3599384"></a>nsites</h4>
</div>
</div>
</div>
<p>
The <span class="bold"><strong>nsites</strong></span> parameter specifies the
- number of replication sites expected to participate in the election.
+ number of replication sites expected to participate in the election.
Once the current site has election information from that many sites,
it will short-circuit the election and immediately cast its vote for a
new master. The <span class="bold"><strong>nsites</strong></span> parameter must
@@ -175,14 +182,15 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
method. If an application is using master leases, then the value
<span class="bold"><strong>must</strong></span> be 0 and the value from
<a class="xref" href="repnsites.html" title="DB_ENV-&gt;rep_set_nsites()">DB_ENV-&gt;rep_set_nsites()</a>
- method must be used.
+ method must be used. The value should exclude any replication
+ views.
</p>
</div>
<div class="sect3" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp61941528"></a>nvotes</h4>
+ <h4 class="title"><a id="idp3638136"></a>nvotes</h4>
</div>
</div>
</div>
@@ -200,7 +208,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp61932856"></a>flags</h4>
+ <h4 class="title"><a id="idp3628624"></a>flags</h4>
</div>
</div>
</div>
@@ -214,7 +222,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp61920768"></a>Errors</h3>
+ <h3 class="title"><a id="idp3627528"></a>Errors</h3>
</div>
</div>
</div>
@@ -230,7 +238,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp61942544"></a>DB_REP_UNAVAIL</h4>
+ <h4 class="title"><a id="idp3639152"></a>DB_REP_UNAVAIL</h4>
</div>
</div>
</div>
@@ -245,7 +253,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h4 class="title"><a id="idp61943880"></a>EINVAL</h4>
+ <h4 class="title"><a id="idp3640488"></a>EINVAL</h4>
</div>
</div>
</div>
@@ -263,7 +271,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp61944736"></a>Class</h3>
+ <h3 class="title"><a id="idp3641344"></a>Class</h3>
</div>
</div>
</div>
@@ -275,7 +283,7 @@ DB_ENV-&gt;rep_elect(DB_ENV *env,
<div class="titlepage">
<div>
<div>
- <h3 class="title"><a id="idp61947952"></a>See Also</h3>
+ <h3 class="title"><a id="idp3607336"></a>See Also</h3>
</div>
</div>
</div>