Upgrade Guide

Upgrading the Server

Upgrading Concourse Server is very easy. In fact, the process is similar to installing the server for the first time. Just download the latest concourse-server package into the root of your concourse-server directory and run it. The package will automatically upgrade CaSH, server dependencies, preferences, etc.

Checkout this demo to see a server upgrade in action.

Stop the Server

$ cd /path/to/concourse-server
$ sh bin/stop

Download the latest concourse-server package into the root of the concourse-server directory

$ curl -O -L -J http://cinchapi.org/concourse/download
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
100   358  100   358    0     0    571      0 --:--:-- --:--:-- --:--:-- 10529
100 12.8M  100 12.8M    0     0  3049k      0  0:00:04  0:00:04 --:--:-- 4639k
curl: Saved to filename 'concourse-server-0.3.1.1248.bin'

Rub the new concourse-server upgrade package

$ sh concourse-server-0.3.3.1330.bin
Creating directory concourse-server
Verifying archive integrity... All good.
Uncompressing Concourse Server......................................................................
Upgrading Concourse Server..........................................................................

Start the server

$ sh bin/start

Upgrading the Client

Upgrading your project to use the latest release of the Concourse API is very easy.

Gradle/Maven/Ivy/etc

  1. Update your build script to pull in the latest client jar from Maven Central.
  2. Recompile and rebuild your project.

Manual

  1. Download the latest client jar from Maven Central.
  2. Remove the old client jar from your project's classpath.
  3. Add the new client jar to your project's classpath
  4. Recompile and rebuild your project.