Skip to content

Files

Latest commit

56fefcb · Jun 4, 2014

History

History
46 lines (25 loc) · 2.83 KB

README.md

File metadata and controls

46 lines (25 loc) · 2.83 KB

MCollective-MSI

You could download a package I have compiled from the release tab above, or build one yourself using instructions below.

Usage

  1. Configuration file usually at %ProgramData%\MCollective\etc\server.cfg. It is autogenerated if not present.
  2. Deploys Facter CEF. This is a Cache for Expensive Facts. Get's installed as a scheduled task, running every 10 minutes to save time consuming facts related to network interfaces on MS Windows in facts.d .
  3. puppet and service agents are included.
  4. facter facts plugin is included.

Prerequisites

  1. Puppet MSI from Puppet Labs installed. Tested with versions 3.3.2 and 3.4.3 . This setup [and the Windows Service] is configured to piggyback on the Gems and Ruby environment provided by the Puppet installation.

Known Issues

  1. If usage of facter as a source of facts crashes with a debug message like in `rescue in block in get_fact' Failed to load facts: ThreadError: deadlock; recursive locking, remove the %ProgramFiles(x86)%\Puppet Labs\Puppet\facter\lib\facter\processor.rb file.
  2. If mco puppet runonce fails rather too quickly, edit %ProgramFiles(x86)%\MCollective\plugins\mcollective\agent\puppet.rb:12 to find the puppet command at its absolute path as per your environment. Example, change "puppet agent" to "c:/program files (x86)/puppet labs/puppet/bin/puppet.bat agent".
  3. The Task Scheduler (Schedule) service must be running for the installation to succeed.

Build Yourself

  1. Install the WiX Toolset from https://wix.codeplex.com/releases/view/115492 .
  2. Check out this code.
  3. Extract the MCollective 2.5.1 tarball obtained from http://puppetlabs.com/misc/download-options into the _mco_ directory.
  4. Get best versions of mcollective-puppet-agent, mcollective-puppet-common, mcollective-service-agent, mcollective-service-common and mcollective-facter-facts RPMs from http://yum.puppetlabs.com/el/6/products/x86_64/ . Extract them and merge contents at usr\libexec\mcollective\mcollective of the extract into the mco\plugins\mcollective directory.
  5. Change into the workspace directory: cd wks
  6. Set path to WiX binaries: set PATH="%ProgramFiles(x86)%\WiX Toolset v3.8\bin";%PATH%
  7. heat dir ..\mco -gg -sfrag -template fragment -ke -cg Tarball -dr ProgramFilesFolder_MCollective -srd -out files.wxs
  8. candle files.wxs ..\wxs\mcollective.wxs
  9. light -b ..\mco files.wixobj mcollective.wixobj -out ..\msi\mcollective-2.5.1002.msi

Versioning

Due to idiosyncrasies and limitations of the Windows Installer around upgrades, the version numbers here reflect the upstream MCollective major and minor version number accurately. The patch number is then first multiplied by 1000 and my own release number added afterwards. Therefore, 2.5.1002 here means 2.5.1 release 2.