appdynamics

Install and configure appdynamics (https://www.appdynamics.com/)

Module Stats

7,989 downloads

6,901 latest version

4.3 quality score

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

released Feb 6th 2017

This version is compatible with:

Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
Puppet >= 3.0.0 < 5.0.0
, , ,

Start using this module

Installation method

Add this module to your Puppetfile:

mod 'kinneygroup-appdynamics', '1.0.0'

Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add kinneygroup-appdynamics

Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install kinneygroup-appdynamics --version 1.0.0

Tags: monitoring, appdynamics

Documentation

kinneygroup/appdynamics — version 1.0.0 Feb 6th 2017

appdynamics

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

Description

AppDynamics (https://www.appdynamics.com/) is a solution that provides insight into application performance through application flow maps and transaction monitoring.

Setup

Requirements

AppDynamics controller installer (https://download.appdynamics.com/download/)
AppDynamics HA Toolkit .tar.gz (https://github.com/Appdynamics/HA-toolkit/releases).
A valid AppDynamics license
Port 8090 must be opened on the host firewall to access the web interface

Installation

puppet module install kinneygroup-appdynamics

The controller installer downloaded from AppDynamics The controller_install_package variable must match the file name.
Add the license provided by AppDynamics to the "files" directory in the puppet module. The license file name must be license.lic

Beginning with appdynamics

To perform a basic appdynamics installation, declare the appdynamics class.

include appdynamics

Usage

Basic install

class { 'appdynamics':
  password                => 'pa55word',
  controller_install_path => '/opt/appdynamics/controller.sh',
  ha_toolkit_path         => '/opt/appdynamics/ha-toolkit.tar.gz',
  license_path            => '/opt/appdynamics/license.lic'
}

Basic install using hiera

appdynamics::password: 'pa55word'
appdynamics::controller_install_path: '/opt/appdynamics/controller.sh'
appdynamics::ha_toolkit_path: '/opt/appdynamics/ha-toolkit.tar.gz'
appdynamics::license_path: '/opt/appdynamics/license.lic'

Reference

The appdynamics module comes with a number of options to interface with appdynamics.

Classes:

appdynamics: The main class

###Parameters

`controller_install_path`

The path of the controller install package. Valid options: String. Default: '/tmp/controller.sh'.

`ha_toolkit_path`

The path of the HA toolkit .tar.gz. Valid options: String. Default: '/tmp/HA-toolkit.tar.gz'.

`license_path`

The path of the license file. Valid options: String. Default: '/tmp/license.lic'.

`controller_config`

The performance profile type for the instance. Valid options: String. Default: 'demo'.

`iio_port`

The application server's IIOP port. This port is used for internal system communication. Valid options: String. Default: '3700'.

`server_port`

The primary HTTP port for the application server. Valid options: Integer. Default: '8090'.

`server_hostname`

Server host name or IP address that AppDynamics agents and the AppDynamics UI use to connect to the Controller. Valid options: String. Default: '$::fqdn'.

`ha_controller_type`

The high availability mode for this instance. Valid options: 'notapplicable, primary, secondary' String. Default: 'notapplicable'.

`controller_tenancy_mode`

The tenancy mode. Valid options: String. Default: 'single'.

`admin_port`

The application server's administration port. Valid options: Integer. Default: '4848'.

`language`

The language identifier for the system. Valid options: String. Default: 'en'.

`jms_port`

The application server's JMS port. Valid options: Integer. Default: '7676'.

`install_dir`

The controller installatino path. Valid options: String. Default: '/home/appduser/AppDynamics/Controller'.

`mysql_root_password`

The password of the user account that the Controller uses to access its MySQL database. Valid options: String. Default: 'changeme'.

`database_port`

The port for the Controller database. Valid options: Integer. Default: '3388'.

`username`

The username of the administrator account in the Controller UI. Valid options: String. Default: 'admin'.

`password`

The admin user password. Valid options: String. Default: 'changeme'.

`ssl_port`

The secure HTTP port for the application server. Valid options: Integer. Default: '8181'.

`real_datadir`

The path to the Controller's data directory. Valid options: String. Default: '/home/appduser/AppDynamics/Controller/db/data'.

`elasticsearch_datadir`

The path to the Elastic Search file store. Valid options: String. Default: '/home/appduser/AppDynamics/Controller/events_service/analytics-processor'.

`root_user_password`

The Controller root user password. The root user is a Controller user account with privileges for accessing the system Administration Console. Valid options: String. Default: 'pa55word2'.

`reporting_service_http_port`

The reporting service HTTP port. This port is used for internal system communication. Valid options: Integer. Default: '8020'.

`reporting_service_https_port`

The reporting service HTTPS port. This port is used for internal system communication. Valid options: Integer. Default: '8021'.

`elasticsearch_port`

The port on which the Elastic Search process listens. This port is used for internal system communication. Valid options: Integer. Default: '9200'.

`install_timeout`

The controller installation timeout determines the amount of time to wait for the installation to complete before timing out. Valid options: Integer. Default '900'

`exec_path`

The system executable path. Valid options: String. Default '/bin:/usr/bin:/sbin:/usr/sbin'

`manage_libaio`

Appdynamics requires the libaio package to be installed on the system, this setting determines whether this module should manage the installation of the gcc package or to allow another module to manage it. This setting helps to avoid duplicate resource declarations. Valid options: boolean. Default: 'true'.

`manage_gcc`

Appdynamics requires the gcc package to be installed on the system, this setting determines whether this module should manage the installation of the gcc package or to allow another module to manage it. This setting helps to avoid duplicate resource declarations. Valid options: boolean. Default: 'true'.

Limitations

Currently, the appdynamics module is tested on the following operating systems:

CentOS 7

The module currently does not support an automated HA or Multitenant deployment.

Development

Contributions to the module are welcome and appreciated. The following guidelines are required for any code to be merged.

All code must have corresponding rspec tests where possible.
Any additional variables or classes that are added must be documented in the readme.
All TravisCI tests must pass.

Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

    "License" shall mean the terms and conditions for use, reproduction, and
    distribution as defined by Sections 1 through 9 of this document.

    "Licensor" shall mean the copyright owner or entity authorized by the
    copyright owner that is granting the License.

    "Legal Entity" shall mean the union of the acting entity and all other
    entities that control, are controlled by, or are under common control with
    that entity. For the purposes of this definition, "control" means (i) the
    power, direct or indirect, to cause the direction or management of such
    entity, whether by contract or otherwise, or (ii) ownership of
    fifty percent (50%) or more of the outstanding shares, or (iii) beneficial
    ownership of such entity.

    "You" (or "Your") shall mean an individual or Legal Entity exercising
    permissions granted by this License.

    "Source" form shall mean the preferred form for making modifications,
    including but not limited to software source code, documentation source,
    and configuration files.

    "Object" form shall mean any form resulting from mechanical transformation
    or translation of a Source form, including but not limited to compiled
    object code, generated documentation, and conversions to
    other media types.

    "Work" shall mean the work of authorship, whether in Source or Object
    form, made available under the License, as indicated by a copyright notice
    that is included in or attached to the work (an example is provided in the
    Appendix below).

    "Derivative Works" shall mean any work, whether in Source or Object form,
    that is based on (or derived from) the Work and for which the editorial
    revisions, annotations, elaborations, or other modifications represent,
    as a whole, an original work of authorship. For the purposes of this
    License, Derivative Works shall not include works that remain separable
    from, or merely link (or bind by name) to the interfaces of, the Work and
    Derivative Works thereof.

    "Contribution" shall mean any work of authorship, including the original
    version of the Work and any modifications or additions to that Work or
    Derivative Works thereof, that is intentionally submitted to Licensor for
    inclusion in the Work by the copyright owner or by an individual or
    Legal Entity authorized to submit on behalf of the copyright owner.
    For the purposes of this definition, "submitted" means any form of
    electronic, verbal, or written communication sent to the Licensor or its
    representatives, including but not limited to communication on electronic
    mailing lists, source code control systems, and issue tracking systems
    that are managed by, or on behalf of, the Licensor for the purpose of
    discussing and improving the Work, but excluding communication that is
    conspicuously marked or otherwise designated in writing by the copyright
    owner as "Not a Contribution."

    "Contributor" shall mean Licensor and any individual or Legal Entity on
    behalf of whom a Contribution has been received by Licensor and
    subsequently incorporated within the Work.

2. Grant of Copyright License.

    Subject to the terms and conditions of this License, each Contributor
    hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
    royalty-free, irrevocable copyright license to reproduce, prepare
    Derivative Works of, publicly display, publicly perform, sublicense,
    and distribute the Work and such Derivative Works in
    Source or Object form.

3. Grant of Patent License.

    Subject to the terms and conditions of this License, each Contributor
    hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
    royalty-free, irrevocable (except as stated in this section) patent
    license to make, have made, use, offer to sell, sell, import, and
    otherwise transfer the Work, where such license applies only to those
    patent claims licensable by such Contributor that are necessarily
    infringed by their Contribution(s) alone or by combination of their
    Contribution(s) with the Work to which such Contribution(s) was submitted.
    If You institute patent litigation against any entity (including a
    cross-claim or counterclaim in a lawsuit) alleging that the Work or a
    Contribution incorporated within the Work constitutes direct or
    contributory patent infringement, then any patent licenses granted to
    You under this License for that Work shall terminate as of the date such
    litigation is filed.

4. Redistribution.

    You may reproduce and distribute copies of the Work or Derivative Works
    thereof in any medium, with or without modifications, and in Source or
    Object form, provided that You meet the following conditions:

    1. You must give any other recipients of the Work or Derivative Works a
    copy of this License; and

    2. You must cause any modified files to carry prominent notices stating
    that You changed the files; and

    3. You must retain, in the Source form of any Derivative Works that You
    distribute, all copyright, patent, trademark, and attribution notices from
    the Source form of the Work, excluding those notices that do not pertain
    to any part of the Derivative Works; and

    4. If the Work includes a "NOTICE" text file as part of its distribution,
    then any Derivative Works that You distribute must include a readable copy
    of the attribution notices contained within such NOTICE file, excluding
    those notices that do not pertain to any part of the Derivative Works,
    in at least one of the following places: within a NOTICE text file
    distributed as part of the Derivative Works; within the Source form or
    documentation, if provided along with the Derivative Works; or, within a
    display generated by the Derivative Works, if and wherever such
    third-party notices normally appear. The contents of the NOTICE file are
    for informational purposes only and do not modify the License.
    You may add Your own attribution notices within Derivative Works that You
    distribute, alongside or as an addendum to the NOTICE text from the Work,
    provided that such additional attribution notices cannot be construed
    as modifying the License.

    You may add Your own copyright statement to Your modifications and may
    provide additional or different license terms and conditions for use,
    reproduction, or distribution of Your modifications, or for any such
    Derivative Works as a whole, provided Your use, reproduction, and
    distribution of the Work otherwise complies with the conditions
    stated in this License.

5. Submission of Contributions.

    Unless You explicitly state otherwise, any Contribution intentionally
    submitted for inclusion in the Work by You to the Licensor shall be under
    the terms and conditions of this License, without any additional
    terms or conditions. Notwithstanding the above, nothing herein shall
    supersede or modify the terms of any separate license agreement you may
    have executed with Licensor regarding such Contributions.

6. Trademarks.

    This License does not grant permission to use the trade names, trademarks,
    service marks, or product names of the Licensor, except as required for
    reasonable and customary use in describing the origin of the Work and
    reproducing the content of the NOTICE file.

7. Disclaimer of Warranty.

    Unless required by applicable law or agreed to in writing, Licensor
    provides the Work (and each Contributor provides its Contributions)
    on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    either express or implied, including, without limitation, any warranties
    or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS
    FOR A PARTICULAR PURPOSE. You are solely responsible for determining the
    appropriateness of using or redistributing the Work and assume any risks
    associated with Your exercise of permissions under this License.

8. Limitation of Liability.

    In no event and under no legal theory, whether in tort
    (including negligence), contract, or otherwise, unless required by
    applicable law (such as deliberate and grossly negligent acts) or agreed
    to in writing, shall any Contributor be liable to You for damages,
    including any direct, indirect, special, incidental, or consequential
    damages of any character arising as a result of this License or out of
    the use or inability to use the Work (including but not limited to damages
    for loss of goodwill, work stoppage, computer failure or malfunction,
    or any and all other commercial damages or losses), even if such
    Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability.

    While redistributing the Work or Derivative Works thereof, You may choose
    to offer, and charge a fee for, acceptance of support, warranty,
    indemnity, or other liability obligations and/or rights consistent with
    this License. However, in accepting such obligations, You may act only
    on Your own behalf and on Your sole responsibility, not on behalf of any
    other Contributor, and only if You agree to indemnify, defend, and hold
    each Contributor harmless for any liability incurred by, or claims
    asserted against, such Contributor by reason of your accepting any such
    warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work

    To apply the Apache License to your work, attach the following boilerplate
    notice, with the fields enclosed by brackets "[]" replaced with your own
    identifying information. (Don't include the brackets!) The text should be
    enclosed in the appropriate comment syntax for the file format. We also
    recommend that a file or class name and description of purpose be included
    on the same "printed page" as the copyright notice for easier
    identification within third-party archives.

        Copyright 2016 Kinney Group

        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
        or implied. See the License for the specific language governing
        permissions and limitations under the License.

Modules

Discover

Contribute

Puppet

Premium features

Downloads

Resources

About Forge

Getting Started

appdynamics

Support the Puppet Community by contributing to this module

Version information

This version is compatible with:

Start using this module

Documentation

appdynamics

Table of Contents

Description

Setup

Requirements

Installation

Beginning with appdynamics

Usage

Basic install

Basic install using hiera

Reference

controller_install_path

ha_toolkit_path

license_path

controller_config

iio_port

server_port

server_hostname

ha_controller_type

controller_tenancy_mode

admin_port

language

jms_port

install_dir

mysql_root_password

database_port

username

password

ssl_port

real_datadir

elasticsearch_datadir

root_user_password

reporting_service_http_port

reporting_service_https_port

elasticsearch_port

install_timeout

exec_path

manage_libaio

manage_gcc

Limitations

Development

1.0.0 (2017-02-06)

Summary

Features

Bugfixes

Dependencies

`controller_install_path`

`ha_toolkit_path`

`license_path`

`controller_config`

`iio_port`

`server_port`

`server_hostname`

`ha_controller_type`

`controller_tenancy_mode`

`admin_port`

`language`

`jms_port`

`install_dir`

`mysql_root_password`

`database_port`

`username`

`password`

`ssl_port`

`real_datadir`

`elasticsearch_datadir`

`root_user_password`

`reporting_service_http_port`

`reporting_service_https_port`

`elasticsearch_port`

`install_timeout`

`exec_path`

`manage_libaio`

`manage_gcc`