Skip to content

Dynatrace/Dynatrace-AppMon-Server-Ansible

Repository files navigation

Dynatrace-AppMon-Server-Ansible

This Ansible role installs and configures the Dynatrace AppMon Server of the Dynatrace AppMon solution.

Download

The role is available via:

Description

This role downloads and installs the most recent version of the Dynatrace AppMon Server from http://downloads.dynatracesaas.com. Alternatively, you can place the installer artifact as dynatrace-server-linux-x86.jar in the role's files directory from where it will be picked up during the installation. The default file name and URL can be overridden via the dynatrace_server_linux_installer_file_name and dynatrace_server_linux_installer_file_url attributes, respectively. Please refer to defaults/main.yml for a list of supported attributes.

Role Variables

As defined in defaults/main.yml:

Name Default Description
dynatrace_server_linux_install_dir /opt The Dynatrace AppMon Server will be installed into the directory $dynatrace_server_linux_install_dir/dynatrace-$major-$minor-$rev, where $major, $minor and $rev are given by the installer. A symbolic link to the actual installation directory will be created in $dynatrace_server_linux_install_dir/dynatrace.
dynatrace_server_linux_installer_file_name dynatrace-server-7.0.0.2469-linux-x86.jar The file name of the Dynatrace AppMon installer in the role's files directory.
dynatrace_server_linux_installer_file_url https://files.dynatrace.com/downloads/OnPrem/dynaTrace/7.0/7.0.0.2469/dynatrace-server-7.0.0.2469-linux-x86.jar A HTTP, HTTPS or FTP URL to the Dynatrace AppMon installer in the form (http|https|ftp)://[user[:pass]]@host.domain[:port]/path.
dynatrace_server_agent_listen_port* 9998 The port where the server shall listen for Agents.
dynatrace_server_do_pwh_connection no Whether a connection to an existing Performance Warehouse (database) shall be established, or not. Note: requires Dynatrace AppMon >= v6.2.
dynatrace_server_pwh_connection_hostname localhost
dynatrace_server_pwh_connection_port 5432
dynatrace_server_pwh_connection_dbms postgresql The DBMS type of the Performance Warehouse. Possible values are embedded (not suitable for production systems), db2, oracle, postgresql, sqlazure, sqlserver
dynatrace_server_pwh_connection_database dynatrace
dynatrace_server_pwh_connection_username dynatrace
dynatrace_server_pwh_connection_password dynatrace
dynatrace_server_owner dynatrace The system user that owns the Dynatrace AppMon installation.
dynatrace_server_group dynatrace The system user's group that owns the Dynatrace AppMon installation.
dynatrace_server_role_name Dynatrace.Dynatrace-Server The actual name of this role in an Ansible Playbook's roles directory.
dynatrace_session_storage_directory sessions/stored Sessions will be stored in the directory (whole path to the directory: {{dynatrace_server_linux_install_dir}}/dynatrace/server/{{dynatrace_session_storage_directory}})

Example Playbook

- hosts: all
  roles:
    - role: Dynatrace.Dynatrace-Server
      dynatrace_server_do_pwh_connection: yes

Testing

We use Test Kitchen to automatically test our automated deployments with Serverspec and RSpec:

  1. Install Test Kitchen and its dependencies from within the project's directory:
gem install bundler
bundle install
  1. Run all tests
kitchen test

By default, we run our tests inside Docker containers as this considerably speeds up testing time (see .kitchen.yml).

Additional Resources

Blogs

Presentations

Problems? Questions? Suggestions?

This offering is Dynatrace Community Supported. Feel free to share any problems, questions and suggestions with your peers on the Dynatrace Community's Application Monitoring & UEM Forum.

License

Licensed under the MIT License. See the LICENSE file for details. analytics