Major Upgrade

Added by Alexander Blum 17 days ago

Changes

Finally our software received a mayor version upgrade.

Upgrade

In order to upgrade your local setup, perform the following commands:

  1. Upgrading to current versions of docker (20.10.9) and docker-compose (2.0.1)
    are highly recommended, especially docker-compose >= 2 (parallel builds are quite faster).
    For a debian based OS with the source repository already added:

    docker --version
    apt-get install --only-upgrade docker-ce docker-ce-cli containerd.io
    docker --version
    
    docker-compose --version
    rm /usr/local/bin/docker-compose
    mkdir -p /usr/local/lib/docker/cli-plugins
    curl -SL https://github.com/docker/compose/releases/download/v2.0.1/docker-compose-linux-x86_64 \
        -o /usr/local/lib/docker/cli-plugins/docker-compose
    chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
    ln -s /usr/local/lib/docker/cli-plugins/docker-compose /usr/local/bin/docker-compose
    docker-compose --version
    
    # note, that the dash between `docker` and `compose` is not needed anymore
    docker compose --version
    
  2. Stop all running services

    docker compose down
    docker compose -f docker-compose.testing.yml down
    docker compose -f docker-compose.documentation.yml down
    
  3. Delete all *.pyc files

    cd PATH/TO/REPO
    find . -name \*.pyc -delete
    
  4. Delete the volumes

    sudo rm -rf \
        volumes/echoprint-data \
        volumes/postgresql-data \
        volumes/trytond-files
    docker volume rm \
        collecting_society_test_echoprint_data \
        collecting_society_test_postgresql_data \
        collecting_society_test_trytond_files
    
  5. If you upgraded from docker-compose 1 -> 2, you might want to delete the old images, too,
    as the new build system won't save the intermediate image cache as normal images.
    WARNING: The following command will delete all images. If you use docker with other projects,
    don't use this method!

    docker container prune
    docker image prune -a -f
    
  6. Build the images/database and start the services

    git pull
    ./project update
    docker compose build
    ./db-rebuild
    docker compose up
    
  7. Install the new tryton client and test the connection. You can also connect to the test portal, just ask for the password.

There might be several problems with the procedure or the software after this upgrade,
so please contact us or create a ticket, if anything unexpected happens.


Comments