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="id1463295"></a>Getting Started with Replicated Berkeley DB Applications</h1> 31 </div> 32 <div> 33 <div class="legalnotice"> 34 <a id="id1463475"></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#main_c">Function: main()</a> 232 </span> 233 </dt> 234 <dt> 235 <span class="sect2"> 236 <a href="simpleprogramlisting.html#create_env_c">Function: create_env()</a> 237 </span> 238 </dt> 239 <dt> 240 <span class="sect2"> 241 <a href="simpleprogramlisting.html#env_init_c">Function: env_init()</a> 242 </span> 243 </dt> 244 <dt> 245 <span class="sect2"> 246 <a href="simpleprogramlisting.html#doloop_c">Function: doloop()</a> 247 </span> 248 </dt> 249 <dt> 250 <span class="sect2"> 251 <a href="simpleprogramlisting.html#printstocks_c"> 252 <span>Function: print_stocks()</span> 253 254 255 </a> 256 </span> 257 </dt> 258 </dl> 259 </dd> 260 </dl> 261 </dd> 262 <dt> 263 <span class="chapter"> 264 <a href="repapp.html">3. The DB Replication Manager</a> 265 </span> 266 </dt> 267 <dd> 268 <dl> 269 <dt> 270 <span class="sect1"> 271 <a href="repapp.html#rep_init_code"> 272 Starting and Stopping Replication 273 </a> 274 </span> 275 </dt> 276 <dd> 277 <dl> 278 <dt> 279 <span class="sect2"> 280 <a href="repapp.html#election_flags">Managing Election Policies</a> 281 </span> 282 </dt> 283 <dt> 284 <span class="sect2"> 285 <a href="repapp.html#thread_count">Selecting the Number of Threads</a> 286 </span> 287 </dt> 288 </dl> 289 </dd> 290 <dt> 291 <span class="sect1"> 292 <a href="repmgr_init_example_c.html">Adding the Replication Manager to 293 <span>ex_rep_gsg_simple</span> 294 295 296 </a> 297 </span> 298 </dt> 299 <dt> 300 <span class="sect1"> 301 <a href="fwrkpermmessage.html">Permanent Message Handling</a> 302 </span> 303 </dt> 304 <dd> 305 <dl> 306 <dt> 307 <span class="sect2"> 308 <a href="fwrkpermmessage.html#fmwrkpermpolicy">Identifying Permanent Message Policies</a> 309 </span> 310 </dt> 311 <dt> 312 <span class="sect2"> 313 <a href="fwrkpermmessage.html#fmwrkpermtimeout">Setting the Permanent Message Timeout</a> 314 </span> 315 </dt> 316 <dt> 317 <span class="sect2"> 318 <a href="fwrkpermmessage.html#perm2fmwrkexample">Adding a Permanent Message Policy to 319 <span>ex_rep_gsg_repmgr</span> 320 321 322 </a> 323 </span> 324 </dt> 325 </dl> 326 </dd> 327 <dt> 328 <span class="sect1"> 329 <a href="electiontimes.html">Managing Election Times</a> 330 </span> 331 </dt> 332 <dd> 333 <dl> 334 <dt> 335 <span class="sect2"> 336 <a href="electiontimes.html#electiontimeout">Managing Election Timeouts</a> 337 </span> 338 </dt> 339 <dt> 340 <span class="sect2"> 341 <a href="electiontimes.html#electretrytime">Managing Election Retry Times</a> 342 </span> 343 </dt> 344 </dl> 345 </dd> 346 <dt> 347 <span class="sect1"> 348 <a href="fmwrkconnectretry.html">Managing Connection Retries</a> 349 </span> 350 </dt> 351 <dt> 352 <span class="sect1"> 353 <a href="heartbeats.html">Managing Heartbeats</a> 354 </span> 355 </dt> 356 </dl> 357 </dd> 358 <dt> 359 <span class="chapter"> 360 <a href="fwrkmasterreplica.html">4. Replica versus Master Processes</a> 361 </span> 362 </dt> 363 <dd> 364 <dl> 365 <dt> 366 <span class="sect1"> 367 <a href="fwrkmasterreplica.html#determinestate">Determining State</a> 368 </span> 369 </dt> 370 <dt> 371 <span class="sect1"> 372 <a href="processingloop.html">Processing Loop</a> 373 </span> 374 </dt> 375 <dt> 376 <span class="sect1"> 377 <a href="exampledoloop.html">Example Processing Loop</a> 378 </span> 379 </dt> 380 <dd> 381 <dl> 382 <dt> 383 <span class="sect2"> 384 <a href="exampledoloop.html#runningit">Running It</a> 385 </span> 386 </dt> 387 </dl> 388 </dd> 389 </dl> 390 </dd> 391 <dt> 392 <span class="chapter"> 393 <a href="addfeatures.html">5. Additional Features</a> 394 </span> 395 </dt> 396 <dd> 397 <dl> 398 <dt> 399 <span class="sect1"> 400 <a href="addfeatures.html#delayedsync">Delayed Synchronization</a> 401 </span> 402 </dt> 403 <dt> 404 <span class="sect1"> 405 <a href="manageblock.html">Managing Blocking Operations</a> 406 </span> 407 </dt> 408 <dt> 409 <span class="sect1"> 410 <a href="noautoinit.html">Stop Auto-Initialization</a> 411 </span> 412 </dt> 413 <dt> 414 <span class="sect1"> 415 <a href="c2ctransfer.html">Client to Client Transfer</a> 416 </span> 417 </dt> 418 <dd> 419 <dl> 420 <dt> 421 <span class="sect2"> 422 <a href="c2ctransfer.html#fmwrkpeerserver">Identifying Peers</a> 423 </span> 424 </dt> 425 </dl> 426 </dd> 427 <dt> 428 <span class="sect1"> 429 <a href="bulk.html">Bulk Transfers</a> 430 </span> 431 </dt> 432 </dl> 433 </dd> 434 </dl> 435 </div> 436 </div> 437 <div class="navfooter"> 438 <hr /> 439 <table width="100%" summary="Navigation footer"> 440 <tr> 441 <td width="40%" align="left">��</td> 442 <td width="20%" align="center">��</td> 443 <td width="40%" align="right">��<a accesskey="n" href="preface.html">Next</a></td> 444 </tr> 445 <tr> 446 <td width="40%" align="left" valign="top">��</td> 447 <td width="20%" align="center">��</td> 448 <td width="40%" align="right" valign="top">��Preface</td> 449 </tr> 450 </table> 451 </div> 452 </body> 453</html> 454