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