Hub 2017.1 Help

Restore Database from Backup

Before you begin, make sure you have a backup copy of the database that you want to restore. Download a backup file (tar.gz|zip) from Hub on the Administration > Backup page or locate an archived backup file in the directory that is set as the Backup location.

Note the location of the backup copy. To restore your database, you need to re-install Hub and use the backup as the Upgrade Source during installation.

ZIP Installation

If you installed Hub from a ZIP distribution, use the following procedure.

To restore your database from a backup:

  1. Stop the Hub server.
  2. Download and install a Hub 2.5 build that is the same version or later than the version of your database.
  3. In the Configuration Wizard, select the Upgrade option.
  4. On the Select Upgrade Source page, select your backup as the Upgrade Source and click the Next button.
  5. Confirm or change the locations where Hub stores product data. When done, click the Next button.
    • Hub starts with the data from the backup file.

MSI Installation

If you run Hub as a Windows service installed from the MSI distribution, use the following procedure.

To restore your database from a backup:

  1. Uninstall Hub 2.5 from the Windows Control Panel.
  2. Make sure that the Hub service user (JetBrainsHub, by default) has full access to the directory where you saved the database backup file.
  3. Install a Hub 2.5 build that is the same version or later than the version of your database. Please note:
    • To troubleshoot errors more effectively, run the MSI installer with verbose logging enabled. In a Command Prompt window, enter the following command:
      msiexec /i hub-2.5.xxxxx.msi /l*v install.txt
    • Configuration files from previous installations might be found during the installation. In this case, use the (Recommended) installation option that is selected by default.
  4. In the Configuration Wizard, select the Upgrade option.
  5. On the Select Upgrade Source page, select your backup as the Upgrade Source and click the Next button.
  6. Confirm or change the locations where Hub stores product data. When done, click the Next button.
    • Hub starts with the data from the backup file.
Last modified: 6 April 2017