backup-utils

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. https://github.com/github/backup-utils/pull/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)

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.

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.

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).

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.

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