Upsource

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 build-in Hub to use an external Hub, proceed as follows:

  1. Backup your Upsource data!

  2. Make sure your Upsource installation is version 2.0.3 or newer. If not, please upgraded to a latest available build.

  3. Download and install 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 enter your Hub credentials and click Log in:

    hub_migration_login

  9. On the next screen, click Accept:

    hub_migration_accept

  10. You’ll be asked to enter a new token again and click Log in.

  11. On the next screen, click Open Hub:

    hub_open

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

  13. Click Confirm migration and you are done!