icingaweb2-module-businessprocess/doc/01-Installation.md

Installation

Requirements

• Icinga Web 2 (>= 2.5.1)
• PHP (>= 5.4 or 7.x)
• Icinga Web 2 modules:
  • The monitoring module needs to be configured and enabled.
  • Icinga PHP Library (ipl) (>= 0.1.1) (Icinga Web 2 module)

Installation from .tar.gz

Download the latest version and extract it to a folder named businessprocess in one of your Icinga Web 2 module path directories.

You might want to use a script as follows for this task:

ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/Icinga/icingaweb2-module-businessprocess"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/businessprocess"
MODULE_VERSION="2.1.0"
URL="${REPO_URL}/archive/v${MODULE_VERSION}.tar.gz"
install -d -m 0755 "${TARGET_DIR}"
wget -q -O - "$URL" | tar xfz - -C "${TARGET_DIR}" --strip-components 1

Installation from GIT repository

Another convenient method is the installation directly from our GIT repository. Just clone the repository to one of your Icinga Web 2 module path directories. It will be immediately ready for use:

ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/Icinga/icingaweb2-module-businessprocess"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/businessprocess"
MODULE_VERSION="2.1.0"
git clone "${REPO_URL}" "${TARGET_DIR}"

You can now directly use our current GIT master or check out a specific version.

Enable the newly installed module

Enable the businessprocess module either on the CLI by running

icingacli module enable businessprocess

Or go to your Icinga Web 2 frontend, choose Configuration -> Modules...

...choose the businessprocess module and enable it:

It might afterwards be necessary to refresh your web browser to be sure that newly provided styling is loaded.

Create your first Business Process definition

That's it, Business Process is now ready for use. Please read more on how to get started.