From 780b92ada9afcf1d58085a83a0b9e6bc982203d1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Tue, 17 Feb 2015 17:25:57 +0000 Subject: Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz. --- docs/api_reference/C/repconfig.html | 102 +++++++++++++++++++++++++++++------- 1 file changed, 82 insertions(+), 20 deletions(-) (limited to 'docs/api_reference/C/repconfig.html') diff --git a/docs/api_reference/C/repconfig.html b/docs/api_reference/C/repconfig.html index 156cb560..48f72d62 100644 --- a/docs/api_reference/C/repconfig.html +++ b/docs/api_reference/C/repconfig.html @@ -14,7 +14,7 @@
-

Library Version 11.2.5.3

+

Library Version 12.1.6.1

@@ -69,7 +69,8 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff); called to set in-memory replication after the environment is opened using the DB_ENV->open() method. - This method may also not be called to set master leases after the + This method should not be called to set preferred master mode or + master leases after the DB_ENV->rep_start() or DB_ENV->repmgr_start() methods are called. For all other which @@ -88,7 +89,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
-

Parameters

+

Parameters

@@ -96,7 +97,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
-

which

+

which

@@ -185,8 +186,8 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);

  • - Replication Manager applications will no - longer maintain group membership + Replication Manager applications do not + maintain group membership information persistently on-disk. For more information, see Managing Replication Files in the Berkeley DB Programmer's Reference Guide. @@ -243,9 +244,10 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);

    Replication Manager automatically runs elections to - choose a new master when the old master appears to - have become disconnected. This option is turned on - by default. + choose a new master when the old master fails or + becomes disconnected. This option is turned on + by default. In preferred master mode, this option + cannot be turned off.

    If this option is turned off, the application is @@ -266,18 +268,76 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);

    In an application with multiple processes per - database environment, only the main replication + database environment, only the replication process may change this configuration setting.

    • +
  • +

    + DB_REPMGR_CONF_PREFMAS_CLIENT +

    +

    + This is the client site in a two-site + replication group running in preferred master + mode. This site automatically takes over as + temporary master when the preferred master + site is unavailable. Transactions committed + on this site when it is operating as the + temporary master may be rolled back if they + conflict with preferred master transactions. + (See the + + Preferred master mode + section in the Berkeley DB Programmer's Reference Guide + for more information.) This configuration flag may + not be set after the DB_ENV->repmgr_start() method is called. +

    +

    + The other site in the replication group should + be specified as the preferred master site using the + DB_REPMGR_CONF_PREFMAS_MASTER + configuration flag. +

    +
    • +
  • +

    + DB_REPMGR_CONF_PREFMAS_MASTER +

    +

    + This is the preferred master site in a two-site + replication group running in preferred master + mode. This site functions as the master + whenever its availability permits. + When this site returns to the replication + group after having been unavailable, it + synchronizes with the temporary master and + then automatically takes over as master. + Transactions committed on this site will + not be rolled back. (See the + + Preferred master mode + section in the Berkeley DB Programmer's Reference Guide + for more information.) This configuration flag may not + be set after the DB_ENV->repmgr_start() method is called. +

    +

    + The other site in the replication group should + be specified as the preferred master client site + using the + DB_REPMGR_CONF_PREFMAS_CLIENT + configuration flag. +

    +

  • DB_REPMGR_CONF_2SITE_STRICT

    Replication Manager observes the strict "majority" rule in managing - elections, even in a group with only 2 sites. This means the client - in a 2-site group will be unable to take over as master if the + elections, even in a replication group with only two + sites. This means the client + in a two-site replication group will be unable to take + over as master if the original master fails or becomes disconnected. (See the Special considerations for two-site replication groups @@ -285,7 +345,8 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff); section in the Berkeley DB Programmer's Reference Guide for more information.) Both sites in the replication group should have the same value for this configuration flag. This option is turned on by - default. + default. In preferred master mode, this option cannot + be turned off.

    • @@ -295,7 +356,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
    -

    onoff

    +

    onoff

    @@ -311,7 +372,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
    -

    Errors

    +

    Errors

    @@ -327,14 +388,15 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
    -

    EINVAL

    +

    EINVAL

    If setting in-memory replication after the database environment is already - opened; if setting master leases after replication is started; if setting - the 2-site strict majority rule for a Base API application; + opened; if setting preferred master or master leases + after replication is started; if setting a Replication + Manager configuration flag for a Base API application; or if an invalid flag value or parameter was specified.

    @@ -343,7 +405,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
    -

    Class

    +

    Class

    @@ -355,7 +417,7 @@ DB_ENV->rep_set_config(DB_ENV *env, u_int32_t which, int onoff);
    -

    See Also

    +

    See Also

    -- cgit v1.2.1