Upsource 3.5 Help

Upgrading your Upsource installation

Use this instruction to upgrade your existing Upsource installation to a newer one. Upgrade procedures vary significantly depending on the version increment (i.e. 3.0.1 to 3.5 vs 3.5 to 3.5.1) as outlined below.

  1. If you are upgrading to version 3.5, please Create a backup while your existing Upsource installation is running. You can omit this step for future patch updates (i.e. 3.5 to 3.5.1 or 3.5.1 to 3.5.3 and so on)
  2. Stop Upsource: <upsource_home>\bin\upsource.bat stop
  3. Use your operating system's tools to make sure that all Java processes launched by Upsource are no longer running. (On Windows, you can use Process Explorer.)
    • If there are no Upsource-related Java processes outstanding, proceed to step 4.
    • If there are Upsource-related Java processes still running:
      • (Optional, Windows only) Please consider taking thread dumps from those processes using the jstack tool (on Windows, it's available under <upsource_home>/internal/java/windows-amd64/bin) and provide the thread dumps to JetBrains for investigation.
      • Kill the outstanding process trees.
  4. If your <upsource_home> directory name is not build-specific, rename <upsource_home> to Upsource.old (you can use another name).
  5. Download and unpack the zip archive with a new Upsource build.
  6. Start Upsource (new instance): <upsource_home>\bin\upsource.bat start

    It will open Configuration Wizard in your default browser:

    upgrade_wizard1
  7. Click Upgrade.

  8. In this step, select the location of your previous installation or backup to upgrade from:

    upgrade_wizard2
    • If you are upgrading any older version to version 3.5 and have a backup (you should, see step 1), specify its location. It's a date-specific directory inside the backups folder.
    • If you are patch-upgrading version 3.5 to 3.5.x, then specify the location (the home directory) of your previous installation.
    Click Next.
  9. Now you can verify and change (if necessary) your system settings and location of system directories:

    upgrade_wizard4
  10. Click Upgrade when you're done.

    Wait a little for Upsource to launch its components:

    upsource_starting

    As soon as it's done, it will open its welcome page.

Last modified: 1 December 2016