Release Notes

Release Notes

Deprecations

All deprecations are made in such a way that your currently configured backups will still function. However, the use of deprecated options will cause your backup jobs to complete "with Warnings" until your configuration files are updated. You can check your current configuration using backup check. See the The Command Line Utility page for details.

3.5.1

• Bug fix for the Mail Notifier when using the :exim delivery method.

3.5.0

• Installing or updating Backup with gem install backup will now install all required gem dependencies. The backup dependencies command has been removed.
• Using gem cleanup will no longer silently remove Backup's gem dependencies.
• Each release of Backup now specifies exact versions of each of it's gem dependencies. Installing an updated version of a gem Backup uses will no longer affect Backup.
• Adds an option to the PostgreSQL Database to dump all databases.
• The S3 Storage may now be configured to use Server-Side Encryption.
• The S3 Storage may now be configured to use Reduced Redundancy Storage.

3.4.0

• The S3 Storage now uses Amazon's Multipart Upload for files larger than 5 MiB. All failed requests will be retried 10 times, pausing 30 seconds before each attempt. These default values may be adjusted if desired.
• The S3 Storage now includes a MD5 checksum which AWS uses to verify the integrity of the uploaded data.
• The Dropbox Storage will now retry failed requests to complete the chunked upload.

3.3.2

• Update Dropbox Storage to retry chunk upload on Timeout::Error under ruby-1.8.7.

3.3.1

• Bug fix for the Dropbox Storage when running ruby-1.8.7

3.3.0

• All Database dumps are now stored within the final backup package directly under the databases/ folder.
  This changes the structure of your final backup package. See the Databases page for details.
• Adds a database_id to all Databases, used to uniquely identify their dump files within the final backup package.
  This will be required for certain configurations. See the Databases page for details.
• Adds an oplog option to the MongoDB Database.
• Riak Database backups may now be run as a user with sudo privileges.
• Adds a use_sudo option to Archives to run the tar command using sudo.
• Adds a backup check command to the Command Line Utility.
• The Dropbox Storage now uses Dropbox's Chunked_Uploader. All failed chunks will be retried 10 times, pausing 30 seconds before each attempt. These default values may be adjusted if desired.

Deprecations

• Riak Database

  • The name and group settings are no longer used.

• All Databases

  All Databases had settings (which ended in _utility) that allowed you to configure the path to the system utilities each database used, such as mysqldump or redis-cli. If Backup can not find a utility in your $PATH using a which command, the path to the utility may be set using Utilities.

Warnings

• New database_id Requirement

  If you have more than one Database of the same type (i.e. MySQL, PostgreSQL, etc) defined on a single Backup model, setting a database_id for each instance will be required. If this is not done, Backup will auto-generate one for you and log a warning.
  Using backup check will detect this.

3.2.0

• Adds a root path option to Archives to allow creating tar archives with paths relative to the specified root, as opposed to the root of the filesystem.
• The Logger may be configured to ignore certain warnings if needed.
• backup perform will now exit with a non-zero status code if any warnings or errors occurred while performing any model/trigger. These exit codes are listed on the Performing Backups page.
• The Mail Notifier may now be configured to use a SSL/TLS connection, as opposed to using STARTTLS.
• The RSync Syncers may now be used with an rsync daemon with both Push and Pull operations. Supports direct TCP connection to a daemon, as well as using SSH transport to a single-use daemon spawned on the remote.
• The RSync Storage also supports these same rsync daemon options that have been added to the RSync Syncers.

Deprecations

• Mail Notifier

  • The enable_starttls_auto setting has been replaced with a encryption setting.

• RSync Syncers

  • The additional_options setting has been changed to additional_rsync_options.
  • The username setting has been changed to ssh_user.
  • The password setting has been changed to rsync_password.
  • The ip setting has been changed to host.

• RSync Storage

  • The local setting is no longer used. (just don't specify a host)
  • The username setting has been changed to ssh_user.
  • The password setting has been changed to rsync_password.
  • The ip setting has been changed to host.

3.1.3

• Fix backup dependencies --install so gems may be installed when Bundler is loaded, as long as no bundled environment is active.

3.1.2

• Add the excon gem as a managed dependency.

  The fog gem requires this, but places no constraints on newer versions, which leads to incompatibilities.

3.1.1

• Tightened dependency version requirements to maintain stability.

  fog-1.10.0 changed it's requirement on net-scp from ~> 1.0.4 to ~> 1.1.0.
  Also, net-scp > 1.0.4 requires net-ssh versions > 2.6.
  Although they appear to work properly, versions of net-ssh > 2.5.1
  do not officially support ruby-1.8.7 - which we still do (for the moment).

3.1.0

Changes since version 3.0.27:

• Riak Database dumps now work when a Compressor is used.
• The system user and group may now be specified for a Riak Database.
• Fix for segfaults on some systems running ruby-1.8.7.
• Cloud Syncers now dereference symbolic links when scanning local directories.
• The Hipchat Notifier now accepts a comma-delimited string of room names.
• If a Notifier configured to send an on_failure notification fails, the error that caused it to fail will now be logged.
• Backup can now be configured to log to the syslog. See Performing Backups and Logging for details.
• A --check option was added for the backup perform command. See Performing Backups for details.
• Backup's dependency management system has been updated to prevent dependencies from activating incompatible versions of other dependencies. Also, version requirements for Backup's dependencies have all been updated based on the dependency's versioning policy.
• Archives will no longer fail to complete if files being archived are changed while tar is packaging them. See Archives for details, as this behavior varies based on whether GNU or BSD tar is being used.
• An rsyncable option has been added to the Gzip Compressor.
• The paths to all system utilities that Backup uses may now be set in your config.rb. See Utilities for details.

---

This page was started with the 3.1.0 release.
To see changes between older versions, see the repository's commit log.
You may also use Github's Compare View to view changes between tagged releases:
https://github.com/meskyanichi/backup/compare/3.0.27...3.1.0

A list of all released versions is available at RubyGems.org