Upgrade from ZIP to Docker

1. Back up your data

Create a backup while your existing Upsource installation is running.

2. Stop Upsource

1. Stop Upsource: <upsource_home>\bin\upsource.sh 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 the next step.
   • 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.

3. Pull Upsource image

Pull an image of the latest Upsource version from the Docker Hub Repository:

docker pull jetbrains/upsource:<version> Where <version> is a full version number of an Upsource build.

4. Prepare folders

• Create empty directories on the host machine to store Upsource data, configuration, log, and backup files:

  mkdir -p -m 750 <path to data directory> <path to logs directory> <path to conf directory> <path to backups directory>

  These directories will be passed to the Upsource container as volumes.

  It's recommended that you name the folders correspondingly:

  • data
  • config
  • logs
  • backups

• (Linux or Mac OS only) The Upsource service runs inside the Docker container under a non-root account 13001:13001 (group:id). Give that account read/write permissions to access the directories you've created:

  chown -R 13001:13001 <path to data directory> <path to logs directory> <path to conf directory> <path to backups directory>
• Locate the last backup you created in Step 1 (it'a date-specific directory inside the backups folder) and copy it from the old installation to the empty backups folder you've just created for your new installation.

5. Run new Upsource installation

Use the following command to run a container with Upsource server and map Upsource data volumes and port:

Where:

<upsource-server-instance> is a name you give to the container.

-v <path to data directory>:/opt/upsource/data maps the data directory in the container to the data directory you've created on the host machine. The same mapping is set for the other directories: conf, logs, backups.

-p <port on host>:8080 this port mapping instructs your host machine to listen on <port on host> and propagate all traffic to port 8080 inside the Docker container.

Windows only: add -u root after -p <port on host>:8080 \.

jetbrains/upsource:<version> points to the correct image with the Upsource build.

Upsource service is started on {0.0.0.0:8080} inside the Docker container, and port 8080 is mapped to <port on host> you've specified. This way the service may be accessed from any machine that has network access to <port on host> of your host machine. For instance, if FQDN of the host machine is host.mydomain.com and the <port on host> is 7777, then the service will be available at http://host.mydomain.com:7777

6. Follow the wizard

On the first run, Upsource service will start with Configuration Wizard at the address mentioned above.

1. On the first page of Configuration Wizard click Upgrade:

   

2. Select the location of the last backup of your old installation (a date-specific directory inside the backups folder):

   

   Click Next.

3. Now you can verify your system settings and location of system directories:

   

4. 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.

7. Manage your Upsource instance