Upgrade Zurmo

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

It is strongly recommended to create a backup before starting the update process. If you have important data, create and try to restore a backup to ensure that everything works properly.

Follow these steps to upgrade the application without migrating the data to another machine:

  • Browse to and download the proper files you may need for the upgrade. For instance, if you are upgrading from 1.5.14 to 2.2.3, you will need and Zurmo upgrades must be done progressively, so follow the process below for each file you may need one at a time.

  • Log in into your server console and run the following commands. Replace FILE with the URL of the necessary file.

    $ cd installdir
    $ cd apps/zurmo/htdocs/app/protected/runtime
    $ mkdir ./upgrade
    $ cd ./upgrade
    $ wget FILE
    $ cd installdir/apps/zurmo/htdocs/app/protected/commands
    $ ./zurmoc upgradeZurmo user runPart1
    $ ./zurmoc upgradeZurmo user runPart2
    $ rm -rf installdir/apps/zurmo/htdocs/app/protected/runtime/upgrade
    $ sudo chown -R bitnami:daemon installdir/apps/zurmo/htdocs
  • Repeat these commands for each upgrade file.

  • Restart the Apache server:

    $ sudo installdir/ restart apache

Your Zurmo application should now have been upgraded.

Last modification April 8, 2020