Upsource Web Help

Upgrading your Upsource installation

Here’s how you proceed when you get a chance to use a newer build of JetBrains Upsource:

Note: All commands listed below are Windows commands. If you’re working on a Linux or Mac OS X server, simply replace .bat with .sh.

  1. Run your existing Upsource installation and create a backup.

  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:
      1. (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.
      2. Kill the outstanding process trees.
  4. If your <upsource_home> directory name is not build-specific, rename <upsource_home> to Upsource.old.

  5. Unpack the zip archive with a new Upsource build. Note: the unzipped installation should not be placed inside an old <upsource_home> directory that contains old files.

  6. Copy data and conf folder from the backup directory of Upsource.old (old installation) to <upsource_home> (new installation).

    Note: data and conf folders contain hidden files. Use recursive copying cp -r in Linux to avoid data loss. Before copying data and conf folders to the new installation, the existing data and conf folder in that installation should be deleted to prevent data corruption.

  7. Start Upsource: <upsource_home>\bin\upsource.bat start