Upsource 2020.1 Help

Migrating to external Hub

External Hub lets you organize and manage users and projects of different applications from a single spot.

To switch your existing Upsource installation with a built-in Hub to use an external Hub, proceed as follows:

  1. Backup your Upsource data!
  2. Make sure your Upsource installation is version 2020.1 or newer. If not, please upgrade to the latest available build.

  3. Download and install the latest version of Hub.

  4. With Upsource and Hub running, navigate to http://your-host-name:port_for_upsource/bundle/admin/. The following page will be displayed:

    hub_token1
  5. Click Show token location to locate the file with the token.

  6. Open the file, copy the token value, paste it into the field, and click Log in:

    hub_token2

  7. Enter your external Hub URL and verify it:

    hub_url

  8. If the connection is successful, you'll be prompted to the next screen where you should log in with your administrator credentials:

    hub_migration_login

  9. On the next screen click Accept:

    hub_migration_accept

  10. The migration process starts:

    hub_migration_wait

    And in a little while you'll be redirected to a Hub's conflict resolution page, where you can view and resolve conflicts if any.

    hub_resolution
  11. Click Confirm data import and you are done!

Last modified: 02 April 2021