System Update with Docker¶

Updating System with Internet Access¶

Tip

Below is an example of updating a system to 6.9 version

Pre-conditions¶

The server hosting the updated version of the Universe MDM has Internet access.
Git is installed.
Docker Compose (version above 1.29) is installed.
Universe MDM project has been cloned to the server.

System Update¶

Warning

In version 6.9 the migration from Elasticsearch to OpenSearch was done. If you update the branch with docker up, the old elasticsearch container will prevent further runs. Therefore it is recommended to follow the steps below

Before updating, stop the containers via the docker-compose down command.
- Bring the containers up after the update via the command: docker-compose up --force-recreate -d --remove-orphans. The last option will clean up the Elasticsearch container
Log in to the Gitlab repository (access to the repository with the distribution of your product must be obtained in advance according to the contract).
Switch to the release/6.9 branch
Pull out the project. Command git pull.
Make the migration to Opensearch with loss or saving of data (see below).
Navigate to the directory with the code. Command example:
```
cd universe-platform-deploy
```
If necessary, change the parameters for the database and port parameters in the .env file, located at the root of the project. See the link for an example of the .env file.
To start the system use the command:
```
docker-compose up -d
```

Migrating to Opensearch with Data Loss¶

Since the data will not be migrated, perform the data reindex operation, and if there are quality rules, perform the data reapply operation.

Important:

If the search engine is selected as the storage for auditing, the event log will be lost - it cannot be recovered from the database, even if it is also specified as a storage.

Migrating to OpenSearch with Saving Data¶

In the docker-compose configuration of the Opensearch container, specify the existing Elasticsearch data volume - mdm-elasticsearch-data:/usr/share/opensearch/data.

If you want to get rid of the Elastic mention, you can leave the default volume (mdm-opensearch-data) by doing one of two things:

Clone volume. Example:

docker run --rm \
    -v mdm-elasticsearch-data:/original \
    -v mdm-opensearch-data:/migration \
    ubuntu:latest \
    bash -c "cp -R /original/* /migration/"

Rename volume:

mv /var/lib/docker/volumes/mdm-elasticsearch-data /var/lib/docker/volumes/mdm-opensearch-data