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.
- 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)
-
Stop Upsource:
<upsource_home>\bin\upsource.bat stop
-
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.
- If your <upsource_home> directory name is not build-specific, rename <upsource_home> to Upsource.old (you can use another name).
- Download and unpack the zip archive with a new Upsource build.
-
Start Upsource (new instance):
<upsource_home>\bin\upsource.bat start
It will open Configuration Wizard in your default browser:
-
In this step, select the location of your previous installation or backup to upgrade from:
- 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.
-
Now you can verify and change (if necessary) your system settings and location of system directories:
-
Click Upgrade when you're done.
Wait a little for Upsource to launch its components:
As soon as it's done, it will open its welcome page.
Last modified: 21 February 2017