Skip to main content
Skip table of contents

Upgrade with Docker setup

Verify system requirements

This guide provides instructions to upgrade LUY from release 7.3 to release 7.4. Please note that this guide is only applicable to these versions of LUY. For prior versions, please follow the appropriate LUY upgrade guides to upgrade to the version LUY 7.3 first.

Before starting with the upgrade, please verify that you have the required software packages installed and upgraded to the required version. See here for details: Installation prerequisites.

Preparation

The upgrade steps need only be carried out once. However, they must be repeated for every installed instance of LUY (if applicable). The upgrade process is not intended to be reversible, i.e., after performing the upgrade there is no standard way to revert to the previously installed version of LUY. For that reason, we strongly recommend creating a complete backup of your entire LUY database and the application files.

The provided Docker compose file mounts some data directories from outside the Docker container, e.g., for the Graphics Reactor. Should you have changed this, please make sure that the LUY data directories are backed up and not deleted with the container.

It is NOT recommended using the docker compose file from the previous LUY version. This can result in unexpected side effects if parameters were added or removed.

To help you carry out the upgrade, the following checklist might prove useful:

Checklist

Preparation

Task

Comment

Done

Backup database(s)

MYSQL: mysqldump; Oracle: exp or expdb; MSSQL: BAK or BACKPAC

Backup Docker configuration files

Check for data directories inside the Docker container and save a backup of them.

Per default, data directories are mounted from outside the Docker container.

Verify system and software requirements and upgrade if necessary.

See online documentation for details.

Upgrade

Task

Comment

Done

Stop and remove the LUY Docker container

It's recommended to remove the existing container using
the docker rm command.

Configure LUY 7.4

Transfer custom settings from the old docker compose file. If LDAP or SAML2 is used for authentication, copy luy-auth.properties.
If SAML2 is used for authentication, copy the security directory.

Empty Search Index directory

Check file system permissions

Start LUY 7.4

docker-compose -f luy.yml up -d

Set up

Task

Comment

Done

Initialise search index

Administration -> System

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.