upstream/icinga-powershell-framework
1
0
Fork 0
mirror of https://github.com/Icinga/icinga-powershell-framework.git synced 2026-02-03 04:09:29 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #697 from Icinga:doc/ikwb_scom_uninstall

Browse source 
Docs: Adds IWKB entry `IWKB000017` handling issues with failed checks once SCOM is uninstalled

Adds IWKB entry `IWKB000017` handling issues with failed checks once SCOM is uninstalled as example
This commit is contained in:
Lord Hepipud 2024-03-19 10:53:12 +01:00 committed by GitHub
commit 7a8a138dce
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 27 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
doc/100-General/10-Changelog.md
View file

@ -23,6 +23,7 @@ Released closed milestones can be found on [GitHub](https://github.com/Icinga/ic
### Enhancements
* [#313](https://github.com/Icinga/icinga-powershell-framework/issues/313) Adds IWKB entry `IWKB000017` handling issues with failed checks once SCOM is uninstalled as example
* [#587](https://github.com/Icinga/icinga-powershell-framework/issues/587) Adds support to create own snapshot repositories with `New-IcingaRepository`
* [#631](https://github.com/Icinga/icinga-powershell-framework/pull/631) Deduplicates `-C try { Use-Icinga ...` boilerplate by adding it to the `PowerShell Base` template and removing it from every single command
* [#669](https://github.com/Icinga/icinga-powershell-framework/pull/669) Adds new metric to the CPU provider, allowing for distinguishing between the average total load as well as the sum of it

1
doc/300-Knowledge-Base.md
View file

@ -24,3 +24,4 @@ For this reason you will find a list of Icinga knowledge base entries below. Ent
| [IWKB000014](knowledgebase/IWKB000014.md) | Installing or Updating Icinga for Windows causes error messages regarding `framework_cache.psm1` errors |
| [IWKB000015](knowledgebase/IWKB000015.md) | Got JSON, but not an object, from IfW API on host 'localhost' port '5668': "Exception while calling \\"Fill\\" with 1 arguments: \\"Invalid syntax near \\"`<Argument>:`\\".\\"" |
| [IWKB000016](knowledgebase/IWKB000016.md) | Checks using Performance Counter fail with various messages like `Exception of type 'System.OutOfMemoryException' was thrown` or `Icinga Invalid Configuration Error was thrown: PerfCounterCategoryMissing: Category "Memory" not found` |
| [IWKB000017](knowledgebase/IWKB000017.md) | Icinga throws exception during plugin execution after uninstalling SCOM or other vendor software using PowerShell modules |

25
doc/knowledgebase/IWKB000017.md Normal file
View file

@ -0,0 +1,25 @@
# Icinga Knowledge Base - IWKB000017
## Short Message
Icinga throws exception during plugin execution after uninstalling SCOM or other vendor software using PowerShell modules
## Example Exception
Icinga throws the exception
`The Icinga PowerShell Framework is either not installed on the system or not configured properly. Please check https://icinga.com/docs/windows for further details`
once a plugin is executed from the Icinga Agent after SCOM is uninstalled as example.
## Reason
In some cases uninstalling certain software components which also ship PowerShell modules, like the Microsoft SCOM, Icinga for Windows will stop working. The Icinga Agent will assume that the PowerShell Framework is no longer installed as it cannot find the module afterwards.
## Solution
The simple solution is to restart the Icinga Agent service which will resolve this issue and reload the environment variables. Afterwards the checks will work as before.
```powershell
Restart-Icinga
````