~ubuntu-branches/ubuntu/edgy/rpm/edgy

« back to all changes in this revision

Viewing changes to db/docs/ref/log/config.html

  • Committer: Bazaar Package Importer
  • Author(s): Joey Hess
  • Date: 2002-01-22 20:56:57 UTC
  • Revision ID: james.westby@ubuntu.com-20020122205657-l74j50mr9z8ofcl5
Tags: upstream-4.0.3
ImportĀ upstreamĀ versionĀ 4.0.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!--$Id: config.so,v 10.18 2001/03/13 18:48:49 bostic Exp $-->
 
2
<!--Copyright 1997-2001 by Sleepycat Software, Inc.-->
 
3
<!--All rights reserved.-->
 
4
<html>
 
5
<head>
 
6
<title>Berkeley DB Reference Guide: Configuring logging</title>
 
7
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
 
8
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
 
9
</head>
 
10
<body bgcolor=white>
 
11
<a name="2"><!--meow--></a>
 
12
<table width="100%"><tr valign=top>
 
13
<td><h3><dl><dt>Berkeley DB Reference Guide:<dd>Logging Subsystem</dl></h3></td>
 
14
<td align=right><a href="../../ref/log/intro.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/log/limits.html"><img src="../../images/next.gif" alt="Next"></a>
 
15
</td></tr></table>
 
16
<p>
 
17
<h1 align=center>Configuring logging</h1>
 
18
<p>The aspects of logging that may be configured are the size of the
 
19
logging subsystem's region, the size of the log files on disk and the
 
20
size of the log buffer in memory.  The <a href="../../api_c/env_set_lg_regionmax.html">DB_ENV-&gt;set_lg_regionmax</a>
 
21
interface specifies the size of the logging subsystem's region, in
 
22
bytes.  The logging subsystem's default size is 60KB.  This value may
 
23
need to be increased if a large number of files are registered with the
 
24
Berkeley DB log manager, for example, by opening a large number of Berkeley DB
 
25
database files in a transactional application.
 
26
<p>The <a href="../../api_c/env_set_lg_max.html">DB_ENV-&gt;set_lg_max</a> interface specifies the individual log file
 
27
size for all the applications sharing the Berkeley DB environment.  Setting
 
28
the log file size is largely a matter of convenience and a reflection
 
29
of the application's preferences in backup media and frequency.
 
30
However, setting the log file size too low can potentially cause
 
31
problems because it would be possible to run out of log sequence
 
32
numbers, which requires a full archival and application restart to
 
33
reset.  See <a href="../../ref/log/limits.html">Log file limits</a> for more
 
34
information.
 
35
<p>The <a href="../../api_c/env_set_lg_bsize.html">DB_ENV-&gt;set_lg_bsize</a> interface specifies the size of the
 
36
in-memory log buffer, in bytes.  Log information is stored in memory
 
37
until the buffer fills up or transaction commit forces the buffer to be
 
38
written to disk.  Larger buffer sizes can significantly increase
 
39
throughput in the presence of long-running transactions, highly
 
40
concurrent applications, or transactions producing large amounts of
 
41
data.  By default, the buffer is 32KB.
 
42
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/log/intro.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/log/limits.html"><img src="../../images/next.gif" alt="Next"></a>
 
43
</td></tr></table>
 
44
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
 
45
</body>
 
46
</html>