From 3a9105a9d0037f281993fb139b684f4ffce43588 Mon Sep 17 00:00:00 2001 From: Aaron Riedener Date: Sun, 28 Apr 2024 22:38:09 +0200 Subject: [PATCH 1/2] [Issue #358] Fix: README and documentation for version 1.14 Changes include updating the current README file to reflect the update from version 1.12 to version 1.14 of koalixcrm. A new detailed update guide has been added to the documentation, providing users with specific instructions for this version update, along with advice for backup and installation of Docker to support the new version. --- README.md | 4 +-- documentation/Update.md | 56 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 58 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index efd0cd85..8cbc8705 100644 --- a/README.md +++ b/README.md @@ -46,5 +46,5 @@ docker compose run --service-ports web python manage.py runserver 0.0.0.0:8000 - ## Release Process Information about the release process: [Release Process](https://github.com/scaphilo/koalixcrm/wiki/Release-Process) -## Update from version 1.11 to 1.12 -Some information about the update procedure from Version 1.11 to Version 1.12: [update](https://github.com/scaphilo/koalixcrm/wiki/Update) +## Update from version 1.12 to 1.14 +Some information about the update procedure from Version 1.12 to Version 1.14: [update](https://github.com/scaphilo/koalixcrm/wiki/Update) diff --git a/documentation/Update.md b/documentation/Update.md index 8b137891..f5ad8766 100644 --- a/documentation/Update.md +++ b/documentation/Update.md @@ -1 +1,57 @@ +# koalixcrm Update from V1.12 to V1.14 +Important: This guide is specifically tailored to guide you through the update process from version V1.12 to V1.14. +Other version migrations may not work with this guidance or may behave differently. + +## Support + +Just like the installation, a certain expertise in server administration is needed to update koalixcrm. +For questions or support, please refer to our website http://www.koalix.com, where you can find more information about our services. + +## Limitations + +This update functionality is written exclusively for the transition from V1.12 to V1.14. It has not been tested +for other version migrations, and the functionality is not guaranteed for such cases. Make sure you're updating from +a properly tagged version (V1.12) to another tagged version (V1.14), and refrain from using the master branch for this process. + +Warning: The update from V1.12 to V1.14 might result in changes to your system. It's always recommended to backup +your data before proceeding. + +## Before you update + +It's strongly recommended that you backup both your koalixcrm project folder and your database before proceeding with +the update, because the process might introduce changes that would be irreversible otherwise. + +# Update process + +## Backup database and KoalixCRM + +Backup your current database Backup your existing koalixcrm project folder + +## Install Docker + +In version V1.14, we are transitioning to Docker for smoother operation. Therefore, Docker must be installed before the +update. You can follow the Docker official documentation for the installation guide. + +## Setup the new container + +Once Docker is installed, go to https://github.com/KoalixSwitzerland/koalixcrm-prod-container and clone the repository. + +## Edit Docker-compose file + +Navigate into the cloned repository and open the docker-compose file. Update the settings according to your system. + +## Restore your files and database from your backup + +After setting up the new container and configuring the Docker-compose file, it's time to restore your files and the +database from your backups you made earlier. + +## Run the container + +Now run the following command in your terminal: + +'''docker-compose up''' + +With this, your koalixcrm application should now be updated from V1.12 to V1.14 and running in the new Docker container. + +Enjoy using KoalixCRM! From 59159c98065e5feb9b826f133db204048a95e536 Mon Sep 17 00:00:00 2001 From: Aaron Riedener Date: Sun, 28 Apr 2024 22:39:09 +0200 Subject: [PATCH 2/2] [Issue #358] Fix: README and documentation for version 1.14 Updated Version from 1.14.1 to 1.14.2 --- koalixcrm/version.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/koalixcrm/version.py b/koalixcrm/version.py index 8c5e6707..38976b82 100644 --- a/koalixcrm/version.py +++ b/koalixcrm/version.py @@ -1 +1 @@ -KOALIXCRM_VERSION = "1.14.1" +KOALIXCRM_VERSION = "1.14.2"