Forge Home

ruxit_agent

This downloads and installs the ruxit agent

12,308 downloads

7,532 latest version

4.6 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.

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:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. 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

  • 1.0.6 (latest)
  • 1.0.5
  • 1.0.4
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0 (deleted)
released Dec 21st 2016
This version is compatible with:
  • Windows, RedHat, Ubuntu, Debian, CentOS

Start using this module

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

Add this module to your Puppetfile:

mod 'ruxit-ruxit_agent', '1.0.6'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add ruxit-ruxit_agent
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install ruxit-ruxit_agent --version 1.0.6

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

ruxit/ruxit_agent — version 1.0.6 Dec 21st 2016

Overview

This module downloads and installs the ruxit unified agent on windows and linux systems.

Sample Usage

Example 1

class { 'ruxit_agent':
  user          => 'test',
  group         => 'test',
  ruxit_tenant  => 'yxcvbnm',
  ruxit_token   => 'TOKEN',
}

This example will download the current stable release agent to a directory owned by user/group test and connect it to the given ruxit tenant. Tenant id and tenant token are required in order to connect the ruxit agent to your account.

Example 2

class { 'ruxit_agent': }

or

include ruxit_agent

This example will install the corresponding version if all non-optional parameters can be resolved via hiera. It will fail otherwise!

##License This module is provided under BSD-3-Clause license. Please check out the details in the LICENSE.txt

##Reference

###Classes ###ruxit_agent: Main class, includes everything else

###Parameters The following parameters are available in the ruxit_agent class:

####user The owner of files. !! This user is not created by this module. Please make sure it exists. !!

####group The group for the owner of files.

####ruxit_tenant Your ruxit tenant ID is the unique identifier of your ruxit environment. You can find it easily by looking at the URL in your browser when you are logged into your Ruxit home page.

https://{tenant}.live.ruxit.com

The subdomain {tenant} represents your tenant id.

####ruxit_token The token for your ruxit tenant. You can get your token by following these steps

  1. go to your ruxit environment: https://{tenant}.live.ruxit.com

  2. Click the burger menu in the right upper corner and select Monitor another host

  3. You will see the "Download Ruxit Agent" wizard; click Linux (even if you need Windows)

  4. You will see the wget command line. The token is the last part of the path after /latest/

    wget -O ruxit-Agent-Linux-1.XX.0.2015XXXX-XXXXXX.sh https://{tenant}.live.ruxit.com/installer/agent/unix/latest/{this-is-the-token}

  5. copy it and use it in your puppet config

####ruxit_server The ruxit server to connect to. This defaults to the https://{tenant}.live.ruxit.com

####version If set the defined version of the ruxit agent will be installed. If set to an empty string the latest version for the channel will be installed. Defaults to '' -> latest

####channel Define the install/update channel you want to use. This is for ruxit internal purposes only right now.

  • dev -> development branch (highly unstable)
  • sprint -> development branch (unstable)
  • unstable -> release branch (unstable)
  • stable -> release branch (stable) defaults to stable

####log_keep_days Sets the number of days you want to keep logs. defaults to 14 days

####service_restarts String array with services that should be restarted after install/upgrade. defaults to an empty array -> no additional service restarts

###Resources

####cleanup_log A resource cleaning all files in a given directory that were not modified in the given time frame.

####install_ruxit_agent Installs the agent from and to the paths defined in the main class.

####linux_restart_service A resource that triggers restarts of init.d based services.

####restart_services_hook This resource is called after the installation of the ruxit agent to restart services that should be instrumented. You can define the services as a parameter of the main class: service_restarts

####windows_restart_service A resource wrapper for service stop and start.

####windows_restart_service A resource starting a given windows service.

####windows_restart_service A resource stopping a given windows service.

Supported OSes

This module is designed for Windows and Linux systems. If it does not work for your environment please get in touch via the project site.