Update to v23.12
Update procedure for v23.12 version does
not differ from the standard one, but docker-compose down command should be
executed with --remove-orphans key due to container renaming.
However, v23.12 introduces several changes that require additional steps to be taken before running MITIGATOR. Such changes include:
- end of support of the old
data-plane.confconfiguration file format existed before v20.08. - Renaming
data-plane.conffile todataplane.conf. Compatibility with the old name is maintained, but we recommend to update the file name. - Renaming
data-planecontainer todataplane. - Changes to
pgfailoverlogic. - Transferring VPN settings to the base configuration file
docker-compose.yml.
Therefore, when updating, make sure that:
-
data-plane.confdirectory, if present, has been removed;rmdir data-plane.conf -
file
data-plane.confrenamed todataplane.conf;mv data-plane.conf dataplane.conf || touch dataplane.conf -
settings in
dataplane.confare set correctly; -
in the new base configuration file
docker-compose.ymland in all additional.ymlspecified inCOMPOSE_FILEvariable of.envfile, the container name is changed todataplane.Get a list of files specified in
COMPOSE_FILE:cat .env | grep COMPOSE_FILE -
COMPOSE_FILEvariable in the.envfile does not containdocker-compose.vpn.yml; -
In
docker-compose.failover.ymlfile, if there is one,BACKEND_PGFAILOVER_ADDRESSvariable is set forbackendservice;services: backend: environment: BACKEND_PGFAILOVER_ADDRESS: "${MITIGATOR_VPN_ADDRESS:-localhost}:50052" -
In MITIGATOR Web interface, re-set the settings in the “HTTPS Challenge-Response Authentication” panel on the “Settings” page and in the HCA countermeasure, if they were previously set.