icinga-powershell-framework/doc/10-InstallService.md

Run the PowerShell Module as Windows Service

Requirements

As PowerShell Scripts / Modules can not be installed directly as Windows Service, we will require a little assistance here.

In order to make this work, you will require the Icinga Windows Service which can be downloaded directly from the GitHub Repository.

Install the Service

At first you will require the Service Binary from the Icinga Windows Service GitHub Repository and copy the binary locally to your system. A recommended path would be your Program Files / Program Files (x86) directory.

Any other custom location is fully supported, has to be however accessable from the Windows Service Environment.

Once you have found a location, the PowerShell Module will assist you with setting up the service itself. In this documentation we will assume the path you have chosen to copy the binary to is

    C:\Program Files\Icinga Windows Service

and the binary name is

    icinga-service.exe

Now lets install the service with the help of the PowerShell Module:

    Install-Icinga-Service -IcingaServicePath 'C:\Program Files\Icinga Windows Service\icinga-service.exe'

You can validate if the service has been installed properly by using the Get Service Cmdlet:

    Get-Icinga-Service

Of course there are more Cmdlets available, making the management of this Icinga Service alot easier, which should be self explaining:

• Start-Icinga-Service
• Stop-Icinga-Service
• Restart-Icinga-Service
• Uninstall-Icinga-Service

Note: If you run the PowerShell Module as service, both the Daemon and Checker component will be started. To prevent external access to the Daemon, you should ensure to block port 5891 on this host.