← Back to branch summary

~ubuntu-branches/debian/sid/glusterfs/sid

« back to all changes in this revision

Viewing changes to xlators/features/marker/utils/syncdaemon/README.md

  • Committer: Package Import Robot
  • Author(s): Patrick Matthäi
  • Date: 2014-04-22 10:00:41 UTC
  • mfrom: (1.3.25)
  • Revision ID: package-import@ubuntu.com-20140422100041-6mur2ttyvb8zzpfq
Tags: 3.5.0-1
* New upstream release.
  - Rewrite patch 01-spelling-error.
  - Adjust lintian overrides.
  - Install new files.
  - The offical tarball is not properly generated, hack it around.
  - Add symlink from fusermount-glusterfs manpage to mount.glusterfs.
  - Move gsync-sync-gfid from /usr/share to /usr/lib.
  - Add benchmarking directory.
* Remove old versioned build dependencies and build depend on libglib2.0-dev.
* Add lintian override for possible-gpl-code-linked-with-openssl. It is the
  same false positive like with the gluster-server package.

Show diffs side-by-side

added added

removed removed

Lines of Context:
xlators/features/marker/utils/syncdaemon/README.md
1
 
gsycnd, the Gluster Syncdaemon
2
 
==============================
3
 
 
4
 
REQUIREMENTS
5
 
------------
6
 
 
7
 
_gsyncd_ is a program which can operate either in _master_ or in _slave_ mode.
8
 
Requirements are categorized according to this.
9
 
 
10
 
* supported OS is GNU/Linux
11
 
* Python >= 2.5, or 2.4 with Ctypes (see below) (both)
12
 
* OpenSSH >= 4.0 (master) / SSH2 compliant sshd (eg. openssh) (slave)
13
 
* rsync (both)
14
 
* glusterfs with marker support (master); glusterfs (optional on slave)
15
 
* FUSE; for supported versions consult glusterfs
16
 
 
17
 
INSTALLATION
18
 
------------
19
 
 
20
 
As of now, the supported way of operation is running from the source directory.
21
 
 
22
 
If you use Python 2.4.x, you need to install the [Ctypes module](http://python.net/crew/theller/ctypes/).
23
 
 
24
 
CONFIGURATION
25
 
-------------
26
 
 
27
 
gsyncd tunables are a subset of the long command-line options; for listing them,
28
 
type
29
 
 
30
 
    gsyncd.py --help
31
 
 
32
 
and see the long options up to "--config-file". (The leading double dash should be omitted;
33
 
interim underscores and dashes are interchangeable.) The set of options bear some resemblance
34
 
to those of glusterfs and rsync.
35
 
 
36
 
The config file format matches the following syntax:
37
 
 
38
 
      <option1>: <value1>
39
 
      <option2>: <value2>
40
 
      # comment
41
 
 
42
 
By default (unless specified by the option `-c`), gsyncd looks for config file at _conf/gsyncd.conf_
43
 
in the source tree.
44
 
 
45
 
USAGE
46
 
-----
47
 
 
48
 
gsyncd is a utilitly for continous mirroring, ie. it mirrors master to slave incrementally.
49
 
Assume we have a gluster volume _pop_ at localhost. We try to set up the following mirrors
50
 
for it with gysncd:
51
 
 
52
 
1. _/data/mirror_
53
 
2. local gluster volume _yow_
54
 
3. _/data/far_mirror_ at example.com
55
 
4. gluster volume _moz_ at example.com
56
 
 
57
 
The respective gsyncd invocations are (demoing some syntax sugaring):
58
 
 
59
 
1.
60
 
 
61
 
      gsyncd.py gluster://localhost:pop file:///data/mirror
62
 
 
63
 
  or short form
64
 
 
65
 
      gsyncd.py :pop /data/mirror
66
 
 
67
 
2. `gsyncd :pop :yow`
68
 
3.
69
 
 
70
 
       gsyncd.py :pop ssh://example.com:/data/far_mirror
71
 
 
72
 
  or short form
73
 
 
74
 
       gsyncd.py :pop example.com:/data/far_mirror
75
 
 
76
 
4. `gsyncd.py :pop example.com::moz`
77
 
 
78
 
gsyncd has to be available on both sides; it's location on the remote side has to be specified
79
 
via the "--remote-gsyncd" option (or "remote-gsyncd" config file parameter). (This option can also be
80
 
used for setting options on the remote side, although the suggested mode of operation is to
81
 
set parameters like log file / pid file in the configuration file.)