Installs stackify APM agent

Vox Pupuli



3,854 latest version

5.0 quality score

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.1
released Oct 19th 2018
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • windows

Start using this module


puppet/stackify — version 0.1.3 Oct 19th 2018


License Build Status Puppet Forge Puppet Forge - downloads Puppet Forge - scores

Table of Contents

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


The stackify module installs and manages the stackify agent and service on Windows systems.

Stackify is an APM tools that uses an agent on nodes that need to be monitored.


Setup Requirements

The stackify module requires the following:

  • Puppet Agent 4.7.1 or later.
  • Access to the internet.
  • Stackify account setup and a license/activation key in hand.
  • Windows Server 2012/2012R2/2016.

Beginning with stackify

To get started with the stackify module simply include the following in your manifest:

class { 'stackify':
    package_ensure                        => 'present',
    package_install_options_environment   => 'development',
    package_install_options_activationkey => 'XXXXXXXXXXXXXXXXXXXXXXXXXX',

This example downloads and installs the latest version of the stackify agent and ensures the stackify services are running and in the desired state. After running this you should see your node pop up in the stackify servers list from the web ui.

A more advanced configuration including all attributes available:

class { 'stackify':
   package_ensure                        => 'present',
   package_install_options_environment   => 'development',
   package_install_options_activationkey => 'XXXXXXXXXXXXXXXXXXXXXXXXXX',
   file_download_directory               => 'C:\\Temp',
   service_manage                        => true,
   service_ensure                        => true,
   service_enable                        => true,

The above is just an example of the flexibility you have with this module. You will generally never need to specify every or even so many parameters as shown.


Install Stackify only

Sometimes you might want to install the stackify agent but not manage the service.

class { 'stackify':
    package_ensure                        => 'present',
    package_install_options_environment   => 'development',
    package_install_options_activationkey => 'XXXXXXXXXXXXXXXXXXXXXXXXXX',
    service_manage                        => false,



Parameters are optional unless otherwise noted.


Installs, configures, and manages the stackify agent.


Specifies whether the stackify package resource should be present. Valid options: 'present' and 'absent'.

Default: 'present'.



Sets the stackify environment for this node.



Your stackify license/activation key so the node can be associated with your stackify account.


Specifies which directory to store the downloaded stackify agent installer in.

Default: 'C:\Temp'.


Specifies whether or not to manage the desired state of the stackify windows services.

Default: true.


Whether or not the stackify services should be running or stopped. Valid options: true, false

Default: true.


Whether or not the stackify services should be enabled at boot or disabled. Valid options: true, false

Default: true.


This module is only available for Windows 2012 or 2012 R2 and works with Puppet 4.0 and later.



  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request