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>Stop Auto-Initialization</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="up" href="addfeatures.html" title="Chapter 5. Additional Features" /> 11 <link rel="prev" href="manageblock.html" title="Managing Blocking Operations" /> 12 <link rel="next" href="c2ctransfer.html" title="Client to Client Transfer" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Stop Auto-Initialization</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="manageblock.html">Prev</a> </td> 22 <th width="60%" align="center">Chapter 5. Additional Features</th> 23 <td width="20%" align="right"> <a accesskey="n" href="c2ctransfer.html">Next</a></td> 24 </tr> 25 </table> 26 <hr /> 27 </div> 28 <div class="sect1" lang="en" xml:lang="en"> 29 <div class="titlepage"> 30 <div> 31 <div> 32 <h2 class="title" style="clear: both"><a id="noautoinit"></a>Stop Auto-Initialization</h2> 33 </div> 34 </div> 35 </div> 36 <p> 37 As stated in the previous section, when a replication 38 replica is synchronizing with its master, it will block 39 DB operations at some points during this process 40 until the synchronization is completed. You can turn 41 off this behavior (see <a class="xref" href="manageblock.html" title="Managing Blocking Operations">Managing Blocking Operations</a>), but for replicas 42 that have been out of touch from their master for a 43 very long time, this may not be enough. 44 45 </p> 46 <p> 47 If a replica has been out of touch from its master long enough, it may find that 48 it is not possible to perform synchronization. When this happens, by default the 49 master and replica internally decide to completely re-initialize the replica. 50 This re-initialization involves discarding the replica's current database(s) and 51 transferring new ones to it from the master. Depending on the size of the master's 52 databases, this can take a long time, during which time the replica will be 53 completely non-responsive when it comes to performing database operations. 54 </p> 55 <p> 56 It is possible that there is a time of the day when it is better to perform a replica 57 re-initialization. Or, you simply might want to decide to bring the replica up to 58 speed by restoring its databases using a hot-backup taken from the master. Either 59 way, you can decide to prevent automatic-initialization of your replica. To do this 60 specify 61 <span> 62 <code class="literal">DB_REP_CONF_NOAUTOINIT</code> to 63 <code class="methodname">DB_ENV->rep_set_config()</code> 64 65 and then specify <code class="literal">1</code> to the <code class="literal">onoff</code> 66 parameter. (Specify <code class="literal">0</code> to turn the feature off.) 67 </span> 68 69 </p> 70 </div> 71 <div class="navfooter"> 72 <hr /> 73 <table width="100%" summary="Navigation footer"> 74 <tr> 75 <td width="40%" align="left"><a accesskey="p" href="manageblock.html">Prev</a> </td> 76 <td width="20%" align="center"> 77 <a accesskey="u" href="addfeatures.html">Up</a> 78 </td> 79 <td width="40%" align="right"> <a accesskey="n" href="c2ctransfer.html">Next</a></td> 80 </tr> 81 <tr> 82 <td width="40%" align="left" valign="top">Managing Blocking Operations </td> 83 <td width="20%" align="center"> 84 <a accesskey="h" href="index.html">Home</a> 85 </td> 86 <td width="40%" align="right" valign="top"> Client to Client Transfer</td> 87 </tr> 88 </table> 89 </div> 90 </body> 91</html> 92