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.