Upsource 2017.2 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 2017.2 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 click Accept:
    hub_migration_accept
  9. 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
  10. Click Confirm data import and you are done!
Last modified: 1 December 2017

See Also