Forge Home

stackify

Installs stackify APM agent

7,658 downloads

5,012 latest version

5.0 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

  • 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

Start using this module

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

Add this module to your Puppetfile:

mod 'puppet-stackify', '0.1.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

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

Manually install this module globally with Puppet module tool:

puppet module install puppet-stackify --version 0.1.3

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

Documentation

puppet/stackify — version 0.1.3 Oct 19th 2018

stackify

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

Description

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

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.

Usage

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,
}

Reference

Classes

Parameters are optional unless otherwise noted.

stackify

Installs, configures, and manages the stackify agent.

package_ensure

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

Default: 'present'.

package_install_options_environment

Required.

Sets the stackify environment for this node.

package_install_options_activationkey

Required.

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

file_download_directory

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

Default: 'C:\Temp'.

service_manage

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

Default: true.

service_ensure

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

Default: true.

service_enable

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

Default: true.

Limitations

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

Development

Contributing

  1. Fork it ( https://github.com/voxpupuli/puppet-stackify/fork )
  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