Upgrading Txture
In principle the upgrade process is straightforward for the administrator. Make sure you create a backup of your txture_home
folder. The upgrade itself is a drop-in replace of the existing installation. Any necessary migrations will be automatically undertaken by Txture. After the upgrade, make sure that you are running the new version by looking either at the version number in the "About" dialog or at the output of the startup process.
Warning:
With the release of Txture 34 the internal configuration database is migrated from SQLite to PostgreSQL 15+. In addition, an upgrade from Tomcat 9 to Tomcat 10.1 is required. If you are not using a SaaS instance, please have a look at the migration guide.
Upgrading Docker deployments
By using volumes to store data, a docker container essentially becomes a throw-away item. One can safely delete a container or image and no data is lost. This makes updating a breeze!
Using docker-compose
If you are using docker-compose
you may simply to the following from the directory where your docker-compose.yml
is located:
docker-compose down
Modify the docker-compose.yml
to include the new version number as the container tag.
docker-compose up -d
Directly run via Docker
First stop the running Txture container and remove it:
docker stop txture
docker rm txture
Note that the second step is actually necessary as docker would complain otherwise when starting a new container with the same name. In the next step, download the new Txture version:
docker pull eu.gcr.io/txture-docker/txture:<new_version>
As a next step, a backup for the folder containing your volume is highly recommended. Although version upgrades are carefully tested, a backup is always recommended. If the container is stopped, you can simply make a copy of the txture_home
folder.
After the backup and after downloading the new image, simply start Txture again as before:
docker run --name txture -p 8080:8080 -d -v /path/to/your/txture_home:/opt/txture_home eu.gcr.io/txture-docker/txture:<new_version>