forked from rsnapshot/rsnapshot
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
139 lines (108 loc) · 5.35 KB
/
INSTALL
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
rsnapshot 1.3.1
http://www.rsnapshot.org/
rsnapshot is a filesystem snapshot utility. It uses rsync to take
snapshots of local and remote filesystems for any number of machines,
and then rotates the snapshots according to your rsnapshot.conf.
rsnapshot comes with ABSOLUTELY NO WARRANTY. This is free software,
and you are welcome to redistribute it under certain conditions.
See the GNU General Public Licence for details.
+------------------------+
| CONTENTS |
+------------------------+
- Installation
- Quick Start
- Upgrading
- Additional Options
------------------------------------------------------------------------------
INSTALLATION
------------------------------------------------------------------------------
---------------
QUICK START
---------------
If you are installing for the first time (and just want the defaults):
Run these commands for a quick installation from source code:
(skip these commands if you have installed rpm or debian package)
./configure --sysconfdir=/etc
su
make install
cp /etc/rsnapshot.conf.default /etc/rsnapshot.conf
Open up /etc/rsnapshot.conf with a text editor, and modify it for your
system.
Make sure the config file syntax is valid (remember, tabs, not spaces):
/usr/local/bin/rsnapshot configtest
The rsnapshot HOWTO is recommended reading for first time setups. It will
walk you through this process in great detail.
The rsnapshot HOWTO can be found online at http://www.rsnapshot.org/
-------------
UPGRADING
-------------
If you are upgrading from a previous installation of rsnapshot 1.1.x,
please read the file:
docs/Upgrading_from_1.1
There are no special instructions for upgrading from rsnapshot 1.2.x to
1.3.x, since both use config_version 1.2.
If you are not sure whether you need to do anything to upgrade your
old rsnapshot.conf, you can run
make upgrade
or
rsnapshot upgrade-config-file
or
rsnapshot -c /etc/rsnapshot.conf upgrade-config-file
----------------------
ADDITIONAL OPTIONS
----------------------
If you require more precise control over the locations of files:
You can pass the following options to ./configure for more control
over where various parts of rsnapshot are installed. The example
values shown also happen to be the defaults.
--prefix=/usr/local
This will install everything under /usr/local
--sysconfdir=/usr/local/etc
This will install the example config file
(rsnapshot.conf.default) under /usr/local/etc. This will also be
the default directory where rsnapshot looks for its config file.
It is recommended that you copy rsnapshot.conf.default and use it
as a basis for the actual config file (rsnapshot.conf).
--bindir=/usr/local/bin
This will install the rsnapshot program under /usr/local/bin
--mandir=/usr/local/man
This will install the man page under /usr/local/man
--with-perl=/usr/bin/perl
Specify your preferred path to perl. If you don't specify
this, the build process will detect the first version of perl
it finds in your path.
--with-rsync=/usr/bin/rsync
Specify your preferred path to rsync. If you don't specify
this, the build process will detect the first version of rsync
it finds in your path. You can always change this later by
editing the config file (rsnapshot.conf).
--with-cp=/bin/cp
Specify the path to GNU cp. The traditional UNIX cp command
is not sufficient. If you don't specify this, the build process
will detect the first version of cp it finds in your path.
If you don't have the GNU version of cp, leave this commented
out in the config file (rsnapshot.conf).
--with-rm=/bin/rm
Specify the path to the rm command. If you don't specify this,
the build process will detect the first version of rm it finds
in your path.
--with-ssh=/usr/bin/ssh
Specify your preferred path to ssh. If you don't specify this,
the build process will detect the first version of ssh it
finds in your path. SSH is an optional feature, so it is OK if
it isn't on your system. Either way, if you want to use ssh,
you need to specifically enable this feature by uncommenting
the "cmd_ssh" parameter in the config file (rsnapshot.conf).
--with-logger=/usr/bin/logger
Specify your preferred path to logger. If you don't specify
this, the build process will detect the first version of
logger it finds in your path. If you want syslog support,
make sure this is enabled in the config file. Syslog support
is optional, so if you don't have it or comment it out it's OK.
--with-du=/usr/bin/du
Specify your preferred path to du. If you don't specify
this, the build process will detect the first version of
du it finds in your path. The "du" command only gets used
when rsnapshot is called with the "du" argument to calculate
the amount of disk space used. This is optional, so if you
don't have it or comment it out it's OK.