GitHub Enterprise Backup Utilities v2.4.0

Includes general improvements, bug fixes, and support for GitHub Enterprise v2.4. This upgrade is recommended for all currently supported GitHub Enterprise versions.

• Moves the in-progress detection to a separate file with PID which is removed if the process is no longer running after the backup. #145, #99
• Updates the README to explain why backup-utils is useful even if you have the high availability replica running. #140
• Changes the use of the --link-dest option to only occur when backing up populated directories. #138
• Adds logging to /var/log/syslog on the remote GitHub Enterprise appliance to both ghe-backup and ghe-restore. #131
• Restarts memcached after restoring to an already configured appliance to ensure it doesn't contain out-of-sync information. #130
• Removes the temporary /data/user/repositories-nw-backup directory that remains after successfully migrating the repository storage layout to the new format used on GitHub Enterprise 2.2.0 and later after restoring a backup from an older release of GitHub Enterprise. #129
• Add devscripts to Debian's build-depends for checkbashisms. #101
• Documents the -c option which forces the restoration of the configuration information to an already configured appliance. #96

GitHub Enterprise Backup Utilities v2.2.0

Includes general improvements, bug fixes, and support for GitHub Enterprise v2.2. This upgrade is recommended for all currently supported GitHub Enterprise versions and is required to backup/restore GitHub Enterprise v2.2 (or greater) instances.

• Adds support for the new repositories filesystem layout include in GitHub Enterprise v2.2. #122, #124
• ghe-restore now performs a config run on the instance after an incremental restore to 11.10.x and 2.x instances. #100
• ghe-restore now fails fast when run against a GHE instance with replication enabled. Replication should be disabled during a restore and then setup after the restore completes. #121
• Fixes an issue with special port 122 detection failing when port is overridden in an ssh config file. #102
• Removes a warning message when running ghe-backup against an instance with GitHub Pages disabled. #117
• backup-utils release version numbers now track GitHub Enterprise releases to ease the process of determining which version of backup-utils is required for a given GitHub Enterprise version.

GitHub Enterprise Backup Utilities v2.0.2

This is a minor update that includes general improvements, bug fixes, and features that take advantage of new functionality available in GitHub Enterprise v2.1. This release is compatible with all currently supported GitHub Enterprise versions.

• ghe-restore now requires that an already-configured appliance be put into maintenance mode manually. This is a safeguard against accidentally overwriting data on the wrong instance. #62, #84
• ghe-backup and ghe-restore now run a ghe-negotiate-version program on the appliance to determine whether the backup-utils and GHE versions are compatible. #91
• Various portability fixes for problems surfaced when running on Solaris and FreeBSD. #86, #87
• Fixes an issue in ghe-backup where mysqldump failures weren't being reported properly. #90
• Automated builds are now run on Travis CI. #77

Package MD5 checksums:

bcf1b5fdb31c09e2fa14b2317bc474c1  dist/github-backup-utils-v2.0.2.tar.gz
b8f5df864f5813e621c8834f42c00934  dist/github-backup-utils_2.0.2_amd64.deb

GitHub Enterprise Backup Utilities v2.0.1

This is a minor update to the github/backup-utils v2.0 release that includes improvements, bug fixes, and documentation updates.

• Experimental deb packages available via releases page (s/o @xeago)
• Adds /etc/github-backup-utils/backup.config as a default config file search location for deb / system installs (s/o @xeago).
• Enables SSH BatchMode for all remote command invocation except initial host check / version identification. #78 (s/o @walkeran)
• Fixes a bug in ghe-backup where Git GC process detection would misclassify long-running server processes matching /git.*gc/, causing the backup operation to timeout.
• Adds a note and link to the Migrating from GitHub Enterprise v11.10.34x to v2.0 documentation in the README.
• Adds example / documentation for the GHE_EXTRA_SSH_OPTS config value to the backup.config-example file. #80 (s/o @veloandy)

GitHub Enterprise Backup Utilities v2.0

This release includes improvements, bug fixes, documentation updates, and support for the latest GitHub Enterprise release.

• Support for GitHub Enterprise 2.0.
• Support for migrating from GitHub Enterprise 11.10.34x to 2.0 (including from VMware to AWS).
• ghe-backup retains hardlinks present on VM in backup snapshots, saving space. (s/o @kjedruczyk)
• ghe-restore retains hardlinks present in backup snapshot when restoring to VM, saving space. (s/o @kjedruczyk)
• backup-utils now includes debian packaging support. debs will be published in the next minor release. (s/o @xeago)
• Fixes an issue with ghe-restore -s not using the snapshot specified (s/o @xeago)
• Fixes an issue with ghe-backup not waiting for nw-repack processes to finish in some instances.

GitHub Enterprise Backup Utilities v1.1

This release includes general improvements and documentation updates.

• Updated documentation on minimum GitHub Enterprise version requirements for online and incremental backups from v11.10.341 to at least v11.10.342.
• The ghe-restore command now prompts for confirmation of the host to restore to before performing any destructive operation. This is to reduce the chances of restoring to the wrong host. The prompt may be bypassed in automated scenarios by providing the --force option.
• Added a -c option to ghe-restore for restoring base appliance settings in addition to primary datastores. See ghe-restore --help for more information.
• Added a note about disabling maintenance mode on the appliance after a successful ghe-restore operation.
• Added support for filesystem layout changes and upgraded server components in future versions of GitHub Enterprise.

v1.0.1 Release

This release includes bug fixes for the v1.0 release.

• Fixes Elasticsearch backups being marked as failed erroneously when files vanish during the first transfer stage (#51).
• Fixes a failure during restore from backups taken against an appliance with Pages disabled (#50).

v1.0 Release

Initial public release of GitHub Enterprise Backup Utilities.

• Complete GitHub Enterprise backup and recovery system.
• Online backups. The GitHub appliance need not be put in maintenance mode.
• Incremental backup of Git repository data.
• Efficient snapshot storage.
• Multiple backup snapshots with configurable retention periods.
• Backup commands run under the lowest CPU/IO priority on the GitHub appliance.
• Runs under most Linux/Unix environments.
• MIT licensed, open source software maintained by GitHub, Inc.

Internal pre-release

This is an internal pre-release for testing the release process and packaging machinery.