Forge Home


File Manager


214,036 latest version

2.6 quality score

Version information

  • 2.0.1 (latest)
  • 2.0.0
  • 1.1.0
released Apr 20th 2018
This version is compatible with:
  • Puppet Enterprise 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 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, 2017.1.x, 2016.4.x
  • Puppet >= 4.9.0

Start using this module

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

Add this module to your Puppetfile:

mod 'choria-mcollective_agent_filemgr', '2.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add choria-mcollective_agent_filemgr
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install choria-mcollective_agent_filemgr --version 2.0.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.



choria/mcollective_agent_filemgr — version 2.0.1 Apr 20th 2018

Choria File Manager Agent

This agent let you touch files, delete files or retrieve a bunch of stats about a file.


This agent provides the following actions, for details about each please run mco plugin doc agent/filemgr

  • remove - Removes a file
  • status - Basic information about a file
  • touch - Creates an empty file or touch it's timestamp


This agent is installed by default as part of the Choria Orchestrator.


Actions status, remove and touch have a default file when no file path is given, it defaults to /var/run/mcollective.plugin.filemgr.touch.

To cofigure this create the following Hiera data:

  touch_file: "/tmp/touchfile"


To get the status of a file:

% mco rpc filemgr status file=/etc/puppet/puppet.conf
Determining the amount of hosts matching filter for 2 seconds .... 1

 * [ ============================================================> ] 1 / 1
   Modification time: 1289650072
         Change time: Wed Nov 17 00:29:17 +0000 2010
         Change time: 1289953757
                Name: /etc/puppet/puppet.conf
               Owner: 0
         Access time: 1291150379
               Group: 0
                Size: 385
         Access time: Tue Nov 30 20:52:59 +0000 2010
             Present: 1
                Type: file
                Mode: 100644
   Modification time: Sat Nov 13 12:07:52 +0000 2010
                 MD5: 91b8793f2a467aa5d28f6371d3622090
              Status: present

Finished processing 1 / 1 hosts in 71.65 ms

You can similarly touch and remove a file using those named actions.