Upgrading old 4CAT versions - digitalmethodsinitiative/4cat GitHub Wiki

Upgrading older 4CAT Versions

Docker 4CAT releases v1.30 to v1.33

An issue was identified that caused the interactive upgrade process to fail in our Docker setup (a GitHub update in the Docker image build process causes 4CAT to not be able to update its own code). In order to upgrade any of these versions, you must upgrade via the command line instructions. The issue was fixed in v1.34.

Docker PRIOR to v1.26

v1.26 migrated configuration settings from config.py to the database. Docker will lose those settings if you rebuild the image. If you never changed config.py, you can update per the instructions above. You may want to copy config.py from your 4CAT container prior to recreating it via docker cp 4cat_backend:/usr/src/app/config.py ./ in case there are issues migrating. A migrate script was developed to move your config.py settings to the new database (where they will be permanent and editable via the 4CAT web interface).

1. Update the 4cat_backend
   • docker exec -it 4cat_backend /bin/bash
   • git pull
   • optionally: git checkout COMMIT_ID or git checkout BRANCH_NAME
   • python3 4cat-daemon.py stop
   • python3 helper-scripts/migrate.py
2. Update the 4cat_frontend
   • docker exec -it 4cat_backend /bin/bash
   • git pull
   • optionally: git checkout COMMIT_ID or git checkout BRANCH_NAME
   • python3 helper-scripts/migrate.py
3. Restart the containers
   • cd your/4cat/directory/
   • docker-compose stop
   • docker-compose start