Forge Home

appd_db_agent

Puppet AppDynamics Database Agent Module

8,031 downloads

5,134 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.3.1 (latest)
  • 0.3.0
  • 0.2.0
  • 0.1.1
released Oct 17th 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-appd_db_agent', '0.3.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

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

Manually install this module globally with Puppet module tool:

puppet module install puppet-appd_db_agent --version 0.3.1

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/appd_db_agent — version 0.3.1 Oct 17th 2018

puppet/appd_db_agent

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

Table of Contents

  1. Description
  2. Setup - The basics of getting started with appd_db_agent
  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

This module installs, configures and provides a systemd based service for the AppDynamics Database Agent. It has been developed and tested with dbagent version 4.4.1.229 on CentOS 7 with Puppet 4.10. It should also work on Puppet 5 and on other RedHat Enterprise 7 clones.

Configuration is all done via the systemd service and environment file it loads from /etc/sysconfig/appd_db_agent. No changes are made to controller-info.xml.

Setup

What appd_db_agent affects

The module downloads and installs the database agent under /opt/appdynamics. It creates a systemd unit file for the agent and starts the service.

The agent depends on java being installed and this module will install by including puppetlabs/java.

Setup Requirements

AppDynamics doesn't provide an anonymous download link for the agent. You will have to provide the dbagent zip yourself. You have several choices for hosting it yourself. You could make it available over http via an artifact repository such as Artifactory or Nexus. Or you could make it available using your puppetserver's fileserver by placing the zip in your site module and specifying a puppet:/// url as the source parameter.

If using an onsite AppDynamics controller, you will have to install the required license on your controller before the agent will work.

Beginning with appd_db_agent

The module has a single public class. There are several optional parameters, but 5 that are required. You will need to know

  • The source for the dbagent zip file. This can be any source the puppet/archive module supports such as a https URL, a local file, or a puppet:/// URL.
  • The version of the dbagent you're installing. This isn't automatically extracted from the source URL. It should be the complete version number eg 4.4.1.2.
  • The controller host name. The module should work with local and hosted AppDynamics controllers.
  • The controller port number. If using the hosted service, this will be 443.
  • The password to use as the Agent Account Access Key.

You should also consider how much heap space to allocate to the JVM running the agent. This module defaults the parameter java_heap_size to just 256MB. AppDynamic's recommend 1GB + 512MB for each monitored database.

Usage

A minimal example where the agent zip is stored in a site module and a locally installed controller is used.

class { 'appd_db_agent':
  source                   => 'puppet:///modules/site/appdynamics/dbagent-4.4.1.229.zip',
  version                  => '4.4.1.229',
  controller_host_name     => 'appdynamics.example.com',
  controller_port          => 8090,
  agent_account_access_key => 'secret',
}

A more complete example using Artifactory as the source for the zip. Communications with the hosted SAAS is encrypted and via a squid proxy.

class { 'appd_db_agent':
  source                   => 'https://artifactory.example.com/artifactory/infra/org/appdynamics/dbagent/dbagent-4.4.1.229.zip',
  checksum                 => artifactory_sha1('https://artifactory.example.com/artifactory/api/storage/infra/org/appdynamics/dbagent/dbagent-4.4.1.229.zip'),
  checksum_type            => 'sha1',
  version                  => '4.4.1.229',
  controller_host_name     => 'exampleorg.saas.appdynamics.com',
  controller_port          => 443,
  controller_ssl_enabled   => true,
  agent_account_access_key => 'secret',
  proxy_host               => 'squid.example.com',
  proxy_port               => 3128,
  java_heap_size           => '4g',
}

Reference

Puppet Strings REFERENCE.md

Limitations

  • Tested on CentOS 7
  • Puppet 4.10 or greater.

Development

This module is maintained by Vox Pupuli. It was written by Alex Fisher and is licensed under the Apache-2.0 License.