Library Version 11.2.5.3

Chapter 11.  Replication Methods
Prev     Next

Chapter 11.  Replication Methods

This chapter describes the APIs available to build Berkeley DB replicated applications. There are two different ways to build replication into a Berkeley DB application, and the APIs for both are described in this chapter.

For an overview of the two different ways to build a replicated application, see the Berkeley DB Getting Started with Replicated Applications guide.

The first, and simplest, way to build a replication Berkeley DB application is via the Replication Manager. If the Replication Manager does not meet your application's architectural requirements, you can write your own replication implementation using the "Base APIs".

Note that the Replication Manager is written using the Base APIs.

Note, also, that applications which make use of the Replication Manager use many of the Base APIs as the situation warrants. That said, a few Base API methods cannot be used by applications that are making use of the Replication Manager. Where this is the case, this is noted in the following method descriptions.

Finally, Replication Manager applications use the DbSite class to manage and configure replication sites. This handle is not used in any way by Base API applications.

Replication and Related Methods

Replication Manager Methods Description
DbChannel::close() Closes a DB_CHANNEL handle
DbChannel::send_msg() Sends an asynchronous message on a DB_CHANNEL
DbChannel::send_request() Sends a synchronous message on a DB_CHANNEL
DbChannel::set_timeout() Sets the default timeout for the DB_CHANNEL
DbEnv::repmgr_channel() Creates a DB_CHANNEL handle
DbEnv::repmgr_local_site() Returns a DB_SITE handle for the local site
DbEnv::repmgr_msg_dispatch() Creates a DB_CHANNEL handle
DbEnv::repmgr_set_ack_policy(), DbEnv::repmgr_get_ack_policy() Specify the Replication Manager's client acknowledgement policy
DbEnv::repmgr_site() Creates a DB_SITE handle
DbEnv::repmgr_site_by_eid() Creates a DB_SITE handle given an EID value
DbEnv::repmgr_site_list() List the sites and their status
DbEnv::repmgr_start() Start the Replication Manager
DbEnv::repmgr_stat() Replication Manager statistics
DbEnv::repmgr_stat_print() Print Replication Manager statistics
Base API Methods
DbEnv::rep_elect() Hold a replication election
DbEnv::rep_process_message() Process a replication message
DbEnv::rep_set_transport() Configure replication transport callback
DbEnv::rep_start() Start replication
Additional Replication Methods
DbEnv::rep_stat() Replication statistics
DbEnv::rep_stat_print() Print replication statistics
DbEnv::rep_sync() Replication synchronization
DbEnv::txn_applied() Check if a transaction has been replicated
Replication Configuration
DbSite::close() Closes the DB_SITE handle
DbSite::get_address() Returns a site's network address
DbSite::get_eid() Returns a site's Environment ID
DbSite::remove() Removes the site from the replication group
DbSite::set_config(), DbSite::get_config() Configure a DB_SITE handle
DbEnv::rep_set_clockskew(), DbEnv::rep_get_clockskew() Configure master lease clock adjustment
DbEnv::rep_set_config(), DbEnv::rep_get_config() Configure the replication subsystem
DbEnv::rep_set_limit(), DbEnv::rep_get_limit() Limit data sent in response to a single message
DbEnv::rep_set_nsites(), DbEnv::rep_get_nsites() Configure replication group site count
DbEnv::rep_set_priority(), DbEnv::rep_get_priority() Configure replication site priority
DbEnv::rep_set_request(), DbEnv::rep_get_request() Configure replication client retransmission requests
DbEnv::rep_set_timeout(), DbEnv::rep_get_timeout() Configure replication timeouts
Transaction Operations
DbTxn::set_commit_token() Set a commit token
Prev     Next
DbEnv::mutex_unlock()  Home  The DbSite Handle