← Back to branch summary

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

« back to all changes in this revision

Viewing changes to db/docs/ref/env/remote.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:
db/docs/ref/env/remote.html
 
1
<!--$Id: remote.so,v 11.6 2001/03/01 15:58:04 bostic Exp $-->
 
2
<!--Copyright 1997-2001 by Sleepycat Software, Inc.-->
 
3
<!--All rights reserved.-->
 
4
<html>
 
5
<head>
 
6
<title>Berkeley DB Reference Guide: Remote filesystems</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>Environment</dl></h3></td>
 
14
<td align=right><a href="../../ref/env/region.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/env/open.html"><img src="../../images/next.gif" alt="Next"></a>
 
15
</td></tr></table>
 
16
<p>
 
17
<h1 align=center>Remote filesystems</h1>
 
18
<p>When regions are backed by the filesystem, it is a common error to attempt
 
19
to create Berkeley DB environments backed by remote filesystems such as the
 
20
Network File System (NFS) or the Andrew File System (AFS).  Remote
 
21
filesystems rarely support mapping files into process memory, and even
 
22
more rarely support correct semantics for mutexes after the attempt
 
23
succeeds.  For this reason, we strongly recommend that the database
 
24
environment directory reside in a local filesystem.
 
25
<p>For remote filesystems that do allow system files to be mapped into
 
26
process memory, home directories accessed via remote filesystems cannot
 
27
be used simultaneously from multiple clients.  None of the commercial
 
28
remote filesystems available today implement coherent, distributed
 
29
shared memory for remote-mounted files.  As a result, different machines
 
30
will see different versions of these shared regions, and the system
 
31
behavior is undefined.
 
32
<p>Databases, log files, and temporary files may be placed on remote
 
33
filesystems, <b>as long as the remote filesystem fully supports
 
34
standard POSIX filesystem semantics</b> (although the application may
 
35
incur a performance penalty for doing so).  Obviously, NFS-mounted
 
36
databases cannot be accessed from more than one Berkeley DB environment at a
 
37
time (and therefore from more than one system), because no Berkeley DB
 
38
database may be accessed from more than one Berkeley DB environment at a
 
39
time.
 
40
<p><dl compact>
 
41
<p><dt>Linux note:<dd>Some Linux releases are known to not support complete semantics for the
 
42
POSIX fsync call on NFS-mounted filesystems.  No Berkeley DB files should be
 
43
placed on NFS-mounted filesystems on these systems.
 
44
</dl>
 
45
<table width="100%"><tr><td><br></td><td align=right><a href="../../ref/env/region.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../../reftoc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../../ref/env/open.html"><img src="../../images/next.gif" alt="Next"></a>
 
46
</td></tr></table>
 
47
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
 
48
</body>
 
49
</html>