doc, module.info: refresh, cleanup, prepare v1.7.0

This commit is contained in:
Thomas Gelf 2019-09-26 00:22:05 +02:00
parent 26c272bba9
commit 7ded2bf19d
5 changed files with 46 additions and 61 deletions

View File

@ -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!

View File

@ -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.

View File

@ -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
------------ ------------

View File

@ -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

View File

@ -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