Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Alignak backend import

Project description

This module contains utility tools to import Nagios-like flat files configuration into
an Alignak REST backend.
Author: Frédéric Mohier
License: GNU Affero General Public License, version 3
Project-URL: Presentation,
Project-URL: Documentation,
Project-URL: Source,
Project-URL: Tracker,
Project-URL: Contributions,
Description: Alignak Backend import

*Import flat files Nagios-like configuration into the Alignak backend*

.. image::
:alt: Develop branch build status

.. image::
:alt: Latest documentation Status

.. image::
:alt: Development documentation Status

.. image::
:alt: Last PyPi version

.. image::
:alt: License AGPL v3

Short description

This package contains an utility tool `alignak-backend-import` that allows to import a Nagios-like flat files monitoring configuration into an Alignak Backend.

Release strategy

Alignak backend and its *satellites* (backend client, and backend import tools) must all have the same features level. As of it, take care to install the same minor version on your system to ensure compatibility between all the packages. Use 0.4.x version of Backend import and Backend client with a 0.4.x version of the Backend.

Alignak backend import

The `alignak-backend-import` script may be used to import a Nagios like flat-files configuration into the Alignak backend.

The online `documentation<>`_ exaplins all the command line parameters that may be used.

A simple usage example for this script::

# Assuming that you installed: alignak, alignak-backend and alignak-backend-import

# From the root of this repository
cd tests/alignak_cfg_files
# Import the test configuration in the Alignak backend
alignak-backend-import -d -m ./alignak-demo/alignak-backend-import.cfg

# The script imports the configuration and makes some console logs:
alignak_backend_import, inserted elements:
- 6 command(s)
- 3 host(s)
- 3 host_template(s)
- no hostdependency(s)
- no hostescalation(s)
- 12 hostgroup(s)
- 1 realm(s)
- 1 service(s)
- 14 service_template(s)
- no servicedependency(s)
- no serviceescalation(s)
- 12 servicegroup(s)
- 2 timeperiod(s)
- 2 user(s)
- 3 usergroup(s)

# To confirm, you easily can get an host from the backend
alignak-backend-cli -t host get test_host_0

# The script dumps the json host on the console and creates a file: */tmp/alignak-object-dump-host-test_host_0.json*
"active_checks_enabled": true,
"address": "",
"address6": "",
"alias": "test_host_0",
"customs": {
"_OSLICENSE": "gpl",
"_OSTYPE": "gnulinux"

# Get the list of all imported hosts from the backend
alignak-backend-cli --list -t host get

# The script dumps the json list of hosts on the console and creates a file: */tmp/alignak-object-list-hosts.json*
"active_checks_enabled": true,
"address": "",
"address6": "",
"alias": "test_host_0",
"customs": {
"_OSLICENSE": "gpl",
"_OSTYPE": "gnulinux"


From Alignak packages repositories

More information in the online Alignak backend documentation. Here is only an abstract...


# Alignak DEB stable packages
sudo echo deb xenial main | sudo tee -a /etc/apt/sources.list.d/alignak.list
sudo apt-key adv --keyserver hkp:// --recv D401AB61

sudo apt-get update
sudo apt install python-alignak-backend-import


sudo vi /etc/yum.repos.d/alignak-stable.repo:
name=Alignak RPM stable packages

sudo yum repolist

sudo yum install python-alignak-backend-import

.. note:: for Python 3 version, replace ``python`` with ``python3`` in the packages name.

From PyPI
To install the package from PyPI::

sudo pip install alignak-backend-import

From source files
To install the package from the source files::

git clone
cd alignak-backend-import
sudo pip install .

Bugs, issues and contributing

Please report any issue using the project `issues page <>`_.

Keywords: alignak monitoring backend import tool
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD :: FreeBSD
Classifier: Topic :: System
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/x-rst

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
alignak_backend_import-1.2.2-py3-none-any.whl (24.0 kB) Copy SHA256 hash SHA256 Wheel py3 Aug 20, 2018
alignak_backend_import-1.2.2.tar.gz (30.9 kB) Copy SHA256 hash SHA256 Source None Aug 20, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page