Installation with pip or from source¶
Alignak system requirements are documented in this chapter. Make sure that your system is complying before trying to install;)
Installation with pip¶
The installation from the PyPi repository is very simple, use this command:
# Python 2
sudo pip install alignak
# Python 3
sudo pip3 install alignak
This will get and install the most recent alignak package found on your default PyPi configuration.
After the installation, some files are shipped in the /usr/local/share/alignak directory: a default configuration, system service units files, man pages, …
Note
If you wish a specific version, specify the version requirements on the command line: sudo pip install alignak==2.0.0rc3
No matter why, but you may need to reinstall all the Python Alignak dependencies. You can easily do it with this command line:
sudo pip install -r /usr/local/share/alignak/requirements.txt
Tip
The Alignak project team maintains Alignak and all the Alignak related stuff on its PyPI page. All the published versions are available on the PyPI repository and are tagged alignak
.
Note
because of some pip specific behavior, installing Alignak requires to be connected as a user (and not as root) to run the pip command. If you really need to install from a root account, use pip install . -v --install-option='--prefix=/usr/local'
Note
the only downside with the pip installation is that the system services are not automatically installed but you can install a posteriori because all necessary files are shipped in the /usr/local/share/alignak/bin directory
Installation from the source¶
Get the source archive on the project GitHub releases page and uncompress the downloaded file then install with python pip.
# As an exemple, for a version tagged as "1.1.0" # Use the most recent version from the project releases page ;) wget https://github.com/Alignak-monitoring/alignak/archive/1.1.0.tar.gz tar -xvf 1.1.0.tar.gz cd alignak-1.1.0 sudo pip install -r requirements.txt sudo pip install . ... ... Successfully installed ......
To start Alignak as system services, you must install the shipped service units. The procedure is documented here.
Note
because of some pip specific behavior, installing Alignak requires to be connected as a user (and not as root) to run the pip command. If you really need to install from a root account, use pip install . -v --install-option='--prefix=/usr/local'
Note
the only downside with the pip installation is that the system services are not automatically installed but you can install a posteriori because all necessary files are shipped in the /usr/local/share/alignak/bin directory