[BackupPC-devel] BackupPC 3.0.0 released

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 454-5900

BackupPC 3.0.0 has been released on SF.net (finally).  This
release has quite a few new features, including:

    * New configuration and host CGI editor.

    * Rsync hardlink support (needs latest File::RsyncP).

    * Decoupled BackupPC_dump from BackupPC_nightly.

    * Support for multi-level incrementals.

    * Added RSS support from Rich Duzenbury.

    * Server file names are now in utf8 and optional conversion
      to/from client name charsets can be configured.  All CGI pages
      now use the utf8 charset.

    * Per-client backups file (that summarizes each backup) can be
      recovered if corrupted.  This is done by storing each backup's
      metadata to pc/HOST/nnn/backupInfo.

    * BackupPC_sendEmail has new options for sending test emails and
      checking if BackupPC is alive (allowing a cron entry to check
      if BackupPC is alive).

    * New scripts BackupPC_fixupBackupSummary (for recovering corrupted
      backups files) and BackupPC_tarPCCopy (for copying the hardlinks
      in the PC data directory).

I'm attaching the ChangeLog which shows the cumulative changes
through each beta version since 2.1.2.

Thanks to our language translators, people who submitted code and
patches, and all the beta testers.

Enjoy!

Craig

#------------------------------------------------------------------------=

# Version 3.0.0, 28 Jan 2007
#------------------------------------------------------------------------=

* BackupPC_sendEmail now correctly sends admin email if backups
  were skipped because the disk was too full, reported by Dan
  Pritts.

* BackupPC_Admin now uses $Conf{UmaskMode}, so config.pl files
  written by the editor have more restrictive permissions.
  Reported by Tim Massey.

* Host summary now shows active backups on disabled hosts,
  from Jono Woodhouse.

* Fixed host LOG link and LOG list order, reported by Tim Massey.

* Moved Encode.pm version check to start of configure.pl so it
  produces a useful error message if Encode.pm is too old.

* Fixed hrefs to configuration documentation to handle changes
  in the way perl generates the anchors.  Reported by Philip
  Gleghorn.

* Host name links in LOG files now allow "." in the host name.
  Reported by Jean-Michel Beuken.

* Fixes to lib/BackupPC/Xfer/Tar.pm for tar 1.16: allow 1
  (ie: 256) as a successful exit status and match "Total
  bytes read" message for restores.  First reported by
  Torsten Sadowski and debugged by Ralf Gross and Holger
  Parplies.

#------------------------------------------------------------------------=

# Version 3.0.0beta3, 3 Dec 2006
#------------------------------------------------------------------------=

* Removed default paths from conf/config.pl so configure.pl will
  determine the correct ones at install time.  Avoids problem of
  the config editor complaining about bad executable paths the
  first time you use it.

* Changed first byte of compressed files with rsync checksums appended
  to 0xd7 to allow correct protocol_version >=3D 27 md4 checksums to be
  written.  Old cached checksum files have a first byte 0xd6 and are
  now considered to be uncached.  They will be automatically updated
  as needed.  This avoids the cached checksum warnings in beta2.

* BackupPC_tarPCCopy now handles all file types correctly.  Reported
  by George Avrunin.

* Fixed BackupPC_nightly to finish pending deletes before renaming
  pool chains.

* Fixes for rsync restore where hardlink is to file outside of the
  top-level restore directory.  Reported by George Avrunin, who helped
  with debugging.

* Fixes for checksum mismatch on restore for certain file sizes.
  Reported by George Avrunin and others.

* Fix for config.pl writing code to handle multi-line expressions.
  Reported by David Relson and others.

* Fix for CGI editor when deleting hash entries whose keys are
  non alphanumeric.  Report by David Relson and Aaron Ciarlotta.

* Two fixes to configure.pl from Andreas V=F6gele.

#------------------------------------------------------------------------=

# Version 3.0.0beta2, 18 Nov 2006
#------------------------------------------------------------------------=

* Fix for final md4 digest check on rsync transfers >=3D 512MB when proto=
col
  version >=3D 27 and checksums are not cached.  Reported by Garith Dugmo=
re
  and Dale Renton.

* Config Editor "Save" button is now always visible, but greyed out
  until there are changes to save.

* Config editor allows other tabs to be selected when there is an
  error, which allows you to fix an error (eg: missing binary) in
  an exiting config file.  Errors are now displayed at the top of
  the page in addition to next to the erroneous setting.

* configure.pl checks version of Encode.pm.  Reported by Chris Stone.

* Several fixes to bin/BackupPC_fixupBackupSummary from Stian Jordet.

* Fixed config.pl editor writing to solve bug with multi-line text
  strings ending in newline.  Reported and root caused by Les Stott
  and Jerry Groendyke.

* Fixed error recovery case in BackupPC::PoolWrite, reported by
  Samuel Bancal.

* Fixed table width in backup browsing to avoid Firefox layout anomoly,
  provided by Jono Woodhouse.

* CSS file updates from Jono Woodhouse.  Prior (v2) version is included
  as BackupPC_stnd_orig.css in case people prefer the old skin.

* More compact host summary, including disabled host indication,
  from Jono Woodhouse.

* New directory/file/hardlink and symlink image icons from Sean Cameron
  and Jono Woodhouse, making directory browse more compact.

* BackupPC.pid is now world readable, suggested by Casper Thomsen.

* Reordered the Server navigation bar links, suggested by David Relson.

* Fixed typos in init.d/src/gentoo-backuppc, configure.pl and config.pl
  reported by David Relson.

#------------------------------------------------------------------------=

# Version 3.0.0beta1, 30 Jul 2006
#------------------------------------------------------------------------=

* Fixed several Xfer charset conversions.

* Added some CGI utf8 conversions from Rodrigo Real and Vincent
  Fleuranceau.

* Rsync transfers now correctly handle file names with \n or \r.

* Host name is forced to lower case, to match 2.x.

* Fixed LOG file naming in BackupPC_restore and BackupPC_archive.

* GFK applied fr.pm corrections from Nicolas Stransky.

* Updated init.d/src scripts for FHS (ie: replaced __TOPDIR__/log
  with __LOGDIR__ and __TOPDIR__/conf with __CONFDIR__).  Patch
  provided by Rodrigo Real.

* Added --log-dir and --conf-dir options to configure.pl.
  Reported by Vincent Fleuranceau.

* Updated File::RsyncP version check in configure.pl, reported
  by Vincent Fleuranceau.  Changed File::RsyncP version to 0.64.

#------------------------------------------------------------------------=

# Version 3.0.0beta0, 11 Jul 2006
#------------------------------------------------------------------------=

* Added configuration and host CGI editor.

* Added rsync hardlink support.  Requires latest version of
  File::RsyncP (0.62).

* Decoupled BackupPC_dump from BackupPC_nightly by making
  asynchronous file linking/delete robust to race conditions.
  Now only BackupPC_nightly and BackupPC_link are mutually
  exclusive so only one runs at a time, and BackupPC_dump and
  BackupPC_restore can run anytime.

* Added support for multi-level incrementals.  In the style of dump(1),
  the level of each incremental can be specified.  Each incremental
  backups up everything since the most recent backup of a lower level
  (fulls are always level 0).  Previous behavior was all incrementals
  were level 1, meaning they backed up everything since the last full
  (level 0).  Default configuration is all incrementals are level 1.

* Server file names are now in utf8 and optional conversion
  to/from client name charsets can be configured.  All CGI pages
  now use the utf8 charset.

* Backup metadata is now additionally saved to pc/HOST/nnn/backupInfo,
  in addition to pc/HOST/backups.  In case pc/HOST/backups gets trashed,
  then a new script BackupPC_fixupBackupSummary can read the per-backup
  metadata from pc/HOST/nnn/backupInfo and reconstruct the backups file.
  Roberto Moreno also pointed out an early error in the CVS version.

* Added Storage module and Storage::Text which localizes all the
  text data file reading/writing (eg: backups, restores, archives
  and config.pl files).  Added read verify after all write
  operations for robustness.  Additional backends (eg: SQL)
  can be added in the future as new subclasses of the Storage
  module.

* Added Config module, and Config::Meta that contains meta data
  about configuration parameters.

* Added RSS support from Rich Duzenbury.

* Translations of new 3.0 language strings from Guillaume Filion,
  Reginaldo Ferreira, Ralph Passgang, Lieven Bridts, Guus Houtzager,
  Rodrigo Real.

* Added optional checking of exit status of Dump/Restore/Archive Pre/Post=

  UserCmd, requested by Kiko Jover, Matthias Bertschy and others.

* For new installations configure.pl tries to comply with the file
  system hierarchy standard, which means all the configuration files
  below /etc/BackupPC and log files go below /var/log/BackupPC.

* Added Slackware init.d script from Tony Nelson.

* Fixed error reporting when restore/archive fail to write the
  request file to the client directory.

* Applied patch from Marc Prewitt for DumpPreShareCmd and DumpPostShareCm=
d.

* Apply patch from Pete Wenzel to add smbClientPath =3D> $Conf{SmbClientP=
ath}
  to DumpPreUserCmd etc.

* Added Portuguese Brazillian pt_br.pm from Reginaldo Ferreira.

* Jean-Michel Beuken reported several bugs in configure.pl in CVS 3.0.0.

* Old backup email warnings now ignore partials requested by Samuel Banca=
l

* Applied patch to bin/BackupPC_sendEmail from Marc Prewitt that
  ignores any file starting with "." in the pc directory when
  it is generating warnings about old/unused files/directories.

* Applied patch from Marc Prewitt to fix host queue order.
=20
* Applied Lorenzo Cappelletti's it.pm patch.

* Applied Wander Winkelhorst's nl.pm patch.

* Applied Alberto Marconi's it.pm patch.

* Add NT_STATUS_FILE_LOCK_CONFLICT to pst read error check in
  BackupPC_sendEmail to fix bug reported by Dale Renton.

* Added fixup of $ENV{REMOTE_USER} to lib/BackupPC/CGI/Lib.pm in the
  case of using mod_authz_ldap; patch submitted by Alain Perrier.

* Added env LC_ALL=3DC to $Conf{TarClientCmd} and $Conf{TarClientRestoreC=
md}
  to avoid locale problems, suggested by Ludovic Drolez.

* Changed ping output parsing to pick out average rtt time, based
  on patch from Ron Bickers.

* Removed leading "./" and top-level "./" directory from
  zip archives generated by BackupPC_zipCreate.  Reported
  by Josh (hecktarzuli).

* BackupPC_tarCreate and BackupPC_zipCreate now allow "@"
  in share names.  Reported by Robert Waldner.

* NT_STATUS_INSUFF_SERVER_RESOURCES is now a fatal error for
  smbclient transfers, suggested by Brian Shand.

* Changed bin/BackupPC_archiveHost to use /bin/csh instead of
  /bin/sh.  That way any errors in the pipeline are reported
  via the exit status, instead of just the last.

* Added $Conf{EMailHeaders} for additional email headers, requested
  by Ludovic Gasc.  If the Content-Type charset is set to utf8 then
  the body of the email is sent in utf8 coding.

* Made shareName argument regexp checking more general to allow parens.

* Added some debian init.d instructions to init.d/README from
  Bob de Wildt.

* Documentation updates from Richard Ames, JP Vossen, Torsten Finke.