File: drbdlinks.8

package info (click to toggle)
drbdlinks 1.09-1.1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 92 kB
  • ctags: 53
  • sloc: python: 265; sh: 80; makefile: 39
file content (66 lines) | stat: -rw-r--r-- 2,587 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH DRBDLINKS 8 "July  9, 2005"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
drbdlinks \- manages links into a shared DRBD partition
.SH SYNOPSIS
.B drbdlinks
.RI [start|stop|auto|status|monitor]
.SH DESCRIPTION

.B drbdlinks
is a program which manages links into a DRBD partition which is shared
among several machines.  It is meant to be used in conjunction with the
heartbeat system for simplifying management of high availability clusters.
A simple configuration file, "/etc/drbdlinks.conf", specifies the links.
This can be used to manage links for "/etc/apache", "/var/lib/pgsql", and
other system directories that need to appear as if they are local to
the system when running applications after a DRBD shared partition has
been mounted.

A sample configuration file with annotations is included in the drbdlinks
distribution.

When run with "start" as the mode, drbdlinks will rename the existing
files/directories, and then make symbolic links into the DRBD
partition.  "stop" does the reverse.

The "monitor" and "status" modes will check the file-system against the
configuration file and will report "running" (monitor mode) or "OK" (status
mode) if all links appear to be up.  Otherwise they report "down" or
"stopped" (respectively).

By default, the rename appends .drbdlinks to the name, but this can be
overridden in the configuration file.

An init script is included which runs "stop" before heartbeat starts,
and after heartbeat stops.  This is done to try to ensure that when
the shared partition isn't mounted, the links are in their normal
state.

.SH SEE ALSO
.BR DRBD (8),
.BR drbdadm (8),
.BR drbdsetup (8),
.BR heartbeat (8).
.SH AUTHOR
drbdlinks was written by Sean Reifschneider <jafo@tummy.com>.
.PP
This manual page was written by Cyril Bouthors <cyril@bouthors.org>,
for the Debian project (but may be used by others).  Sean Reifschneider
modified it for status and monitor arguments, and included it in the base
drbdlinks release.