Upgrade instructions¶
Contents
For installation instructions, see Installation.
Read NEWS.md¶
Read the NEWS.md file to look for things you need to have a look at.
Stop IntelMQ and create a 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.
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