backup-utils

Bug Fixes

• On an instance with multiple nodes, backups failed silently if a node was offline or unavailable.
• On an instance with Actions enabled, incorrect backup and restore settings prevented the storage container name from being restored. This made the logs from that container inaccessible, and caused Actions to create a new storage container in a different location.

Backups and Disaster Recovery

• ghe-backup or ghe-restore commands could fail to delete progress files created by older versions of GitHub Enterprise Server Backup Utilities.
• For better compatibility across Linux distributions, the host operating system version displayed in output is obtained from /etc/os-release.

Bug Fixes

• On an instance with multiple nodes, backups failed silently if a node was offline or unavailable.

Backups and Disaster Recovery

• ghe-backup or ghe-restore commands could fail to delete progress files created by older versions of GitHub Enterprise Server Backup Utilities.

Bug Fixes

• ghe-backup-myql and ghe-restore-mysql will now exit 1 on errors.
• On an instance with Actions enabled, incorrect backup and restore settings prevented the storage container name from being restored. This made the logs from that container inaccessible, and caused Actions to create a new storage container in a different location.
• When backups are run for HA instances in both primary and replica nodes a .sync-in-progress file will be created. This will disable NetworkMaintenance jobs from running and queueing up when backups are running from the primary node.

Changes

• Estimated transfer sizes will be calculated on appropriate nodes for clustered environments.
• Added support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.
• ghe-restore avoids unnecessary rsync operations when restoring to non-clustered environments.
• ghe-backup and ghe-restore output their total runtime
• rsync compression is now disabled by default. The -z flag has been removed from the ghe-rsync command in multiple files to improve transfer speed and reduce CPU usage. To enable rsync compression globally, add GHE_RSYNC_COMPRESSION_ENABLED=yes to the backup.config file.
• Updates the Host OS version output to use /etc/os-release for better compatibility with other Linux distributions.

Backups and Disaster Recovery

• When a NFS mount is detected for snapshots on backup hosts, backup logs will show a warning to notify the user that such a setup may incur performance issues as highlighted in storage requirements documentation.

Bug Fixes

• When using GitHub Enterprise Server Backup Utilities, a host check will test the availability of all nodes before running any operations on them and output a warning if a node is unreachable. Previously if a node was unreachable the host check could silently fail.
• When using GitHub Enterprise Server Backup Utilities, user permissions assigned to the temporary progress files in /tmp have been updated to allow access by other users. Previously, having backup and restore operations performed by different users could cause failed deletion error messages for temporary files.
• On an instance with Actions enabled, incorrect backup and restore settings prevented the storage container name from being restored. This made the logs from that container inaccessible, and caused Actions to create a new storage container in a different location.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Backups and Disaster Recovery

• When a NFS mount is detected for snapshots on backup hosts, backup logs will show a warning to notify the user that such a setup may incur performance issues as highlighted in storage requirements documentation.

Bug Fixes

• On an instance with Actions enabled, incorrect backup and restore settings prevented the storage container name from being restored. This made the logs from that container inaccessible, and caused Actions to create a new storage container in a different location.

Backups and Disaster Recovery

• When a NFS mount is detected for snapshots on backup hosts, backup logs will show a warning to notify the user that such a setup may incur performance issues as highlighted in storage requirements documentation.

Bug Fixes

• On an instance with Actions enabled, incorrect backup and restore settings prevented the storage container name from being restored. This made the logs from that container inaccessible, and caused Actions to create a new storage container in a different location.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Bug fixes

• When using GitHub Enterprise Server Backup Utilities, user permissions assigned to the temporary progress files in /tmp have been updated to allow access by other users. Previously, having backup and restore operations performed by different users could cause failed deletion error messages for temporary files.

Changes

• Adds support for finding the parallel command from the moreutils tool suite on more Linux distributions, including Arch Linux and Alpine Linux.

Bug fixes

• When using GitHub Enterprise Server Backup Utilities, user permissions assigned to the temporary progress files in /tmp have been updated to allow access by other users. Previously, having backup and restore operations performed by different users could cause failed deletion error messages for temporary files.

Features

• To reduce the time to generate a backup using ghe-backup, administrators can choose to prune old backup snapshots after a new backup has been generate. For more information, see "Scheduling backups & snapshot pruning."
• On instances with large MySQL databases , administrators who wish to save storage space can use the new --incremental flag with ghe-backup and ghe-restore. For more information, see "Incremental MySQL Backups and Restores"
• Administrators can choose to skip the storage and software version checks that are run during ghe-backup using the --skip-checks flag. For more information, see "Using the backup and restore commands".

Changes

• Removed the git clone path for setting up backup-utils from the getting started instructions.
• Added bc v1.07 or newer to the requirements for a backup host machine.

Bug fixes

• Setting GHE_HOSTNAME as an environment variable did not override the value configured in backup.config.

Changes

• Administrators can disable backup or restoration of GitHub Pages data.

Changes

• Administrators can disable backup or restoration of GitHub Pages data.

Changes

• Administrators can disable backup or restoration of GitHub Pages data.

Bug fixes

• On an instance with GitHub Actions enabled, GitHub Enterprise Server Backup Utilities sometimes failed to back up GitHub Actions data despite indication that the backup was successful.
• On a standalone GitHub Enterprise Server instance with GitHub Actions enabled, backups failed.
• For administrators who need to correlate and troubleshoot errors, ghe-backup and ghe-restore include timestamps with logging information.
• Fixes a known issue that caused users to potentially not be able to sign into the instance after restoration of a backup created using GitHub Enterprise Server Backup Utilities 3.9.0. For more information on this known issue, see "Known issues with backups for your instance."

Bug fixes

• On an instance with GitHub Actions enabled, GitHub Enterprise Server Backup Utilities sometimes failed to back up GitHub Actions data despite indication that the backup was successful.
• On a standalone GitHub Enterprise Server instance with GitHub Actions enabled, backups failed.
• For administrators who need to correlate and troubleshoot errors, ghe-backup and ghe-restore include timestamps with logging information.
• Fixes a known issue that caused users to potentially not be able to sign into the instance after restoration of a backup created using GitHub Enterprise Server Backup Utilities 3.8.0. For more information on this known issue, see "Known issues with backups for your instance."

Bug fixes

• On an instance with GitHub Actions enabled, GitHub Enterprise Server Backup Utilities sometimes failed to back up GitHub Actions data despite indication that the backup was successful.
• Fixes a known issue that caused users to potentially not be able to sign into the instance after restoration of a backup created using GitHub Enterprise Server Backup Utilities 3.7.0. For more information on this known issue, see "Known issues with backups for your instance."