Update Windows setup wizard screenshots; add NSClient++ 0.5.0 setup
fixes #13443
Michael Friedrich
|
|
@ -418,14 +418,19 @@ Download the MSI-Installer package from [http://packages.icinga.org/windows/](ht
|
|||
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.
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -471,10 +476,44 @@ The next step allows you to verify the CA presented by the master.
|
|||
|
||||
|
||||
|
||||
#### <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.
|
||||
|
||||
|
|
@ -491,19 +530,45 @@ If you click `Examine Config` in the setup wizard, it will open a new Explorer w
|
|||
|
||||
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
|
||||
|
||||
|
|
|
|||
|
Before Width: | Height: | Size: 273 KiB After Width: | Height: | Size: 71 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 22 KiB |
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 28 KiB |
|
Before Width: | Height: | Size: 21 KiB After Width: | Height: | Size: 23 KiB |
|
Before Width: | Height: | Size: 67 KiB After Width: | Height: | Size: 67 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 32 KiB |