~ubuntu-branches/ubuntu/saucy/cedar-backup2/saucy-proposed

« back to all changes in this revision

Viewing changes to doc/manual/ch05s03.html

  • Committer: Package Import Robot
  • Author(s): Kenneth J. Pronovici
  • Date: 2013-03-21 15:02:25 UTC
  • mfrom: (1.2.11)
  • Revision ID: package-import@ubuntu.com-20130321150225-fca4k16gmec1rksg
Tags: 2.21.1-1
* New upstream release.
  - Tweak debian/copyright based on new upstream CREDITS

Show diffs side-by-side

added added

removed removed

Lines of Context:
20
20
            directory), you can do that.  You'll just have to modify the
21
21
            procedure below based on information in the remainder of the
22
22
            manual.
23
 
         </p></div><div class="sect2" title="Step 1: Decide when you will run your backup."><div class="titlepage"><div><div><h3 class="title"><a name="id341020"></a>Step 1: Decide when you will run your backup.</h3></div></div></div><p>
 
23
         </p></div><div class="sect2" title="Step 1: Decide when you will run your backup."><div class="titlepage"><div><div><h3 class="title"><a name="idp6009856"></a>Step 1: Decide when you will run your backup.</h3></div></div></div><p>
24
24
            There are four parts to a Cedar Backup run: collect, stage, store
25
25
            and purge. The usual way of setting off these steps is through a
26
26
            set of cron jobs.  Although you won't create your cron jobs just
42
42
               Backup on the first day of the week, your backups will likely be
43
43
               <span class="quote">&#8220;<span class="quote">confused</span>&#8221;</span> until the next week begins, or until you
44
44
               re-run the backup using the <code class="option">--full</code> flag.
45
 
            </p></div></div><div class="sect2" title="Step 2: Make sure email works."><div class="titlepage"><div><div><h3 class="title"><a name="id341064"></a>Step 2: Make sure email works.</h3></div></div></div><p>
 
45
            </p></div></div><div class="sect2" title="Step 2: Make sure email works."><div class="titlepage"><div><div><h3 class="title"><a name="idp6015088"></a>Step 2: Make sure email works.</h3></div></div></div><p>
46
46
            Cedar Backup relies on email for problem notification.  This
47
47
            notification works through the magic of cron.  Cron will email any
48
48
            output from each job it executes to the user associated with the
57
57
            that you may prefer to configure root's email to forward to some
58
58
            other user, so you do not need to check the root user's mail in
59
59
            order to see Cedar Backup errors.
60
 
         </p></div><div class="sect2" title="Step 3: Configure your writer device."><div class="titlepage"><div><div><h3 class="title"><a name="id336106"></a>Step 3: Configure your writer device.</h3></div></div></div><p>
 
60
         </p></div><div class="sect2" title="Step 3: Configure your writer device."><div class="titlepage"><div><div><h3 class="title"><a name="idp5420384"></a>Step 3: Configure your writer device.</h3></div></div></div><p>
61
61
            Before using Cedar Backup, your writer device must be properly
62
62
            configured.  If you have configured your CD/DVD writer hardware to
63
63
            work through the normal filesystem device path, then you just need
83
83
                Due to the underlying utilities that Cedar Backup uses, the
84
84
                SCSI id may only be used for CD writers,
85
85
                <span class="emphasis"><em>not</em></span> DVD writers.
86
 
            </p></div></div><div class="sect2" title="Step 4: Configure your backup user."><div class="titlepage"><div><div><h3 class="title"><a name="id341227"></a>Step 4: Configure your backup user.</h3></div></div></div><p>
 
86
            </p></div></div><div class="sect2" title="Step 4: Configure your backup user."><div class="titlepage"><div><div><h3 class="title"><a name="idp6034656"></a>Step 4: Configure your backup user.</h3></div></div></div><p>
87
87
             Choose a user to be used for backups. Some platforms may
88
88
             come with a <span class="quote">&#8220;<span class="quote">ready made</span>&#8221;</span> backup user. For other
89
89
             platforms, you may have to create a user yourself. You may
95
95
               Standard Debian systems come with a user named
96
96
               <code class="literal">backup</code>.  You may choose to stay with this
97
97
               user or create another one.
98
 
            </p></div></div><div class="sect2" title="Step 5: Create your backup tree."><div class="titlepage"><div><div><h3 class="title"><a name="id341270"></a>Step 5: Create your backup tree.</h3></div></div></div><p>
 
98
            </p></div></div><div class="sect2" title="Step 5: Create your backup tree."><div class="titlepage"><div><div><h3 class="title"><a name="idp6039824"></a>Step 5: Create your backup tree.</h3></div></div></div><p>
99
99
            Cedar Backup requires a backup directory tree on disk. This
100
100
            directory tree must be roughly three times as big as the amount of
101
101
            data that will be backed up on a nightly basis, to allow for the
132
132
               directory structure within some existing Debian directory such
133
133
               as <code class="filename">/var/backups</code> or
134
134
               <code class="filename">/var/tmp</code>.
135
 
            </p></div></div><div class="sect2" title="Step 6: Create the Cedar Backup configuration file."><div class="titlepage"><div><div><h3 class="title"><a name="id341349"></a>Step 6: Create the Cedar Backup configuration file.</h3></div></div></div><p>
 
135
            </p></div></div><div class="sect2" title="Step 6: Create the Cedar Backup configuration file."><div class="titlepage"><div><div><h3 class="title"><a name="idp6049344"></a>Step 6: Create the Cedar Backup configuration file.</h3></div></div></div><p>
136
136
            Following the instructions in <a class="xref" href="ch05s02.html" title="Configuration File Format">the section called &#8220;Configuration File Format&#8221;</a> (above) create a configuration
137
137
            file for your machine.  Since you are working with a pool of one,
138
138
            you must configure all four action-specific sections: collect,
153
153
               configure any extensions that require passwords or other similar
154
154
               information, you should make the file readable only to root or
155
155
               to the file owner (if the owner is not root).
156
 
            </p></div></div><div class="sect2" title="Step 7: Validate the Cedar Backup configuration file."><div class="titlepage"><div><div><h3 class="title"><a name="id341402"></a>Step 7: Validate the Cedar Backup configuration file.</h3></div></div></div><p>
 
156
            </p></div></div><div class="sect2" title="Step 7: Validate the Cedar Backup configuration file."><div class="titlepage"><div><div><h3 class="title"><a name="idp6055696"></a>Step 7: Validate the Cedar Backup configuration file.</h3></div></div></div><p>
157
157
            Use the command <span class="command"><strong>cback validate</strong></span> to validate your
158
158
            configuration file. This command checks that the configuration file
159
159
            can be found and parsed, and also checks for typical configuration
162
162
            Note: the most common cause of configuration problems is in not
163
163
            closing XML tags properly. Any XML tag that is
164
164
            <span class="quote">&#8220;<span class="quote">opened</span>&#8221;</span> must be <span class="quote">&#8220;<span class="quote">closed</span>&#8221;</span> appropriately.
165
 
         </p></div><div class="sect2" title="Step 8: Test your backup."><div class="titlepage"><div><div><h3 class="title"><a name="id341433"></a>Step 8: Test your backup.</h3></div></div></div><p>
 
165
         </p></div><div class="sect2" title="Step 8: Test your backup."><div class="titlepage"><div><div><h3 class="title"><a name="idp6059376"></a>Step 8: Test your backup.</h3></div></div></div><p>
166
166
            Place a valid CD/DVD disc in your drive, and then use the
167
167
            command <span class="command"><strong>cback --full all</strong></span>.  You should execute
168
168
            this command as root.  If the command completes with no output,
178
178
            <sup>[<a name="cedar-config-foot-bugs" href="#ftn.cedar-config-foot-bugs" class="footnote">25</a>]</sup>
179
179
            To be safe, always enable the consistency check option in the
180
180
            store configuration section.</em></span>
181
 
         </p></div><div class="sect2" title="Step 9: Modify the backup cron jobs."><div class="titlepage"><div><div><h3 class="title"><a name="id341489"></a>Step 9: Modify the backup cron jobs.</h3></div></div></div><p>
 
181
         </p></div><div class="sect2" title="Step 9: Modify the backup cron jobs."><div class="titlepage"><div><div><h3 class="title"><a name="idp6066048"></a>Step 9: Modify the backup cron jobs.</h3></div></div></div><p>
182
182
            Since Cedar Backup should be run as root, one way to configure the
183
183
            cron job is to add a line like this to your
184
184
            <code class="filename">/etc/crontab</code> file: