diff options
Diffstat (limited to 'docs/api_reference/CXX/repelect.html')
| -rw-r--r-- | docs/api_reference/CXX/repelect.html | 36 |
1 files changed, 22 insertions, 14 deletions
diff --git a/docs/api_reference/CXX/repelect.html b/docs/api_reference/CXX/repelect.html index c844a8cb..5fc7e7f5 100644 --- a/docs/api_reference/CXX/repelect.html +++ b/docs/api_reference/CXX/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> @@ -99,7 +99,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4044320"></a>How Elections are Held</h3> + <h3 class="title"><a id="idp4052488"></a>How Elections are Held</h3> </div> </div> </div> @@ -112,6 +112,12 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> 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> @@ -128,7 +134,8 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <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 @@ -150,7 +157,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4066080"></a>Parameters</h3> + <h3 class="title"><a id="idp4072944"></a>Parameters</h3> </div> </div> </div> @@ -158,13 +165,13 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4065712"></a>nsites</h4> + <h4 class="title"><a id="idp4069240"></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 @@ -174,14 +181,15 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> 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="DbEnv::rep_set_nsites()">DbEnv::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="idp4087456"></a>nvotes</h4> + <h4 class="title"><a id="idp4095648"></a>nvotes</h4> </div> </div> </div> @@ -199,7 +207,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4079408"></a>flags</h4> + <h4 class="title"><a id="idp4086288"></a>flags</h4> </div> </div> </div> @@ -213,7 +221,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4067528"></a>Errors</h3> + <h3 class="title"><a id="idp4073912"></a>Errors</h3> </div> </div> </div> @@ -231,7 +239,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4093720"></a>DB_REP_UNAVAIL</h4> + <h4 class="title"><a id="idp4101960"></a>DB_REP_UNAVAIL</h4> </div> </div> </div> @@ -246,7 +254,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4096560"></a>EINVAL</h4> + <h4 class="title"><a id="idp4086144"></a>EINVAL</h4> </div> </div> </div> @@ -264,7 +272,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4075776"></a>Class</h3> + <h3 class="title"><a id="idp4083304"></a>Class</h3> </div> </div> </div> @@ -276,7 +284,7 @@ DbEnv::rep_elect(u_int32_t nsites, u_int32_t nvotes, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4081120"></a>See Also</h3> + <h3 class="title"><a id="idp4087264"></a>See Also</h3> </div> </div> </div> |