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>Getting Started with Replicated Berkeley DB Applications</title> 7 <link rel="stylesheet" href="gettingStarted.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Getting Started with Replicated Berkeley DB Applications" /> 10 <link rel="next" href="preface.html" title="Preface" /> 11 </head> 12 <body> 13 <div class="navheader"> 14 <table width="100%" summary="Navigation header"> 15 <tr> 16 <th colspan="3" align="center">Getting Started with Replicated Berkeley DB Applications</th> 17 </tr> 18 <tr> 19 <td width="20%" align="left">��</td> 20 <th width="60%" align="center">��</th> 21 <td width="20%" align="right">��<a accesskey="n" href="preface.html">Next</a></td> 22 </tr> 23 </table> 24 <hr /> 25 </div> 26 <div class="book" lang="en" xml:lang="en"> 27 <div class="titlepage"> 28 <div> 29 <div> 30 <h1 class="title"><a id="id1463569"></a>Getting Started with Replicated Berkeley DB Applications</h1> 31 </div> 32 <div> 33 <div class="legalnotice"> 34 <a id="id1463750"></a> 35 <p class="legalnotice-title"> 36 <b>Legal Notice</b> 37 </p> 38 <p> 39 This documentation is distributed under an open source license. 40 You may review the terms of this license at: 41 <a class="ulink" href="http://www.oracle.com/technology/software/products/berkeley-db/htdocs/oslicense.html" target="_top">http://www.oracle.com/technology/software/products/berkeley-db/htdocs/oslicense.html</a> 42 43 44 </p> 45 <p> 46 Oracle, Berkeley DB, 47 48 49 and 50 Sleepycat are trademarks or registered trademarks of 51 Oracle. All rights to these marks are reserved. 52 No third-party use is permitted without the 53 express prior written consent of Oracle. 54 </p> 55 <p> 56 To obtain a copy of this document's original source code, please 57 submit a request to the Oracle Technology Network forum at: 58 <a class="ulink" href="http://forums.oracle.com/forums/forum.jspa?forumID=271" target="_top">http://forums.oracle.com/forums/forum.jspa?forumID=271</a> 59 60 61 </p> 62 </div> 63 </div> 64 <div> 65 <p class="pubdate">4/12/2010</p> 66 </div> 67 </div> 68 <hr /> 69 </div> 70 <div class="toc"> 71 <p> 72 <b>Table of Contents</b> 73 </p> 74 <dl> 75 <dt> 76 <span class="preface"> 77 <a href="preface.html">Preface</a> 78 </span> 79 </dt> 80 <dd> 81 <dl> 82 <dt> 83 <span class="sect1"> 84 <a href="preface.html#conventions">Conventions Used in this Book</a> 85 </span> 86 </dt> 87 <dd> 88 <dl> 89 <dt> 90 <span class="sect2"> 91 <a href="preface.html#moreinfo">For More Information</a> 92 </span> 93 </dt> 94 </dl> 95 </dd> 96 </dl> 97 </dd> 98 <dt> 99 <span class="chapter"> 100 <a href="introduction.html">1. Introduction</a> 101 </span> 102 </dt> 103 <dd> 104 <dl> 105 <dt> 106 <span class="sect1"> 107 <a href="introduction.html#overview">Overview</a> 108 </span> 109 </dt> 110 <dd> 111 <dl> 112 <dt> 113 <span class="sect2"> 114 <a href="introduction.html#repenvirons">Replication Environments</a> 115 </span> 116 </dt> 117 <dt> 118 <span class="sect2"> 119 <a href="introduction.html#repdbs">Replication Databases</a> 120 </span> 121 </dt> 122 <dt> 123 <span class="sect2"> 124 <a href="introduction.html#commlayer">Communications Layer</a> 125 </span> 126 </dt> 127 <dt> 128 <span class="sect2"> 129 <a href="introduction.html#masterselect">Selecting a Master</a> 130 </span> 131 </dt> 132 </dl> 133 </dd> 134 <dt> 135 <span class="sect1"> 136 <a href="repadvantage.html">Replication Benefits</a> 137 </span> 138 </dt> 139 <dt> 140 <span class="sect1"> 141 <a href="apioverview.html">The Replication APIs</a> 142 </span> 143 </dt> 144 <dd> 145 <dl> 146 <dt> 147 <span class="sect2"> 148 <a href="apioverview.html#repframeworkoverview">Replication Manager Overview</a> 149 </span> 150 </dt> 151 <dt> 152 <span class="sect2"> 153 <a href="apioverview.html#repapioverview">Replication Base API Overview</a> 154 </span> 155 </dt> 156 </dl> 157 </dd> 158 <dt> 159 <span class="sect1"> 160 <a href="elections.html">Holding Elections</a> 161 </span> 162 </dt> 163 <dd> 164 <dl> 165 <dt> 166 <span class="sect2"> 167 <a href="elections.html#influencingelections">Influencing Elections</a> 168 </span> 169 </dt> 170 <dt> 171 <span class="sect2"> 172 <a href="elections.html#winningelections">Winning Elections</a> 173 </span> 174 </dt> 175 <dt> 176 <span class="sect2"> 177 <a href="elections.html#switchingmasters">Switching Masters</a> 178 </span> 179 </dt> 180 </dl> 181 </dd> 182 <dt> 183 <span class="sect1"> 184 <a href="permmessages.html">Permanent Message Handling</a> 185 </span> 186 </dt> 187 <dd> 188 <dl> 189 <dt> 190 <span class="sect2"> 191 <a href="permmessages.html#permmessagenot">When Not to Manage 192 Permanent Messages</a> 193 </span> 194 </dt> 195 <dt> 196 <span class="sect2"> 197 <a href="permmessages.html#permmanage">Managing Permanent Messages</a> 198 </span> 199 </dt> 200 <dt> 201 <span class="sect2"> 202 <a href="permmessages.html#permimplement">Implementing Permanent 203 Message Handling</a> 204 </span> 205 </dt> 206 </dl> 207 </dd> 208 </dl> 209 </dd> 210 <dt> 211 <span class="chapter"> 212 <a href="txnapp.html">2. Transactional Application</a> 213 </span> 214 </dt> 215 <dd> 216 <dl> 217 <dt> 218 <span class="sect1"> 219 <a href="txnapp.html#appoverview">Application Overview</a> 220 </span> 221 </dt> 222 <dt> 223 <span class="sect1"> 224 <a href="simpleprogramlisting.html">Program Listing</a> 225 </span> 226 </dt> 227 <dd> 228 <dl> 229 <dt> 230 <span class="sect2"> 231 <a href="simpleprogramlisting.html#repconfiginfo_cxx"> 232 <span>Class: RepConfigInfo</span> 233 234 </a> 235 </span> 236 </dt> 237 <dt> 238 <span class="sect2"> 239 <a href="simpleprogramlisting.html#repmgr_cxx">Class: excxx_repquote_gsg_simple</a> 240 </span> 241 </dt> 242 <dt> 243 <span class="sect2"> 244 <a href="simpleprogramlisting.html#usage_cxx">Function: usage()</a> 245 </span> 246 </dt> 247 <dt> 248 <span class="sect2"> 249 <a href="simpleprogramlisting.html#main_cxx">Function: main()</a> 250 </span> 251 </dt> 252 <dt> 253 <span class="sect2"> 254 <a href="simpleprogramlisting.html#repmgr_init_cxx">Method: SimpleTxn::init()</a> 255 </span> 256 </dt> 257 <dt> 258 <span class="sect2"> 259 <a href="simpleprogramlisting.html#doloop_cxx">Method: SimpleTxn::doloop()</a> 260 </span> 261 </dt> 262 <dt> 263 <span class="sect2"> 264 <a href="simpleprogramlisting.html#printstocks_c"> 265 266 <span>Method: SimpleTxn::print_stocks()</span> 267 268 </a> 269 </span> 270 </dt> 271 </dl> 272 </dd> 273 </dl> 274 </dd> 275 <dt> 276 <span class="chapter"> 277 <a href="repapp.html">3. The DB Replication Manager</a> 278 </span> 279 </dt> 280 <dd> 281 <dl> 282 <dt> 283 <span class="sect1"> 284 <a href="repapp.html#rep_init_code"> 285 Starting and Stopping Replication 286 </a> 287 </span> 288 </dt> 289 <dd> 290 <dl> 291 <dt> 292 <span class="sect2"> 293 <a href="repapp.html#election_flags">Managing Election Policies</a> 294 </span> 295 </dt> 296 <dt> 297 <span class="sect2"> 298 <a href="repapp.html#thread_count">Selecting the Number of Threads</a> 299 </span> 300 </dt> 301 </dl> 302 </dd> 303 <dt> 304 <span class="sect1"> 305 <a href="repmgr_init_example_c.html">Adding the Replication Manager to 306 307 <span>RepMgr</span> 308 309 </a> 310 </span> 311 </dt> 312 <dt> 313 <span class="sect1"> 314 <a href="fwrkpermmessage.html">Permanent Message Handling</a> 315 </span> 316 </dt> 317 <dd> 318 <dl> 319 <dt> 320 <span class="sect2"> 321 <a href="fwrkpermmessage.html#fmwrkpermpolicy">Identifying Permanent Message Policies</a> 322 </span> 323 </dt> 324 <dt> 325 <span class="sect2"> 326 <a href="fwrkpermmessage.html#fmwrkpermtimeout">Setting the Permanent Message Timeout</a> 327 </span> 328 </dt> 329 <dt> 330 <span class="sect2"> 331 <a href="fwrkpermmessage.html#perm2fmwrkexample">Adding a Permanent Message Policy to 332 333 <span>RepMgrGSG</span> 334 335 </a> 336 </span> 337 </dt> 338 </dl> 339 </dd> 340 <dt> 341 <span class="sect1"> 342 <a href="electiontimes.html">Managing Election Times</a> 343 </span> 344 </dt> 345 <dd> 346 <dl> 347 <dt> 348 <span class="sect2"> 349 <a href="electiontimes.html#electiontimeout">Managing Election Timeouts</a> 350 </span> 351 </dt> 352 <dt> 353 <span class="sect2"> 354 <a href="electiontimes.html#electretrytime">Managing Election Retry Times</a> 355 </span> 356 </dt> 357 </dl> 358 </dd> 359 <dt> 360 <span class="sect1"> 361 <a href="fmwrkconnectretry.html">Managing Connection Retries</a> 362 </span> 363 </dt> 364 <dt> 365 <span class="sect1"> 366 <a href="heartbeats.html">Managing Heartbeats</a> 367 </span> 368 </dt> 369 </dl> 370 </dd> 371 <dt> 372 <span class="chapter"> 373 <a href="fwrkmasterreplica.html">4. Replica versus Master Processes</a> 374 </span> 375 </dt> 376 <dd> 377 <dl> 378 <dt> 379 <span class="sect1"> 380 <a href="fwrkmasterreplica.html#determinestate">Determining State</a> 381 </span> 382 </dt> 383 <dt> 384 <span class="sect1"> 385 <a href="processingloop.html">Processing Loop</a> 386 </span> 387 </dt> 388 <dt> 389 <span class="sect1"> 390 <a href="exampledoloop.html">Example Processing Loop</a> 391 </span> 392 </dt> 393 <dd> 394 <dl> 395 <dt> 396 <span class="sect2"> 397 <a href="exampledoloop.html#runningit">Running It</a> 398 </span> 399 </dt> 400 </dl> 401 </dd> 402 </dl> 403 </dd> 404 <dt> 405 <span class="chapter"> 406 <a href="addfeatures.html">5. Additional Features</a> 407 </span> 408 </dt> 409 <dd> 410 <dl> 411 <dt> 412 <span class="sect1"> 413 <a href="addfeatures.html#delayedsync">Delayed Synchronization</a> 414 </span> 415 </dt> 416 <dt> 417 <span class="sect1"> 418 <a href="manageblock.html">Managing Blocking Operations</a> 419 </span> 420 </dt> 421 <dt> 422 <span class="sect1"> 423 <a href="noautoinit.html">Stop Auto-Initialization</a> 424 </span> 425 </dt> 426 <dt> 427 <span class="sect1"> 428 <a href="c2ctransfer.html">Client to Client Transfer</a> 429 </span> 430 </dt> 431 <dd> 432 <dl> 433 <dt> 434 <span class="sect2"> 435 <a href="c2ctransfer.html#fmwrkpeerserver">Identifying Peers</a> 436 </span> 437 </dt> 438 </dl> 439 </dd> 440 <dt> 441 <span class="sect1"> 442 <a href="bulk.html">Bulk Transfers</a> 443 </span> 444 </dt> 445 </dl> 446 </dd> 447 </dl> 448 </div> 449 </div> 450 <div class="navfooter"> 451 <hr /> 452 <table width="100%" summary="Navigation footer"> 453 <tr> 454 <td width="40%" align="left">��</td> 455 <td width="20%" align="center">��</td> 456 <td width="40%" align="right">��<a accesskey="n" href="preface.html">Next</a></td> 457 </tr> 458 <tr> 459 <td width="40%" align="left" valign="top">��</td> 460 <td width="20%" align="center">��</td> 461 <td width="40%" align="right" valign="top">��Preface</td> 462 </tr> 463 </table> 464 </div> 465 </body> 466</html> 467