diff options
| author | Lorry Tar Creator <lorry-tar-importer@baserock.org> | 2015-02-17 17:25:57 +0000 |
|---|---|---|
| committer | <> | 2015-03-17 16:26:24 +0000 |
| commit | 780b92ada9afcf1d58085a83a0b9e6bc982203d1 (patch) | |
| tree | 598f8b9fa431b228d29897e798de4ac0c1d3d970 /docs/api_reference/CXX/repmgrstart.html | |
| parent | 7a2660ba9cc2dc03a69ddfcfd95369395cc87444 (diff) | |
| download | berkeleydb-master.tar.gz | |
Diffstat (limited to 'docs/api_reference/CXX/repmgrstart.html')
| -rw-r--r-- | docs/api_reference/CXX/repmgrstart.html | 48 |
1 files changed, 28 insertions, 20 deletions
diff --git a/docs/api_reference/CXX/repmgrstart.html b/docs/api_reference/CXX/repmgrstart.html index 632cf090..15b35533 100644 --- a/docs/api_reference/CXX/repmgrstart.html +++ b/docs/api_reference/CXX/repmgrstart.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> @@ -60,14 +60,14 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <p> Use <a class="xref" href="repmgr_site.html" title="DbEnv::repmgr_site()">DbEnv::repmgr_site()</a> to obtain a DbSite handle, then use that handle to - configure the sites in your replication group. + configure the sites in the replication group. </p> <div class="orderedlist"> <ol type="a"> <li> <p> Use <a class="xref" href="dbsite_set_config.html" title="DbSite::set_config()">DbSite::set_config()</a> - to configure sites in your replication group. + to configure sites in the replication group. </p> </li> <li> @@ -120,17 +120,20 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> incoming connections, and starting all necessary background threads. When multiple processes share a database environment, only one process can open the listening socket; the <code class="methodname">DbEnv::repmgr_start()</code> method automatically opens the socket in the - first process to call it, and skips this step in the later calls from other processes. + first process to call it, and skips this step in the later calls from + other subordinate processes. </p> <p> The <code class="methodname">DbEnv::repmgr_start()</code> method may not be called before the <a class="xref" href="envopen.html" title="DbEnv::open()">DbEnv::open()</a> method is - called to open. In addition, this method may not be called before - your replication sites have been configured using the + called to open the environment. In addition, this method may not be called before + at least one replication site has been configured using the <a class="link" href="db_site.html" title="The DbSite Handle">DbSite</a> class. In addition, the local environment must be opened with the <a class="link" href="envopen.html#envopen_DB_THREAD">DB_THREAD</a> - flag set. + flag set. If you are starting a view, you must call the + <a class="xref" href="repset_view.html" title="DbEnv::rep_set_view()">DbEnv::rep_set_view()</a> + method before opening the local environment. </p> <p> The <code class="methodname">DbEnv::repmgr_start()</code> method will return @@ -151,7 +154,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4605504"></a>Parameters</h3> + <h3 class="title"><a id="idp4672168"></a>Parameters</h3> </div> </div> </div> @@ -159,7 +162,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4606152"></a>nthreads</h4> + <h4 class="title"><a id="idp4672816"></a>nthreads</h4> </div> </div> </div> @@ -177,7 +180,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4597904"></a>flags</h4> + <h4 class="title"><a id="idp4664568"></a>flags</h4> </div> </div> </div> @@ -204,7 +207,8 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <code class="literal">DB_REP_CLIENT</code> </p> <p> - Start as a client site, and do not call for an election. + Start as a client, view, or preferred master site, and do not + call for an election. </p> </li> <li> @@ -221,7 +225,8 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> If the Replication Manager is already started, a <span class="bold"><strong>flags</strong></span> value of 0 can be used when making a subsequent call to change the - value of <span class="bold"><strong>nthreads</strong></span>. + value of <span class="bold"><strong>nthreads</strong></span> + or when starting a subordinate process. </p> </div> </div> @@ -229,7 +234,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4602032"></a>Errors</h3> + <h3 class="title"><a id="idp4668696"></a>Errors</h3> </div> </div> </div> @@ -247,14 +252,14 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4604584"></a>DB_REP_UNAVAIL</h4> + <h4 class="title"><a id="idp4689192"></a>DB_REP_UNAVAIL</h4> </div> </div> </div> <p> The local site tried to join the group, but was unable to do so for some reason (because a master site is not available, - or because insufficient replicas are running to acknowledge + or because insufficient clients are running to acknowledge the new site). When that happens the application should pause and retry adding the site until it completes successfully. @@ -264,7 +269,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp4620856"></a>EINVAL</h4> + <h4 class="title"><a id="idp4687896"></a>EINVAL</h4> </div> </div> </div> @@ -272,8 +277,11 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> If the database environment was not already opened or was opened without the <code class="literal">DB_THREAD</code> flag set; a local site has not already been configured, this method is called - from a Base API application; or if an invalid - flag value or parameter was specified. + from a Base API application; a view is being started without + having called the + <a class="xref" href="repset_view.html" title="DbEnv::rep_set_view()">DbEnv::rep_set_view()</a> + method before opening the database environment; or if an + invalid flag value or parameter was specified. </p> </div> </div> @@ -281,7 +289,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4603456"></a>Class</h3> + <h3 class="title"><a id="idp4680440"></a>Class</h3> </div> </div> </div> @@ -293,7 +301,7 @@ DbEnv::repmgr_start(int nthreads, u_int32_t flags);</pre> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp4615640"></a>See Also</h3> + <h3 class="title"><a id="idp4682680"></a>See Also</h3> </div> </div> </div> |