/[BackupPC]/trunk/doc/BackupPC.pod

This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!

Diff of /trunk/doc/BackupPC.pod

Parent Directory | Revision Log | View Patch Patch

-revision 2 by dpavlin,
Wed Jun 22 19:12:42 2005 UTC
+revision 316 by dpavlin,
Mon Jan 30 13:37:17 2006 UTC
 Line 1
  =head1 BackupPC Introduction
- This documentation describes BackupPC version 2.1.0,
+ This documentation describes BackupPC version 2.1.2,
- released on 20 Jun 2004.
+ released on 5 Sep 2005.
  =head2 Overview
 Line 269 
 BackupPC server data to tape.
  Various programs and scripts use rsync to provide hardlinked backups.
  See, for example, Mike Rubel's site (L<http://www.mikerubel.org/computers/rsync_snapshots>),
- JW Schultz's dirvish (L<http://www.pegasys.ws/dirvish> (although as of
+ JW Schultz's dirvish (L<http://www.dirvish.org>),
- June 2004 this link doesn't work)),
  Ben Escoto's rdiff-backup (L<http://rdiff-backup.stanford.edu>),
  and John Bowman's rlbackup (L<http://www.math.ualberta.ca/imaging/rlbackup>).
-Line 300 
 appreciated, both positive and negative.
+Line 299 
 appreciated, both positive and negative.
  Beyond being a satisfied user and telling other people about it, everyone
  is encouraged to add links to L<http://backuppc.sourceforge.net>
- (I'll see then via Google) or otherwise publicize BackupPC.  Unlike
+ (I'll see them via Google) or otherwise publicize BackupPC.  Unlike
  the commercial products in this space, I have a zero budget (in both
  time and money) for marketing, PR and advertising, so it's up to
  all of you!  Feel free to vote for BackupPC at
-Line 516 
 then run these commands:
+Line 515 
 then run these commands:
  The same sequence of commands can be used for each module.
  Now let's move onto BackupPC itself.  After fetching
- BackupPC-2.1.0.tar.gz, run these commands as root:
+ BackupPC-2.1.2.tar.gz, run these commands as root:
-     tar zxf BackupPC-2.1.0.tar.gz
+     tar zxf BackupPC-2.1.2.tar.gz
-     cd BackupPC-2.1.0
+     cd BackupPC-2.1.2
      perl configure.pl
  In the future this release might also have patches available on the
  SourceForge site.  These patch files are text files, with a name of
  the form
-     BackupPC-2.1.0plN.diff
+     BackupPC-2.1.2plN.diff
  where N is the patch level, eg: pl5 is patch-level 5.  These
  patch files are cumulative: you only need apply the last patch
  file, not all the earlier patch files.  If a patch file is
- available, eg: BackupPC-2.1.0pl5.diff, you should apply
+ available, eg: BackupPC-2.1.2pl5.diff, you should apply
  the patch after extracting the tar file:
-      # fetch BackupPC-2.1.0.tar.gz
+      # fetch BackupPC-2.1.2.tar.gz
-      # fetch BackupPC-2.1.0pl5.diff
+      # fetch BackupPC-2.1.2pl5.diff
-      tar zxf BackupPC-2.1.0.tar.gz
+      tar zxf BackupPC-2.1.2.tar.gz
-      cd BackupPC-2.1.0
+      cd BackupPC-2.1.2
-      patch -p0 < ../BackupPC-2.1.0pl5.diff
+      patch -p0 < ../BackupPC-2.1.2pl5.diff
       perl configure.pl
  A patch file includes comments that describe that bug fixes
-Line 600 
 directory.
+Line 599 
 directory.
  =head2 Step 3: Setting up config.pl
  After running configure.pl, browse through the config file,
- __INSTALLDIR__/conf/config.pl, and make sure all the default settings
+ __TOPDIR__/conf/config.pl, and make sure all the default settings
  are correct. In particular, you will need to decide whether to use
  smb, tar or rsync transport (or whether to set it on a per-PC basis)
  and set the relevant parameters for that transport method.
-Line 926 
 of SSH you have by typing "ssh" or "man
+Line 925 
 of SSH you have by typing "ssh" or "man
  =item Mac OS X
  In general this should be similar to Linux/Unix machines.
- Mark Stosberg reports that you can also use hfstar.
+ Many users have reported success using xtar, which also
+ backs up the Mac OS X resource forks.
+ Other choices include rsync and Mark Stosberg reports that you
+ can also use hfstar.
  See L<http://fink.sourceforge.net/pdb/package.php/hfstar>.
  =item SSH Setup
-Line 1543 
 status files to keep.
+Line 1546 
 status files to keep.
  Note that for direct restore to work, the $Conf{XferMethod} must
  be able to write to the client.  For example, that means an SMB
  share for smbclient needs to be writable, and the rsyncd module
- needs "read only" set to "yes".  This creates additional security
+ needs "read only" set to "false".  This creates additional security
  risks.  If you only create read-only SMB shares (which is a good
  idea), then the direct restore will fail.  You can disable the
  direct restore option by setting $Conf{SmbClientRestoreCmd},
-Line 1984 
 is only run when there are no BackupPC_d
+Line 1987 
 is only run when there are no BackupPC_d
  running.  Therefore, when it is time to run BackupPC_nightly, no new
  backups are started and BackupPC waits until all backups have finished.
  Then BackupPC_nightly is run, and until it finishes no new backups are
- started.  If BackupPC_nightly is slow, the settings
+ started.  If BackupPC_nightly takes too long to run, the settings
+ $Conf{MaxBackupPCNightlyJobs} and $Conf{BackupPCNightlyPeriod} can
+ be used to run several BackupPC_nightly processes in parallel, and
+ to split its job over several nights.
  =back
-Line 3377 
 The valid values are:
+Line 3383 
 The valid values are:
    - 'rsync':   backup and restore via rsync (via rsh or ssh).
                 Best choice for linux/unix.  Good choice also for WinXX.
-   - 'rsyncd':  backup and restre via rsync daemon on the client.
+   - 'rsyncd':  backup and restore via rsync daemon on the client.
                 Best choice for linux/unix if you have rsyncd running on
                 the client.  Good choice also for WinXX.
-Line 3861 
 local LAN round-trip times should be muc
+Line 3867 
 local LAN round-trip times should be muc
  WAN or dialup connections the round-trip time will be typically more
  than 20msec.  Tune if necessary.
- =item $Conf{ClientTimeout} = 7200;
+ =item $Conf{ClientTimeout} = 72000;
  Timeout in seconds when listening for the transport program's
  (smbclient, tar etc) stdout. If no output is received during this
-Line 4049 
 need to change the message, copy it here
+Line 4055 
 need to change the message, copy it here
    To: $user$domain
    cc:
    Subject: $subj
+   $headers
    Dear $userName,
    This is a site-specific email message.
-Line 4076 
 need to change the message, copy it here
+Line 4082 
 need to change the message, copy it here
    To: $user$domain
    cc:
    Subject: $subj
+   $headers
    Dear $userName,
    This is a site-specific email message.
-Line 4103 
 need to change the message, copy it here
+Line 4109 
 need to change the message, copy it here
    To: $user$domain
    cc:
    Subject: $subj
+   $headers
    Dear $userName,
    This is a site-specific email message.
-Line 4276 
 See L<http://backuppc.sourceforge.net>.
+Line 4282 
 See L<http://backuppc.sourceforge.net>.
  =head1 Copyright
- Copyright (C) 2001-2004 Craig Barratt
+ Copyright (C) 2001-2005 Craig Barratt
  =head1 Credits

 Legend:



Removed from v.2
 


changed lines


 
Added in v.316
 Legend:



Removed from v.2
 


changed lines


 
Added in v.316
-Removed from v.2
+Added in v.316

	ViewVC Help
Powered by ViewVC 1.1.26