1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>Chapter��10.�� Replication Methods</title> 7 <link rel="stylesheet" href="apiReference.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB C API Reference" /> 10 <link rel="up" href="index.html" title="Berkeley DB C API Reference" /> 11 <link rel="prev" href="mutexunlock.html" title="DB_ENV->mutex_unlock()" /> 12 <link rel="next" href="repelect.html" title="DB_ENV->rep_elect()" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Chapter��10.�� 19 Replication Methods 20 </th> 21 </tr> 22 <tr> 23 <td width="20%" align="left"><a accesskey="p" href="mutexunlock.html">Prev</a>��</td> 24 <th width="60%" align="center">��</th> 25 <td width="20%" align="right">��<a accesskey="n" href="repelect.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="chapter" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title"><a id="rep"></a>Chapter��10.�� 35 Replication Methods 36 </h2> 37 </div> 38 </div> 39 </div> 40 <p> 41 This chapter describes the APIs available to build Berkeley DB replicated 42 applications. There are two different ways to build replication into a Berkeley DB 43 application, and the APIs for both are described in this chapter. 44 </p> 45 <p> 46 For an overview of the two different ways to build a replicated 47 application, see the <em class="citetitle">Berkeley DB Getting Started with Replicated Applications</em> guide. 48 </p> 49 <p> 50 The first, and simplest, way to build a replication Berkeley DB application is via 51 the <span class="emphasis"><em>Replication Manager</em></span>. If the Replication Manager does not 52 meet your application's architectural requirements, they you can write your own 53 replication implementation using the "Base APIs". 54 </p> 55 <p> 56 Note that the Replication Manager is written using the Base APIs. 57 </p> 58 <p> 59 Note, also, that applications which make use of the Replication Manager 60 use many of the Base APIs as the situation warrants. That said, 61 a few Base API methods cannot be used by applications that 62 are making use of the Replication Manager. Where this is 63 the case, this is noted in the following method 64 descriptions. 65 </p> 66 <div class="sect1" lang="en" xml:lang="en"> 67 <div class="titlepage"> 68 <div> 69 <div> 70 <h2 class="title" style="clear: both"><a id="replist"></a>Replication and Related Methods</h2> 71 </div> 72 </div> 73 </div> 74 <div class="navtable"> 75 <table border="1" width="80%"> 76 <thead> 77 <tr> 78 <th>Replication Manager Methods</th> 79 <th>Description</th> 80 </tr> 81 </thead> 82 <tbody> 83 <tr> 84 <td> 85 <a class="xref" href="repmgrremote_site.html" title="DB_ENV->repmgr_add_remote_site()">DB_ENV->repmgr_add_remote_site()</a> 86 </td> 87 <td>Specify the Replication Manager's remote sites</td> 88 </tr> 89 <tr> 90 <td><a class="xref" href="repmgrset_ack_policy.html" title="DB_ENV->repmgr_set_ack_policy()">DB_ENV->repmgr_set_ack_policy()</a>, <a class="xref" href="repmgrget_ack_policy.html" title="DB_ENV->repmgr_get_ack_policy()">DB_ENV->repmgr_get_ack_policy()</a></td> 91 <td>Specify the Replication Manager's client acknowledgement policy</td> 92 </tr> 93 <tr> 94 <td> 95 <a class="xref" href="repmgrlocal_site.html" title="DB_ENV->repmgr_set_local_site()">DB_ENV->repmgr_set_local_site()</a> 96 </td> 97 <td>Specify the Replication Manager's local site</td> 98 </tr> 99 <tr> 100 <td> 101 <a class="xref" href="repmgrsite_list.html" title="DB_ENV->repmgr_site_list()">DB_ENV->repmgr_site_list()</a> 102 </td> 103 <td>List the sites and their status</td> 104 </tr> 105 <tr> 106 <td> 107 <a class="xref" href="repmgrstart.html" title="DB_ENV->repmgr_start()">DB_ENV->repmgr_start()</a> 108 </td> 109 <td>Start the Replication Manager</td> 110 </tr> 111 <tr> 112 <td> 113 <a class="xref" href="repmgrstat.html" title="DB_ENV->repmgr_stat()">DB_ENV->repmgr_stat()</a> 114 </td> 115 <td>Replication Manager statistics</td> 116 </tr> 117 <tr> 118 <td> 119 <a class="xref" href="repmgrstat_print.html" title="DB_ENV->repmgr_stat_print()">DB_ENV->repmgr_stat_print()</a> 120 </td> 121 <td>Print Replication Manager statistics</td> 122 </tr> 123 <tr> 124 <td colspan="2"> 125 <span class="bold"> 126 <strong>Base API Methods</strong> 127 </span> 128 </td> 129 </tr> 130 <tr> 131 <td> 132 <a class="xref" href="repelect.html" title="DB_ENV->rep_elect()">DB_ENV->rep_elect()</a> 133 </td> 134 <td>Hold a replication election</td> 135 </tr> 136 <tr> 137 <td> 138 <a class="xref" href="repmessage.html" title="DB_ENV->rep_process_message()">DB_ENV->rep_process_message()</a> 139 </td> 140 <td>Process a replication message</td> 141 </tr> 142 <tr> 143 <td> 144 <a class="xref" href="reptransport.html" title="DB_ENV->rep_set_transport()">DB_ENV->rep_set_transport()</a> 145 </td> 146 <td>Configure replication transport callback</td> 147 </tr> 148 <tr> 149 <td> 150 <a class="xref" href="repstart.html" title="DB_ENV->rep_start()">DB_ENV->rep_start()</a> 151 </td> 152 <td>Start replication</td> 153 </tr> 154 <tr> 155 <td colspan="2"> 156 <span class="bold"> 157 <strong>Additional Replication Methods</strong> 158 </span> 159 </td> 160 </tr> 161 <tr> 162 <td> 163 <a class="xref" href="repstat.html" title="DB_ENV->rep_stat()">DB_ENV->rep_stat()</a> 164 </td> 165 <td>Replication statistics</td> 166 </tr> 167 <tr> 168 <td> 169 <a class="xref" href="repstat_print.html" title="DB_ENV->rep_stat_print()">DB_ENV->rep_stat_print()</a> 170 </td> 171 <td>Print replication statistics</td> 172 </tr> 173 <tr> 174 <td> 175 <a class="xref" href="repsync.html" title="DB_ENV->rep_sync()">DB_ENV->rep_sync()</a> 176 </td> 177 <td>Replication synchronization</td> 178 </tr> 179 <tr> 180 <td colspan="2"> 181 <span class="bold"> 182 <strong>Replication Configuration</strong> 183 </span> 184 </td> 185 </tr> 186 <tr> 187 <td><a class="xref" href="repclockskew.html" title="DB_ENV->rep_set_clockskew()">DB_ENV->rep_set_clockskew()</a>, <a class="xref" href="repget_clockskew.html" title="DB_ENV->rep_get_clockskew()">DB_ENV->rep_get_clockskew()</a></td> 188 <td>Configure master lease clock adjustment</td> 189 </tr> 190 <tr> 191 <td><a class="xref" href="repconfig.html" title="DB_ENV->rep_set_config()">DB_ENV->rep_set_config()</a>, <a class="xref" href="repget_config.html" title="DB_ENV->rep_get_config()">DB_ENV->rep_get_config()</a></td> 192 <td>Configure the replication subsystem</td> 193 </tr> 194 <tr> 195 <td><a class="xref" href="repset_limit.html" title="DB_ENV->rep_set_limit()">DB_ENV->rep_set_limit()</a>, <a class="xref" href="repget_limit.html" title="DB_ENV->rep_get_limit()">DB_ENV->rep_get_limit()</a></td> 196 <td>Limit data sent in response to a single message</td> 197 </tr> 198 <tr> 199 <td><a class="xref" href="repnsites.html" title="DB_ENV->rep_set_nsites()">DB_ENV->rep_set_nsites()</a>, <a class="xref" href="repget_nsites.html" title="DB_ENV->rep_get_nsites()">DB_ENV->rep_get_nsites()</a></td> 200 <td>Configure replication group site count</td> 201 </tr> 202 <tr> 203 <td><a class="xref" href="reppriority.html" title="DB_ENV->rep_set_priority()">DB_ENV->rep_set_priority()</a>, <a class="xref" href="repget_priority.html" title="DB_ENV->rep_get_priority()">DB_ENV->rep_get_priority()</a></td> 204 <td>Configure replication site priority</td> 205 </tr> 206 <tr> 207 <td><a class="xref" href="repset_request.html" title="DB_ENV->rep_set_request()">DB_ENV->rep_set_request()</a>, <a class="xref" href="repget_request.html" title="DB_ENV->rep_get_request()">DB_ENV->rep_get_request()</a></td> 208 <td>Configure replication client retransmission requests</td> 209 </tr> 210 <tr> 211 <td><a class="xref" href="repset_timeout.html" title="DB_ENV->rep_set_timeout()">DB_ENV->rep_set_timeout()</a>, <a class="xref" href="repget_timeout.html" title="DB_ENV->rep_get_timeout()">DB_ENV->rep_get_timeout()</a></td> 212 <td>Configure replication timeouts</td> 213 </tr> 214 </tbody> 215 </table> 216 </div> 217 </div> 218 </div> 219 <div class="navfooter"> 220 <hr /> 221 <table width="100%" summary="Navigation footer"> 222 <tr> 223 <td width="40%" align="left"><a accesskey="p" href="mutexunlock.html">Prev</a>��</td> 224 <td width="20%" align="center">��</td> 225 <td width="40%" align="right">��<a accesskey="n" href="repelect.html">Next</a></td> 226 </tr> 227 <tr> 228 <td width="40%" align="left" valign="top">DB_ENV->mutex_unlock()��</td> 229 <td width="20%" align="center"> 230 <a accesskey="h" href="index.html">Home</a> 231 </td> 232 <td width="40%" align="right" valign="top">��DB_ENV->rep_elect()</td> 233 </tr> 234 </table> 235 </div> 236 </body> 237</html> 238