Requirements:
* Windows Vista/Server 2008 or higher
-* [Microsoft .NET Framework 2.0](http://www.microsoft.com/de-de/download/details.aspx?id=1639)
+* [Microsoft .NET Framework 2.0](http://www.microsoft.com/de-de/download/details.aspx?id=1639)
-The installer package includes the [NSClient++](http://www.nsclient.org/) so that Icinga 2 can
-use its built-in plugins. You can find more details in [this chapter](6-distributed-monitoring.md#distributed-monitoring-windows-nscp).
+The installer package includes the [NSClient++](http://www.nsclient.org/) package
+so that Icinga 2 can use its built-in plugins. You can find more details in
+[this chapter](6-distributed-monitoring.md#distributed-monitoring-windows-nscp).
The Windows package also installs native [monitoring plugin binaries](6-distributed-monitoring.md#distributed-monitoring-windows-plugins)
to get you started more easily.
+#### <a id="distributed-monitoring-setup-client-windows-start"></a> Windows Client Setup Start
+
+Run the MSI-Installer package and follow the instructions shown in the screenshots.
+
+#### <a id="distributed-monitoring-setup-client-windows-nsclient"></a> Bundled NSClient++ Setup
+
If you have chosen to install/update the NSClient++ package, the Icinga 2 setup wizard will ask
you to do so.
-
+
+
+Choose the `Generic` setup.
+
+
+
+Choose the `Custom` setup type.
+
+
+
+NSClient++ does not install a sample configuration by default. Change this as shown in the screenshot.
+
+
+
+Generate a secure password and enable the web server module. **Note**: The webserver module is
+available starting with NSClient++ 0.5.0. Icinga 2 v2.6+ including this version is required.
+
+
+
+Finish the installation.
+
+
+
+Open a web browser and navigate to `https://localhost:8443`. Enter the password you've configured
+during the setup. In case you lost it, look into the `C:\Program Files\NSClient++\nsclient.ini`
+configuration file.
+
+
+
+The NSClient++ REST API can be used to query metrics. Future Icinga 2 versions will add
+more integrations. Additional details can be found in this [blog post](https://www.icinga.com/2016/09/16/nsclient-0-5-0-rest-api-and-icinga-2-integration/).
+
+#### <a id="distributed-monitoring-setup-client-windows-finish"></a> Finish Windows Client Setup
Finish the setup wizard.
The configuration files can be modified with your favorite editor.
-To validate the configuration on Windows open a terminal and enter the following command:
+In order to use the [top down](6-distributed-monitoring.md#distributed-monitoring-top-down) client
+configuration prepare the following steps.
- C:> icinga2.exe daemon -C
+Add a [global zone](6-distributed-monitoring.md#distributed-monitoring-global-zone-config-sync)
+for syncing check commands later. Navigate to `C:\ProgramData\icinga2\etc\icinga2` and open
+the `zones.conf` file in your preferred editor. Add the following lines if not existing already:
+
+ object Zone "global-templates" {
+ global = true
+ }
+
+You don't need any local configuration on the client except for
+CheckCommand definitions which can be synced using the global zone
+above. Therefore disable the inclusion of the `conf.d` directory
+in the `icinga2.conf` file.
+Navigate to `C:\ProgramData\icinga2\etc\icinga2` and open
+the `icinga2.conf` file in your preferred editor. Remove or comment (`//`)
+the following line:
+
+ // Commented out, not required on a client with top down mode
+ //include_recursive "conf.d"
+
+Validate the configuration on Windows open an administrator terminal
+and run the following command:
+
+ C:\WINDOWS\system32>cd "C:\Program Files\ICINGA2\sbin"
+ C:\Program Files\ICINGA2\sbin>icinga2.exe daemon -C
**Note**: You have to run this command in a shell with `administrator` privileges.
-In case you want to restart the Icinga 2 service, run `services.msc` and restart the
-`icinga2` service. Alternatively, you can use the `net {start,stop}` CLI commands.
+Now you need to restart the Icinga 2 service. Run `services.msc` from the start menu
+and restart the `icinga2` service. Alternatively, you can use the `net {start,stop}` CLI commands.
Now that you've successfully installed a satellite/client, please proceed to
-the [configuration modes](6-distributed-monitoring.md#distributed-monitoring-configuration-modes).
+the [detailed configuration modes](6-distributed-monitoring.md#distributed-monitoring-configuration-modes).
+
+
## <a id="distributed-monitoring-configuration-modes"></a> Configuration Modes
projects / icinga2 / commitdiff
