Skip to main content

Upgrade XL Release active-active cluster setup with docker compose

Steps

Follow these steps to Upgrade XL Release active-active cluster setup:

  1. Make sure to read our docs for upgrade and release notes for each version you want to upgrade to.

  2. Stop the current running instances of the docker containers which have the old version that need to be upgraded. You do not need to stop the load balancer, mq and database containers. See the example below:

     # Shutdown deployments
    docker-compose -f docker-compose-xlr-ha.yaml stop xl-release-master
  3. Update the docker-compose-xlr-ha.yaml file as shown

  • Update the image with new tag which represent version you want to upgrade to for both master and worker, for example,
     xl-release-master:
    image: xebialabs/xl-release:9.5.2
  • Specify your DB connection details to point to the old DB, for example using environment variables such as XL_DB_URL
  • Include all volumes already being used with old docker images. In case of "conf" volume, make sure also to update any configurations required by the new version "check release notes", before mounting it to new version of the container.
  • Update the environment variables to include FORCE_UPGRADE see below,
     environment:
    - FORCE_UPGRADE=true
  1. You can use the provided run.sh to bring up the setup or do it manually by following the steps shown below. Update the passwords to represent Passwords used in previous version.
# Set passwords
export XLR_ADMIN_PASS=admin
export POSTGRES_PASS=admin

# upgrade master nodes,
docker-compose -f docker-compose-xlr-ha.yaml up --scale xl-release-master=2 -d

# Print out the status
docker-compose -f docker-compose-xlr-ha.yaml ps
  1. You can view the logs of individual containers using the docker logs <container_name> -f command.
  2. You can access the XL Release UI at http://localhost:8081