Standard installation
...
Linux
Passwork Migration

Old Docker migration to new

12min

These instructions are intended for a single Passwork installation and are not suitable for a fault-tolerant solution

Preparation

Check Passwork version

  1. Check the installed version of Passwork — cat /server/sites/prod/app/config/config.php | grep version. If the version is:
    1. lower than 0602xx — you must upgrade to the current version;
    2. lower than 06xxxx — you need to migrate to Passwork 6.

Create a MongoDB backup

  1. Go to the Passwork directory and create a directory for the files — cd /server/docker-compose/ && mkdir old_docker
  2. Create a MongoDB backup:
    1. Local installation (MongoDB) without authorisation — docker-compose exec -T db sh -c 'mongodump --archive' > "./old_docker/my.dump"
    2. Local installation (MongoDB) with authorisation — docker-compose exec -T db sh -c 'mongodump --archive --authenticationDatabase admin --username=your-admin --password=your-password' > "./old_docker/my.dump"
    3. Installing (MongoDB) on a separate server — docker-compose exec -T db sh -c 'mongodump --host your-host:your-port --archive --authenticationDatabase admin --username=your-admin --password=your-password' > "./old_docker/my.dump"

Copy the config.ini file and the license key

  1. Create a copy of the configuration file config.ini — cp /server/sites/prod/app/config/config.ini ./old_docker/
  2. Create a copy of the license key passwork-*.keys — cp /server/sites/prod/app/keys/*.keys ./old_docker/

Copy a certificate

If Docker installation will use the same domain name and SSL certificate as the previous Passwork installation, then copy the SSL certificates if HTTPS connection is configured — cp -Rf /server/conf/ssl/ ./old_docker/

Installation

Install the main components

  1. Install Docker and Docker Compose
  2. Create and navigate to the directory where you plan to deploy the new Passwork Docker build.
  3. Stop the old (used) nginx container with the command — docker stop nginx && docker rm nginx

Download the scripts

  1. Download the installation script — wget https://repos.passwork.pro/repository/docker/passwork_compose_install.sh
  2. Download the migration script — wget https://repos.passwork.pro/repository/docker/migrate.sh
  3. Assign execution rights — chmod +x ./*.sh

Transfer files from the Preparation stage

  1. Move the created ./old_docker directory to the directory where the new Docker build is going to be deployed
  2. The directory should contain the following files:
    1. Configuration file — config.ini
    2. License key — passwork-*.keys
    3. MongoDB backup
    4. SSL certificates of Passwork website

Start the migration process

  1. Run the script with the -md flag — sudo ./passwork_compose_install.sh -md
  2. The installation script will perform a basic installation of the latest version of Passwork available in your licence and automatically run the migration script.

Optional steps after installation

  1. After the scripts are finished, check that the new installation is working properly and make adjustments if necessary — https://docs.passwork.pro/online-installation#cMZWh
  2. To add mail server or LDAPS protocol root certificates to trusted certificates, copy the .pem or .crt root certificates to the ./conf/custom_ca directory and restart the PHP container — docker compose restart passwork_php
  3. To change the SSL certificate used, copy the certificate/certificate chain to ./conf/ssl/fullchain.pem and the private key to ./conf/ssl/privkey.pem, then restart the Nginx container — docker compose restart passwork_nginx

If you get an authorization error

Issue: Access error to one of the databases when trying to create a full backup:

shell


Solution: Log in to the MongoDB management shell as the current administrator and add the role:

shell




Updated 28 Dec 2024
Doc contributor
Doc contributor
Did this page help you?
PREVIOUS
Passwork Migration
NEXT
Migration from Linux to Docker
Docs powered by Archbee