File: rsbackup-debian.html

package info (click to toggle)
rsbackup 10.0-4
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 1,908 kB
  • sloc: cpp: 10,859; sh: 2,566; makefile: 387; perl: 11
file content (150 lines) | stat: -rw-r--r-- 4,207 bytes parent folder | download | duplicates (3)
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
139
140
141
142
143
144
145
146
147
148
149
150
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
Copyright (c) 2011 Richard Kettlewell

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
-->
<html>
  <head>
    <title>rsbackup and Debian</title>
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
    <link rel=StyleSheet type="text/css" media=screen href="rsbackup.css">
  </head>
  <body>
    <h1>rsbackup and Debian</h1>

    <p>The Debian package of <code>rsbackup</code> has some extra
    features.  You could use these on other systems but on Debian they
    are set up to work automatically.</p>

    <h2><code>/etc/rsbackup/config</code></h2>

    <p>In the <code>.deb</code> package, the default
    <code>/etc/rsbackup/config</code> is as follows:</p>

    <pre class=example># Location of lockfile
lock /var/run/rsbackup.lock

# User configuration
include /etc/rsbackup/local

# Hosts
include /etc/rsbackup/hosts.d</pre>

    <p>Normally you would not edit this file.  Instead, put local
    configuration in <code>/etc/rsbackup/local</code> and a file for
    each host to back up into <code>/etc/rsbackup/hosts.d</code>.</p>

    <h2><code>/etc/rsbackup/defaults</code></h2>

    <p>There is an extra configuration file for the cron jobs,
    <code>/etc/rsbackup/defaults</code>.  The default is as
    follows:</p>

    <pre class=example>#
# Set backup=hourly|daily|weekly|monthly to control frequency of
# backup attempts. (Use backup policies for fine-grained control over
# when backups happen.)
#
backup=hourly

#
# Set report=hourly|daily|weekly|monthly to control frequency of
# email reports.  (Hourly is probably a bit much!)  Only effective
# if email is not "".
#
report=daily

#
# Set email=ADDRESS to have the report emailed to that address.
#
email=root

#
# Set prune=hourly|daily|weekly|monthly|never to control frequency of
# automated pruning of old backups
#
prune=daily

#
# Set prune_incomplete=hourly|daily|weekly|monthly|never to control
# frequency of automated pruning of incomplete backups
#
prune_incomplete=weekly

#
# Prefix to the rsbackup command
# Use 'nice' and/or 'ionice' here
#
nicely=</pre>

    <ul>

      <li>

        <p>Set <code>backup</code> to control the frequency of backup
        attempts. Normally this can be left at <code>hourly</code> and
        the frequency of each host and volume’s backups controlled via
        backup policies.</p>

      </li>

      <li>

        <p>Set <code>email</code> to the destination address for
          reports from the daily backup run, or comment out the line
          entirely to suppress email reports.  If you want reports at
          some other frequency than daily, modify
          <code>report</code>.</p>

      </li>

      <li>

        <p>Modify <code>prune</code> to control the frequency of
          pruning of old backups.  It is recommended to leave this as
          <code>daily</code>, since deleting a week or more’s worth of
          backups takes a very long time.</p>

      </li>

      <li>

        <p>Modify <code>prune_incomplete</code> to control the
          frequency of deleting incomplete backups.  It is recommended
          to keep this at a lower frequency than you take backups, as
          otherwise <code>rsync</code> will not be able to use
          incomplete backups to optimize new ones.</p>

      </li>

      <li>

        <p>Modify <code>nicely</code> to control the priority of
        <code>rsbackup</code>.  For example, you might use:</p>

        <pre>nicely="nice ionice -3"</pre>

      </li>

    </ul>

  </body>
</html>
<!--
Local variables:
mode:sgml
sgml-indent-data:t
End:
-->