UPGRADING.md

Upgrade instructions

For installation instructions, see INSTALL.md.

Table of Contents:

• Stop IntelMQ and Backup
• Upgrade IntelMQ
  • Packages
  • PyPi
  • Local repository
• Check the installation
• Redefine/Check permissions
• Start IntelMQ

Read NEWS.md

Read the NEWS.md file to look for things you need to have a look at.

Stop IntelMQ and Backup

• Make sure that your IntelMQ system is completely stopped: intelmqctl stop
• Create a backup of IntelMQ Home directory, which includes all configurations. They are not overwritten, but backups are always nice to have!

> sudo cp -R /opt/intelmq /opt/intelmq-backup

Upgrade IntelMQ

Before upgrading, check that your setup is clean and there are no events in the queues:

intelmqctl check
intelmqctl list queues -q

The upgrade depends on how you installed IntelMQ.

Packages

Use your systems package management.

PyPi

pip install -U --no-deps intelmq
sudo intelmqsetup

Using --no-deps will not upgrade dependencies, which would probably overwrite the system's libraries. Remove this option to also upgrade dependencies.

Local repository

If you have an editable installation, refer to the instructions in the Developers Guide.

Update the repository depending on your setup (e.g. git pull origin master).

And run the installation again:

pip install .
sudo intelmqsetup

For editable installations (development only), run pip install -e . instead.

Upgrade configuration and check the installation

Go through NEWS.md and apply necessary adaptions to your setup. If you have adapted IntelMQ's code, also read the CHANGELOG.md.

Check your installation and configuration to detect any problems:

intelmqctl upgrade-config
intelmqctl check

Start IntelMQ

> intelmqctl start