Icinga PowerShell Framework

1.11.0 (2023-08-01)

Issues and PRs

Bugfixes

• #579 Fixes error message during config generation with Get-IcingaCheckCommandConfig to make it more clear, in case the custom variables generated are too long for the Icinga Director import
• #603 Fixes service filter to handle exclude with wildcards instead of requiring the full service name (not applying to the display name)
• #609 Fixes config generator to never use set_if = true on Icinga 2/Icinga Director configuration
• #611 Fixes Sync-IcingaRepository which did not save the SSH user and host inside the repository configuration, preventing Update-IcingaRepository to work properly and added missing scp progress
• #615 Fixes the framework migration tasks which fails in case multiple versions of the framework are installed, printing warnings in case there is
• #617 Fixes failing calls for plugins which use a switch argument like -NoPerfData, which is followed directly by the -ThresholdInterval argument
• #621 Fixes -ThresholdInterval key detection on newer systems
• #634 Fixes an issue with Clear-Host which could cause an exception during certain automation tasks, causing it to fail
• #645 Fixes error and exception handling while using API-Checks, which now will in most cases always return a proper check-result object and also abort while running into plugin execution errors, in case a server is not reachable by the time sync plugin for example
• #646 Fixes REST-Api to allow arguments for check execution with and without leading -
• #648 Fixes some memory management while using the REST-Api to clear connection objects once they are no longer required

Enhancements

• #544 Adds support to configure the Icinga Director JSON string for registering hosts via self-service API
• #572 Adds support to write the name of the repository synced/created into the local ifw.repo.json file
• #573 Adds support to run command icinga with new argument -NoNewInstance, to use -RebuildCache as example to update the current PowerShell instance with all applied changes
• #613 Adds a -Version parameter to the Update-Icinga command, to be able to update a component to a specified version [@log1-c]
• #619 Adds feature to securely read enum provider values with new function Get-IcingaProviderEnumData
• #623 Adds support to provide the Icinga service user written as user@domain
• #633 Adds support for Icinga 2.14.0 native Icinga for Windows API communication
• #635 Adds support for Write-IcingaAgentApiConfig function to configure the Icinga Agent TLS cipher list setting by new argument -CipherList
• #637 Adds new base handling for future data providers with first metrics for CPU information
• #638 Adds option for formatted, colored console prints with Write-ColoredOutput
• #640 Adds support to set the flag -NoSSLValidation for Cmdlets icinga and Install-Icinga, to ignore errors on self-signed certificates within the environment
• #643 Adds support for -RebuildCache flag on icinga cmd to rebuild component cache as well
• #644 Adds progress bar output to repository interaction (sync, update, new) instead of plain text output
• #649 Adds new basic data provider base for Hyper-V information
• #655 Adds IWKB and test/manage Cmdlets for SCOM intercept counters
• #656 Adds new feature to write document content easier by storing it in memory first and then allowing to write it to disk at once with proper UTF8 encoding

1.10.1 (2022-12-20)

Issue and PRs

Bugfixes

• #578 Fixes installation and uninstallation commands changing PowerShell location even when not necessary
• #582 Fixes background service registration caused by migration task for v1.10.0 being executed even when no services were defined before
• #588 Fixes threshold values causing an error because of too aggressive regex expression
• #599 Fixes plugin argument parser to proceed with real argument names and possible provided aliases

1.10.0 (2022-08-30)

Issue and PRs

Please have a look on the upgrading docs before upgrading to v1.10.0!

Deprecated

• We have decided to now officially deprecate the previous installation method Start-IcingaAgentInstallWizard. It hasn't been updated or promoted in a long time and all new features have been moved to the Icinga Management Console. Please update your installation method to the new solution. The old method will be removed in a future release.

Bugfixes

• #473 Fixes an issue with current string rendering config implementation, as string values containing whitespaces or $ are rendered wrong by default, if not set in single quotes ''
• #476 Fixes exception You cannot call a method on va null-valued expression during installation in case no background daemon is configured
• #482 Fixes encoding problems with special chars or German umlauts during plugin execution and unescaped whitespace in plugin argument strings like Icinga for Windows, which was previously wrongly rended as Icinga for example
• #489 Fixes error message This argument does not support the % unit in case a BaseValue is set, but the actual value is 0
• #503 Fixes wrong conversion of values for Convert-IcingaPluginThresholds, which did not properly handle string values containing certain units inside the string itself
• #505 Fixes certificate generation and host registration, in case a custom hostname was set during usage of Install-Icinga automation
• #529 Fixes package manifest reader for Icinga for Windows components on Windows 2012 R2 and older
• #523 Fixes errors on encapsulated PowerShell calls for missing Cmdlets Write-IcingaConsoleError and Optimize-IcingaForWindowsMemory
• #524 Fixes uninstallation process by improving the location handling of PowerShell instances with Icinga IMC or Shell
• #528 Fixes negative thresholds being interpreted wrongly as argument instead of an value for an argument
• #545 Fixes RemoteSource being cleared within repository .json files during Update-IcingaRepository tasks
• #552 Fixes file encoding for Icinga for Windows v1.10.0 to ensure the cache is always properly created with the correct encoding
• #553 Fixes an exception caused by service recovery setting, if the required service was not installed before
• #556 Fixes the certificate folder not present during first installation, preventing permissions properly set from the start which might cause issues once required
• #562 Fixes corrupt Performance Data, in case plugins were executed inside a JEA context without the REST-Api
• #563 Fixes checks like MSSQL using arguments of type SecureString not being usable with the Icinga for Windows REST-Api
• #565 Fixes internal cache file writer and reader to store changes inside a .tmp file first and validating the file state and content, before applying it to the actual file to prevent data corruption
• #566 Fixes useless testing and printing of error messages, in case the Icinga Agent is not installed during installation and Icinga for Windows printing plenty of errors, because the ACL checks cannot be completed because of the missing Agent
• #568 Fixes misleading SID error during uninstallation of Icinga for Windows or the Agent component

Enhancements

• #40 Adds support to set service recovery for the Icinga Agent and Icinga for Windows service, to restart them in case of a crash or error
• #485 Adds new style for performance data labels, to use the multi output format, allowing for better filtering and visualisation with InfluxDB and Grafana
• #502 Adds support for hostname override for old installer function Start-IcingaAgentInstallWizard [moreamazingnick]
• #525 Adds new developer mode for icinga command and improved cache handling, to ensure within -DeveloperMode and inside a VS Code environment, the framework cache file is never overwritten, while still all functions are loaded and imported.
• #531 Adds Test-IcingaStateFile and Repair-IcingaStateFile, which is integrated into Test-IcingaAgent, to ensure the Icinga Agent state file is healthy and not corrupt, causing the Icinga Agent to fail on start
• #534 Improves Icinga and Director configuration generator, by wrapping PowerShell arrays inside @() instead of simply writing them comma separated
• #536 Adds new function Test-IcingaArrayFilter for easier include and exclude filtering during plugin runtime and to allow filtering of array content for intended values only
• #560 Improves handling for Icinga Management Console which will now terminate itself during full uninstallation and restarts after updating the Icinga PowerShell Framework, to apply changes directly
• #569 Adds -Include and -Exclude filter for EventLog CLI parser, to only contain certain messages or exclude them from the output