Upsource 2.5 Help

Upgrading your Upsource installation

Upsource uses the major.minor.patch version numbering scheme. Upgrade procedures vary significantly depending on the version increment (1.0 to 2.0 vs 1.0 to 1.0.1). Both procedures are outlined below.

Important: These instructions are only valid for upgrades to older versions, preceding 3.0. If you are upgrading to version 3.0 or newer (which is highly recommended), please read this document.

Major or minor version upgrade

Follow this instruction when upgrading to a major or minor release version, e.g. from 1.0.1 to 2.0 or from 2.0 to 2.5

  1. Create a backup while your existing Upsource installation is running.
  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. Unpack the zip archive with a new Upsource build.
  6. Copy data and conf folder from the backup directory of your old installation (the default would be Upsource.old/backup/\<date-of-backup\>) to the new <upsource_home>.
  7. Start Upsource: <upsource_home>\bin\upsource.bat start

Patch version upgrade

Follow this instruction when upgrading to a patch update, e.g. from 2.0.1 to 2.0.3 or from 2.5 to 2.5.2

  1. Stop Upsource: <upsource_home>\bin\upsource.bat stop
  2. 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 3.
    • 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 \<upsourcehome\>/internal/java/windows-amd64/bin_) and provide the thread dumps to JetBrains for investigation.
      • Kill the outstanding process trees.
  3. If your <upsource_home> directory name is not build-specific, rename <upsource_home> to Upsource.old (you can use another name).
  4. Unpack the zip archive with a new Upsource build.
  5. Copy data and conf folder from the old installation to the new one.
  6. Start Upsource: <upsource_home>\bin\upsource.bat start
Last modified: 14 September 2016