mirror of
https://github.com/Icinga/icingaweb2-module-director.git
synced 2025-07-27 15:54:03 +02:00
doc, module.info: refresh, cleanup, prepare v1.7.0
This commit is contained in:
parent
26c272bba9
commit
7ded2bf19d
@ -27,6 +27,9 @@ Requirements
|
|||||||
for MySQL we suggest using at least 5.5.3, for PostgreSQL 9.4.
|
for MySQL we suggest using at least 5.5.3, for PostgreSQL 9.4.
|
||||||
* PHP (>= 5.6.3). For best performance please consider use 7.x
|
* PHP (>= 5.6.3). For best performance please consider use 7.x
|
||||||
* php-curl
|
* php-curl
|
||||||
|
* php-pcntl (might already be built into your PHP binary)
|
||||||
|
* php-posix (on RHEL/CentOS this is php-process, or rh-php7x-php-process)
|
||||||
|
* php-sockets (might already be built into your PHP binary)
|
||||||
|
|
||||||
Database
|
Database
|
||||||
--------
|
--------
|
||||||
@ -89,7 +92,7 @@ You might want to use a script as follows for this task:
|
|||||||
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
|
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
|
||||||
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
|
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
|
||||||
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
|
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
|
||||||
MODULE_VERSION="1.6.2"
|
MODULE_VERSION="1.7.0"
|
||||||
URL="${REPO_URL}/archive/v${MODULE_VERSION}.tar.gz"
|
URL="${REPO_URL}/archive/v${MODULE_VERSION}.tar.gz"
|
||||||
install -d -m 0755 "${TARGET_DIR}"
|
install -d -m 0755 "${TARGET_DIR}"
|
||||||
wget -q -O - "$URL" | tar xfz - -C "${TARGET_DIR}" --strip-components 1
|
wget -q -O - "$URL" | tar xfz - -C "${TARGET_DIR}" --strip-components 1
|
||||||
@ -106,7 +109,7 @@ It will be immediately ready for use:
|
|||||||
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
|
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
|
||||||
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
|
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
|
||||||
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
|
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
|
||||||
MODULE_VERSION="1.6.2"
|
MODULE_VERSION="1.7.0"
|
||||||
git clone "${REPO_URL}" "${TARGET_DIR}" --branch v${MODULE_VERSION}
|
git clone "${REPO_URL}" "${TARGET_DIR}" --branch v${MODULE_VERSION}
|
||||||
|
|
||||||
You can now directly use our current GIT master or check out a specific version.
|
You can now directly use our current GIT master or check out a specific version.
|
||||||
@ -132,4 +135,3 @@ tab.
|
|||||||
|
|
||||||
Either way you'll reach the kickstart wizards. Follow the instructions and
|
Either way you'll reach the kickstart wizards. Follow the instructions and
|
||||||
you're all done!
|
you're all done!
|
||||||
|
|
||||||
|
@ -50,6 +50,12 @@ modules have been installed and enabled:
|
|||||||
* [incubator](https://github.com/Icinga/icingaweb2-module-incubator) (>=0.5.0)
|
* [incubator](https://github.com/Icinga/icingaweb2-module-incubator) (>=0.5.0)
|
||||||
* [reactbundle](https://github.com/Icinga/icingaweb2-module-reactbundle) (>=0.7.0)
|
* [reactbundle](https://github.com/Icinga/icingaweb2-module-reactbundle) (>=0.7.0)
|
||||||
|
|
||||||
|
Also, the following PHP libraries should be available:
|
||||||
|
|
||||||
|
* php-pcntl (might already be built into your PHP binary)
|
||||||
|
* php-posix (on RHEL/CentOS this is php-process, or rh-php7x-php-process)
|
||||||
|
* php-sockets (might already be built into your PHP binary)
|
||||||
|
|
||||||
Apart from this, in case you are running 1.6.x or any GIT master since then,
|
Apart from this, in case you are running 1.6.x or any GIT master since then,
|
||||||
all you need is to replace the Director module folder with the new one. Or to
|
all you need is to replace the Director module folder with the new one. Or to
|
||||||
run `git checkout v1.7.x` in case you installed Director from GIT.
|
run `git checkout v1.7.x` in case you installed Director from GIT.
|
||||||
|
@ -1,8 +1,11 @@
|
|||||||
<a id="Jobs"></a>Jobs
|
<a id="Jobs"></a>Jobs
|
||||||
=====================
|
=====================
|
||||||
|
|
||||||
Director allows you to schedule eventually long-running tasks so that they
|
The [background daemon](75-Background-Daemon.md) is responsible for running
|
||||||
can run in the background. Currently this includes:
|
Jobs accoring our schedule. Director allows you to schedule eventually long-
|
||||||
|
running tasks so that they can run in the background.
|
||||||
|
|
||||||
|
Currently this includes:
|
||||||
|
|
||||||
* Import runs
|
* Import runs
|
||||||
* Sync runs
|
* Sync runs
|
||||||
@ -27,55 +30,6 @@ executed all around the clock. That's why you have the possibility to assign
|
|||||||
time periods to your jobs. Choose an Icinga timeperiod, the job will only be
|
time periods to your jobs. Choose an Icinga timeperiod, the job will only be
|
||||||
executed within that period.
|
executed within that period.
|
||||||
|
|
||||||
Execution methods
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
Jobs are executed on CLI, basically with the `jobs` CLI command and its
|
|
||||||
available actions and options. A call to...
|
|
||||||
|
|
||||||
```sh
|
|
||||||
icingacli director jobs run
|
|
||||||
```
|
|
||||||
|
|
||||||
...would run all currently pending jobs just once. As cron jobs should not run
|
|
||||||
forever, the command terminates after this. In case you want it to keep on
|
|
||||||
running, just add `forever` (or `--forever`) to the command:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
icingacli director jobs run forever
|
|
||||||
```
|
|
||||||
|
|
||||||
This could be used to run the Job Runner as a daemon, preferrably with a
|
|
||||||
systemd unit file looking as follows:
|
|
||||||
|
|
||||||
```ini
|
|
||||||
[Unit]
|
|
||||||
Description=Director Job runner
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=simple
|
|
||||||
ExecStart=/usr/bin/icingacli director jobs run forever
|
|
||||||
Restart=on-success
|
|
||||||
```
|
|
||||||
|
|
||||||
However, `forever` is not forever. In case Director detects that too much
|
|
||||||
memory has been used (and not freed), it terminates itself with exit code 0.
|
|
||||||
So, like the above init script, please expect the Job Runner to terminate at
|
|
||||||
any time.
|
|
||||||
|
|
||||||
Want so see more details? Add `--verbose` to get colorful log lines on STDERR.
|
|
||||||
In case the Job Runner is running with Systemd, those log lines will find its
|
|
||||||
way to your system log.
|
|
||||||
|
|
||||||
An example script is included as [contrib](../contrib/systemd/director-jobs.service)
|
|
||||||
and can simply stored in `/etc/systemd/system/director-jobs.service`. To enable
|
|
||||||
and start the job afterwards run:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
systemctl enable director-jobs.service
|
|
||||||
systemctl start director-jobs.service
|
|
||||||
```
|
|
||||||
|
|
||||||
Time periods
|
Time periods
|
||||||
------------
|
------------
|
||||||
|
|
||||||
|
@ -4,14 +4,13 @@
|
|||||||
Please make sure to always read our [Upgrading](05-Upgrading.md) documentation
|
Please make sure to always read our [Upgrading](05-Upgrading.md) documentation
|
||||||
before switching to a new version.
|
before switching to a new version.
|
||||||
|
|
||||||
1.7.0 (unreleased)
|
1.7.0
|
||||||
------------------
|
-----
|
||||||
### Breaking Changes
|
### Breaking Changes
|
||||||
* At least PHP 5.6.3 is now required, Director 1.7.x will refuse to work with
|
* At least PHP 5.6.3 is now required, Director 1.7.x will refuse to work with
|
||||||
older versions
|
older versions
|
||||||
* New dependencies have been introduced: you're now required to install the ipl
|
* New dependencies have been introduced, [Upgrading](05-Upgrading.md) and
|
||||||
* Please check [packages.icinga.com](https://packages.icinga.com), we're now
|
[Installation](02-Installation.md) documentations contain related details
|
||||||
shipping official packages for the Icinga Director
|
|
||||||
|
|
||||||
### Fixed issues
|
### Fixed issues
|
||||||
* You can find issues and feature requests related to this release on our
|
* You can find issues and feature requests related to this release on our
|
||||||
@ -25,16 +24,35 @@ before switching to a new version.
|
|||||||
* FIX: Import preview in combination with Black/Whitelisting (#1825)
|
* FIX: Import preview in combination with Black/Whitelisting (#1825)
|
||||||
* FIX: Routing/redirection when working with Data Fields (#1847)
|
* FIX: Routing/redirection when working with Data Fields (#1847)
|
||||||
* FIX: Auto-suggestion field was positioned wrongly once scrolled down
|
* FIX: Auto-suggestion field was positioned wrongly once scrolled down
|
||||||
|
* FIX: Timezone inconsistencie have been fixed (#1700)
|
||||||
|
* FIX: Link-like buttons where shortened on Icinga Web 2.7 (#1928)
|
||||||
|
* FIX: Search in range-filtered Activity Log no longer fails (#1381)
|
||||||
* FEATURE: It's now possible to clone a Service to a different Host (#1796)
|
* FEATURE: It's now possible to clone a Service to a different Host (#1796)
|
||||||
* FEATURE: Scheduled Downtimes for "Hosts AND their services" (#1831)
|
* FEATURE: Scheduled Downtimes for "Hosts AND their services" (#1831)
|
||||||
* FEATURE: auto-suggestion and more for Fields based on Data Lists (#1846)
|
* FEATURE: Auto-suggestion and more for Fields based on Data Lists (#1846)
|
||||||
|
* FEATURE: Show missing dependencies (#1938)
|
||||||
|
|
||||||
|
### Translations
|
||||||
|
* FEATURE: German translation has been refreshed (#1951)
|
||||||
|
* FEATURE: Japanese is now available (#1869)
|
||||||
|
|
||||||
### Import and Sync
|
### Import and Sync
|
||||||
* FIX: Avoid caching between multiple runs of sync (#1836)
|
* FIX: Avoid caching between multiple runs of sync (#1836)
|
||||||
|
* FIX: Imported Rows Table (history) eventually failed on Icinga Web 2 (#1925)
|
||||||
|
* FIX: Improved error handling on preview (#1941)
|
||||||
* FEATURE: When fetching invalid data, Import refers erroneous rows (#1741)
|
* FEATURE: When fetching invalid data, Import refers erroneous rows (#1741)
|
||||||
* FEATURE: Sync now offers a preview, showing what would happen (#1754)
|
* FEATURE: Sync now offers a preview, showing what would happen (#1754)
|
||||||
* FEATURE: ParseURL property modifier has been added (#1746)
|
* FEATURE: ParseURL property modifier has been added (#1746)
|
||||||
* FEATURE: There is a new generic REST API Import Source (#1818)
|
* FEATURE: There is a new generic REST API Import Source (#1818)
|
||||||
|
* FEATURE: Sync now supports Notifications and Dependencies (#1212, #925, #1209)
|
||||||
|
* FEATURE: Limits (memory, execution time) raised for Import runs via UI (#1954)
|
||||||
|
|
||||||
|
### Configuration Baskets
|
||||||
|
* FIX: snapshots do no longer fail for deleted elements on snapshot (#1940)
|
||||||
|
* FEATURE: baskets now support External Commands (#1854)
|
||||||
|
|
||||||
|
### REST API
|
||||||
|
* FIX: Command Arguments can now be managed via API (#1416)
|
||||||
|
|
||||||
### CLI
|
### CLI
|
||||||
* FIX: importsource fetch did not apply configured property modifiers (#1819)
|
* FIX: importsource fetch did not apply configured property modifiers (#1819)
|
||||||
@ -42,8 +60,13 @@ before switching to a new version.
|
|||||||
|
|
||||||
### Icinga Configuration
|
### Icinga Configuration
|
||||||
* FIX: Allow to render single configuration files larger than 16MB (#1787)
|
* FIX: Allow to render single configuration files larger than 16MB (#1787)
|
||||||
|
* FIX: Icinga v2.11 version detection for Agent Installation script (#1957)
|
||||||
|
* DEPRECATED: magic-apply-for (a hidden feature) is now deprecated (#1850)
|
||||||
* FEATURE: It's now possible to define Scheduled Downtimes (#347, #1828)
|
* FEATURE: It's now possible to define Scheduled Downtimes (#347, #1828)
|
||||||
* FEATURE: Allow to render command definitions as (v1.x-like) strings (#1809)
|
* FEATURE: Allow to render command definitions as (v1.x-like) strings (#1809)
|
||||||
|
* FEATURE: host address now allows 255 characters (#1890)
|
||||||
|
* FEATURE: Director now assists with Services applied to parent Zones (#1634)
|
||||||
|
* FEATURE: Warn affected setups when affected by a specific core issue (#1958)
|
||||||
|
|
||||||
### Documentation
|
### Documentation
|
||||||
* FIX: Installation instructions have been adjusted to fit MySQL 8
|
* FIX: Installation instructions have been adjusted to fit MySQL 8
|
||||||
|
@ -1,5 +1,5 @@
|
|||||||
Name: Icinga Director
|
Name: Icinga Director
|
||||||
Version: master
|
Version: 1.7.0
|
||||||
Depends: reactbundle (>=0.7.0), ipl (>=0.3.0), incubator (>=0.5.0)
|
Depends: reactbundle (>=0.7.0), ipl (>=0.3.0), incubator (>=0.5.0)
|
||||||
Description: Director - Config tool for Icinga 2
|
Description: Director - Config tool for Icinga 2
|
||||||
Icinga Director is a configuration tool that has been designed to make
|
Icinga Director is a configuration tool that has been designed to make
|
||||||
|
Loading…
x
Reference in New Issue
Block a user