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>Managing Blocking Operations</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="addfeatures.html" title="Chapter 5. Additional Features" /> 12 <link rel="next" href="noautoinit.html" title="Stop Auto-Initialization" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Managing Blocking Operations</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="addfeatures.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="noautoinit.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="manageblock"></a>Managing Blocking Operations</h2> 33 </div> 34 </div> 35 </div> 36 <p> 37 When a replica is in the process of synchronizing with 38 its master, DB operations are blocked at some 39 points during this process until the synchronization is 40 completed. For replicas with a heavy read load, these 41 blocked operations may represent an unacceptable loss 42 in throughput. 43 </p> 44 <p> 45 You can configure DB so that it will not block when synchronization is in 46 process. Instead, the DB operation will fail, 47 48 49 50 <span> 51 immediately throwing a 52 <code class="classname">com.sleepycat.db.ReplicationLockoutException</code> 53 exception. 54 </span> 55 When this happens, it is up to your application to determine 56 what action to take (that is, logging the event, making an appropriate user 57 response, retrying the operation, and so forth). 58 </p> 59 <p> 60 To turn off blocking on synchronization, specify 61 62 <span> 63 <code class="literal">ReplicationConfig.NOWAIT</code> and 64 <code class="literal">true</code> to 65 <code class="methodname">Environment.setReplicationConfig()</code>. 66 To turn off this feature, specify 67 <code class="literal">false</code> for the 68 <code class="literal">ReplicationConfig.NOWAIT</code> field. 69 </span> 70 </p> 71 </div> 72 <div class="navfooter"> 73 <hr /> 74 <table width="100%" summary="Navigation footer"> 75 <tr> 76 <td width="40%" align="left"><a accesskey="p" href="addfeatures.html">Prev</a> </td> 77 <td width="20%" align="center"> 78 <a accesskey="u" href="addfeatures.html">Up</a> 79 </td> 80 <td width="40%" align="right"> <a accesskey="n" href="noautoinit.html">Next</a></td> 81 </tr> 82 <tr> 83 <td width="40%" align="left" valign="top">Chapter 5. Additional Features </td> 84 <td width="20%" align="center"> 85 <a accesskey="h" href="index.html">Home</a> 86 </td> 87 <td width="40%" align="right" valign="top"> Stop Auto-Initialization</td> 88 </tr> 89 </table> 90 </div> 91 </body> 92</html> 93