Forge Home

ocsinventoryagent

Installs the OCS Inventory agent for linux

4,170 downloads

834 latest version

4.7 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

  • 1.0.0 (latest)
  • 0.4.2
  • 0.4.1
  • 0.4.0
  • 0.3.0
  • 0.2.0
  • 0.1.0
released Jul 22nd 2021
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 'dodevops-ocsinventoryagent', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add dodevops-ocsinventoryagent
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install dodevops-ocsinventoryagent --version 1.0.0

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

dodevops/ocsinventoryagent — version 1.0.0 Jul 22nd 2021

dodevops/ocsinventoryagent

Build status

Table of Contents

  1. Description
  2. Usage - Configuration options and additional functionality

Description

This puppet module installs and configures the linux agent for OCS-Inventory.

Requirements

Package repo for non Debian based operating systems

You need to care for the ocsinventory-agent package repository by yourself on non Debian based operating systems.

On Debian based operating systems, the pacakge is part of the repositories.

SLES requirements

On SLES (only SLES 15 tested so far) the "Desktop Applications" and the "Development Tools" software modules need to be activated in order for dependencies to be available. Some of the dependencies are not available in the the software pools for SLES and need to be provided separatly. Recommended is the opensuse software portal https://software.opensuse.org/. Recommended is the "devel:languages:perl" project there, where most of the packages are available. Every infrastructure is different, so please take care of providing these pacakges on your own. This module only has package install definitions for those packages.

The affected packages in detail are:

  • perl-Data-UUID
  • perl-Proc-Daemon
  • perl-Proc-ProcessTable
  • perl-Proc-Simple

Sysconfig file

The packages for non Debian based operating systems are very fragmented. For RedHat/Centos there are packages in EPEL but also on the repo of the OCS inventory project itself, both are structured very different. Also for SLES you can find many different packages in the OpenSUSE build service.

Nearly all (exception is f.e. the EPEL package) of those packages have in common, that you have to configure a sysconfig file in order for the agent (or to be specific: its cronjob) to do something. Some of them provide templates for it, some not. And the config flags in those differ. So please take care about the sysconfig file on your own, if required.

CA

If your OCS server has the complete chain (root CA, intermediate, certificate), your agent should work without a CA set. However if you don't configure the root CA on your OCS server, you need to provide the root CA on the agent. If your server uses a certificate signed by a usual CA, the CA bundle of the specific OS has proven to work fine. You can spot that something is wrong with your CA setup if your agent looks for a CAcert.pem file in its /var directory and cant find it.

Usage

Use the class ocsinventoryagent to install and configure the agent. See the reference section for details.

class {
  'ocsinventoryagent':
    server => 'https://ocs.company.com',
}