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](https://github.com/LordHepipud/icinga-windows-service).

Install the Service
--------------

At first you will require the Service Binary from the [Icinga Windows Service GitHub Repository](https://github.com/LordHepipud/icinga-windows-service) 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:

```powershell
    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.