Installation of rsync
For security reasons, running the rsync server as an unprivileged user and group
is encouraged. If you intend to run rsync as a daemon, create the
rsyncd
user and group with the
following commands issued by the root
user:
groupadd -g 48 rsyncd &&
useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd \
-s /bin/false -u 48 rsyncd
Install rsync by running the
following commands:
./configure --prefix=/usr &&
make
If you have Doxygen-1.5.2 installed and wish to build HTML
API documentation, issue doxygen.
If you have DocBook-utils-0.6.14 installed and wish
to build the user documentation, issue any or all of the following
commands:
pushd doc &&
docbook2pdf rsync.sgml &&
docbook2ps rsync.sgml &&
docbook2dvi rsync.sgml &&
docbook2txt rsync.sgml &&
docbook2html --nochunks rsync.sgml &&
popd
To test the results, issue: make
check.
Now, as the root
user:
make install
If you built the documentation, install it using the following
commands as the root
user:
install -v -m755 -d /usr/share/doc/rsync-3.0.2/api &&
install -v -m644 dox/html/* /usr/share/doc/rsync-3.0.2/api &&
install -v -m644 doc/rsync.* /usr/share/doc/rsync-3.0.2
Configuring rsync
Config Files
/etc/rsyncd.conf
Configuration Information
For client access to remote files, you may need to install the
OpenSSH-4.7p1 package to connect to the
remote server.
This is a simple download-only configuration to set up running
rsync as a server.
See the rsyncd.conf(5) man-page for additional options (i.e.,
user authentication).
cat > /etc/rsyncd.conf << "EOF"
# This is a basic rsync configuration file
# It exports a single module without user authentication.
motd file = /home/rsync/welcome.msg
use chroot = yes
[localhost]
path = /home/rsync
comment = Default rsync module
read only = yes
list = yes
uid = rsyncd
gid = rsyncd
EOF
You can find additional configuration information and general
documentation about rsync at http://rsync.samba.org/documentation.html.
Boot Script
Note that you only want to start the rsync server if you want to provide an
rsync archive on your local
machine. You don't need this script to run the rsync client.
Install the /etc/rc.d/init.d/rsyncd
init script included in the blfs-bootscripts-20080816 package.
make install-rsyncd