Relution Signet Customer Hub

Update - Relution

Follow these steps to upgrade the Relution installation.

Docker installation

Edit the docker-compose.yml file and replace
image: relution/relution:xxx with image: relution/relution:latest.

Updating Relution is then very easy:

cd /opt/relution/
docker compose pull
docker compose up --detach

In newer Docker versions, the spelling has changed to docker compose without a hyphen.

Make sure to compare docker_relution with the name of the Relution container container_name specified in the docker-compose.yml if it is different from the default.

This command will download the latest version of the Docker image and install it. The Relution service will be unavailable for a few minutes while the container is restarting.

The following command can be used to delete old containers and caches, which can free up a lot of memory.

docker system prune -a

WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all images without at least one container associated to them
  - all build cache

Are you sure you want to continue? [y/N]

Verify Image Integrity

Before applying a Docker update, verify the image digest:

  1. Obtain the SHA-256 digest for the new release from the Relution release manifest.

  2. Pull the new image and verify its digest:

    docker pull relution/relution:<new-version>
docker inspect --format='{{index .RepoDigests 0}}' relution/relution:<new-version>

  3. Compare the digest to the published manifest. Do not proceed if they differ.

  4. After verifying, update the image reference in the deployment manifest to pin the verified digest.

Native installation Linux

  1. download the latest relution package: Latest Relution Package →

  2. stop the Relution service

  3. Backup the Relution database

  4. backup the installation directory

    mv <INSTALL_DIR> <INSTALL_DIR>.bak

  5. extract the zip package to <INSTALL_DIR>

  6. set the owner of the <INSTALL_DIR> directory, for example:

    sudo chown -R relution:relution /opt/relution

  7. copy <INSTALL_DIR>.bak/application.yml to <INSTALL_DIR>/application.yml

  8. start the Relution service

  9. wait until the Relution service is started

The database will be updated to the latest version. Updating the database may take some time

Native Installation Windows

  1. download the latest Relution package: Latest Relution Package →

  2. stop the Relution service services.msc

  3. save the existing installation directory to relution_bak_

  4. extract the zip package to the old installation directory <INSTALL_DIR>

  5. copy the configuration file from the backup relution_bak_/application.yml to <INSTALL_DIR>/application.yml

  6. start the Relution service

  7. wait until the Relution service has started. in the directory <INSTALL_DIR>/log/relution.txt the log can be viewed

    The database is being updated to the latest version. Updating the database may take some time.

Known error messages

Receiving the following message when starting the Relution service can indicate that the Java version used is too low.

The service "Relution" on "Local Computer" could not be started
The service did not return an error.
It may be an internal Windows error or an internal service error.
Please contact your system administrator if the problem persists.

To fix this, please download and install the latest Java 17 LTS from the following link: Adoptium Java →
During installation, activate the option Set Home PATH; otherwise, the Home PATH must be entered manually in the Windows variables afterwards.
After installation, restart the Relution service.

Checklist after the update.

  • Do relution apps on mobile devices also need an update?
  • Do custom CSS files need an update?
  • Are enrolled devices still accessible?
    • Send an update device information action to a device
  • Is enrollment still working for the different platforms?

Note: Update from Relution 5.3x.x to 26.2.x

When updating from Relution 5.3x.x to Relution 26.2.x, it is mandatory to first upgrade to the intermediate version Relution 26.0.3.

Docker

For Docker installations, the version can be specified directly in the compose.yml.

  1. First, update to the latest released 5.x version:

    relution:
  image: relution/relution:5.35.4

  2. Then, update to the latest released 26.0.x version:

    relution:
  image: relution/relution:26.0.3

  3. After a successful update, the version can be set back to latest to automatically use the most recent available version:

    relution:
  image: relution/relution:latest

Linux and Windows (native)

For native installations on Linux and Windows, the process is the same as with Docker:

  1. Update to Relution 5.35.4
  2. Update to Relution 26.0.3
  3. Update to the latest version (latest)

Downloads: