Version information
This module has been deprecated by its author since Sep 28th 2017.
The reason given was: This module has been moved to the care of Vox Pupuli where it is now being maintained and updated.
The author has suggested puppet-splunk as its replacement.
Start using this module
Documentation
Overview
This module provides a method to deploy Splunk Server or Splunk Universal Forwarder with common configurations and ensure the services maintain a running state.
This module does not configure firewall rules. Firewall rules will need to be configured separately in order to allow for correct operation of Splunk and the Splunk Universal Forwarder. Additionally, this module does not supply Splunk or Splunk Universal Forwarder installation media. Installation media will need to be aquired seperately, and the module configured to use it.
Installation & Setup
To begin using this module, use the Puppet Module Tool (PMT) from the command line to install this module:
puppet module install puppetlabs-splunk
This will place the module into your primary module path if you do not utilize the --target-dir directive.
Once the module is in place, there is just a little setup needed.
First, you will need to place your downloaded splunk installers into the files
directory, <module_path>/splunk/files/
. The files must be placed according to
directory structure example given below.
The expected directory structure is:
`-- files
|-- splunk
| `-- $platform
| `-- splunk-${version}-${build}-${additl}
`-- universalforwarder
`-- $platform
`-- splunkforwarder-${version}-${build}-${additl}
A semi-populated example files directory might then contain:
`-- files
|-- splunk
| `-- linux
| |-- splunk-4.3.2-123586-linux-2.6-amd64.deb
| |-- splunk-4.3.2-123586-linux-2.6-intel.deb
| `-- splunk-4.3.2-123586-linux-2.6-x86_64.rpm
`-- universalforwarder
|-- linux
| |-- splunkforwarder-4.3.2-123586-linux-2.6-amd64.deb
| |-- splunkforwarder-4.3.2-123586-linux-2.6-intel.deb
| `-- splunkforwarder-4.3.2-123586-linux-2.6-x86_64.rpm
|-- solaris
| `-- splunkforwarder-4.3.2-123586-solaris-9-intel.pkg
`-- windows
|-- splunkforwarder-4.3.2-123586-x64-release.msi
`-- splunkforwarder-4.3.2-123586-x86-release.msi
Second, you will need to supply the splunk::params
class with three critical
pieces of information.
- The version of Splunk you are using
- The build of Splunk you are using
- The root URL to use to retrieve the packages
In the example given above, the version is 4.3.2, the build is 123586, and the root URL is puppet:///modules/splunk. See the splunk::params class documentation for more information.
Types in this module release
##2015-09-08 - Release 3.2.1
Summary
This release fixes compatibility issues with Puppet 4 and the future parser.
Fixed
- (MODULES-2448) Collectors with arrays do not work well with Puppet 4 and the future parser
2015-07-17 - Release 3.2.0
Summary
This release adds the ability to install from package repos, add authentication for forwarders, and customize forwarder inputs & outputs.
Added
- Class
splunk::password
for managing passwords - Class
splunk
pkg_provider attribute for using apt/yum repos. - Define
splunk::forwarder
parameters for customizing the inputs/outputs
2014-12-22 - Release 3.1.1
Summary
This release fixes a bad checksum for the metadata.json file and also cleans up some lint errors. It also adds missing parameters in params.pp
for Solaris sparc.
2014-08-06 - Release 3.1.0
Summary
For a current list of features please see the README.
Dependencies
- puppetlabs-stdlib (>= 2.4.0 < 5.0.0)
- puppetlabs-inifile (>= 1.0.0 < 2.0.0)
- nanliu-staging (>= 0.3.1)