Skip to main content

Upgrade cyclos

1.1.7. Upgrading Cyclos

  • To upgrade Cyclos follow these steps:
    • Before updating always study the release notes and changelog they are published on the Cyclos license server.
    • Make a backup of the database.
    • Download the latest version of Cyclos from the license server.
    • Unzip the cyclos-<version>.zip into a temporary directory.
    • Browse to the temporary directory and rename the directory web to cyclos.
    • Copy your current cyclos.properties file (<tomcat_home>/webapps/cyclos/WEB-INF/classes/cyclos.properties) to the same place in the temporary directory.
    • Remove the directory cyclos from the tomcat webapps directory (<tomcat_home>/webapps/cyclos/).
    • Browse to the temporary directory and copy the directory cyclos (including its contents) into the webapps directory (<tomcat_home>/webapps) of the tomcat installation.
  • We would also recommend to do the following:
    • Between major Cyclos versions the Cyclos API can change, please test on a local server (with the database backup) if all scripts and extensions made through the web services still work.
    • In general it is a good practice to test everything before upgrading, if you test with your local database please don't forget to remove the email host and sms gateway so that the users don't receive any notifications.
    • All API changes per version can be found here: http://www.cyclos.org/documentation (see Webservices API Differences and Scripting API Differences).
    • If locally everything works fine a live update can be done as described above.
    • To avoid overwriting the cyclos.properties file without intention this file is named as cyclos-release.properties in the zip file. It might be interesting to study the new file to see if new settings have become available.

     

systemctl stop tomcat9
./backupALLSQL.sh
unzip cyclos-4.16.17.zip
cp /opt/tomcat/webapps/ROOT/WEB-INF/classes/cyclos.properties cyclos-4.16.17/web/WEB-INF/classes/
mkdir ROOT-20251201
mv /opt/tomcat/webapps/ROOT/* ROOT-20251201
mv cyclos-4.16.17/web/* /opt/tomcat/webapps/ROOT/
./fixPerms.sh

Back to top