Forge Home

Modules

Puppet

Resources

PuppetEcosystemPuppet CommunityUpdates

nsclient

Installs the NSClient on windows servers to be able to interact with Nagios and Icinga
Project URLRSS FeedReport issues

28,434 downloads

193 latest version

4.7 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 3.0.0 (latest)
  • 2.1.0
  • 2.0.1
  • 2.0.0
  • 1.4.0
  • 1.3.1
released Mar 17th 2024
This version is compatible with:
  • Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
  • Puppet >= 7.0.0 < 9.0.0

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppet-nsclient', '3.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-nsclient
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-nsclient --version 3.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download
Tags: nagios, monitoring, windows, nsclient

Documentation

puppet/nsclient — version 3.0.0 Mar 17th 2024

puppet-nsclient

####Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with nsclient
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

##Overview

This is a module that will manage and install the NSClient on Windows servers from the official NSClient site.

Build Status

##Module Description Module that will install the NSClient on windows servers to be able to interact with Nagios and Icinga. It will also manage the list of hosts that the server can communicate with.

##Setup

###What nsclient affects

  • Installs a new package
  • Creates a new windows service

###Beginning with nsclient

Usage

To install nsclient with defaults:

include 'nsclient'

To install a different version:

class { 'nsclient':
  package_source_location => 'http://myhost.com',
  package_name            => 'NSClient++ (Win32)'
  package_source          => '0.3.1.msi'
}

In order to configure the nagios hosts to communicate with:

class { 'nsclient':
  allowed_hosts => ['10.21.0.0/22','10.21.4.0/22'],
}

in order to use proxy for downloading the package

class { 'nsclient':
  proxy_url => 'http://proxy.domain.local:8080',
}

##Usage

###Classes and Defined Types

####Class: nsclient One of the primary classes of the nsclient module. This class will install the nsclient binaries

Parameters within nsclient: #####allowed_hosts Array of hosts that your client can communicate with. You can use netmasks (/ syntax) or * to create ranges.

#####service_state Whether you want to nsclient service to start up. Defaults to running

#####service_enable Whether you want to nsclient service to start up at boot. Defaults to true

#####package_source_location This is the default site to download your package from (e.g. http://files.nsclient.org/stable)

#####package_source This is the source name of the package to be downloaded

#####package_name This is name of the package to download (e.g. NSCP-0.4.1.101-x64.msi)

#####download_destination This is the folder to where we need to download the NSCP Installer. Package cannot take a remote file source Because of Windows, we need to set this to be a top level directory (e.g. c:\temp) or we would need to recursively check the file path.

#####config_template This is the template to use as the config file.

#####proxy_url Specify a proxy url if needed for downloading the package

#####password Password used to authenticate against server

##Reference

###Classes ####Public Classes

  • nsclient: Guides the basic installation of the nsclient application

####Private Classes

  • [nsclient::config] Manages all the default configuration of the nsclient application
  • [nsclient::install] Manages the installation of the nsclient
  • [nsclient::service] Manages the nclient service

##Limitations

This module is tested on the following platforms:

  • Windows 2008 R2

It is tested with the OSS version of Puppet only.

##Development

###Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.