Skip to content

imperia Update

In this tutorial you will learn how to perform a minor update (e.g. 11.0.0 to 11.1.0) or a micro update (e.g. 11.0.0 to 11.0.1).

Step 1: Follow special update instructions#

Every now and then there are special instructions to follow during an update, which do not have to be executed with every update. These can be very different things, e.g. an update of the database schema or a change in a configuration file.

If there are special update instructions, they can be found in the release document of the new version. In addition, the current notes are also listed on the Download page in Jira in the "wichtige Hinweise" section.

Step 2: Preparation for an update#

  • Make a backup of your system and the database just in case. If you use the data storage File65, then you can simply pack the entire directory. If you store your data in a database, you also need to back up the database.

  • Stop the Hermes service. On the dashboard of the editorial system, you will find a widget with which you can stop the background services of the editorial system and the live systems. Alternatively, you may have started the Hermes service directly using a script call. On Unix systems, you can use the following command to check whether a Hermes service is running:

ps aux | grep hermes
  • Stop the web server(s). Before an update, you should also stop the web server that runs the editorial system.

  • Download the new installation package from the Jira download page, transfer it to the server and unpack it there.

Step 3: Update imperia CMS#

Run the installation script on the system you want to update and follow the instructions.

sudo -u www-data perl /tmp/imperia/install.pl -s /var/www/imperia/dev/site

In the example call above, the -s parameter specifies the site directory of the imperia editing system. All other parameters are automatically taken from the system to be updated.

After the installation script has run, update the data storage with the following call:

perl /var/www/imperia/dev/site/bin/site_doctree_admin.pl -U

Step 4: Start web server#

Start the web server.

Step 5: Start Hermes#

Start the Hermes service.

Step 6: Update target systems#

After you have updated the editorial system, you should also update the target systems to the new version.

Proceed for each target system as described in this tutorial.

However, a shutdown of the web server on the target system is not necessary. Switching off the Hermes service is completely sufficient here.The installation script can distinguish during execution whether you are currently updating an editing system (develop) or a target system (live). To be on the safe side, you can pass the -l parameter during installation:

sudo -u www-data perl /tmp/imperia/install.pl -l -s /var/www/imperia/live/site