ext/windows/README.md

   1 These files support installing and using mcollective on MS Windows.
   2
   3 Here are a few instructions for people who wish to do early adopter
   4 testing, before 2.0 is out we hope to have this packaged into a msi
   5 installer but your early feedback will help.
   6
   7 Assuming you are installing mcollective into C:\marionette-collective:
   8
   9  * Install Ruby from http://rubyinstaller.org/, use 1.8.7
  10  * Install the following gems: stomp, win32-process, win32-service,
  11    sys-admin, windows-api
  12  * extract the zip file or clone the git repo into C:\marionette-collective
  13  * copy the files from C:\marionette-collective\ext\windows\*.* into
  14    C:\marionette-collective\bin
  15  * Install any plugins and their dependencies into C:\marionette-collective\plugins
  16    specifically for the package and service agents you can install Puppet via gems
  17  * Edit the configuration files setting:
  18    * libdir = c:\marionette-collective\plugins
  19    * logfile = c:\marionette-collective\mcollective.log
  20    * plugin.yaml = c:\marionette-collective\etc\facts.ysml
  21    * daemonize = 1
  22  * change directories to c:\marionette-collective\bin and run register_service.bat
  23
  24 At this point you would have your service registered into the windows service
  25 manager but set to manual start.  If you start it there it should run ok.
  26
  27 If it does not run:
  28
  29  * Look in the log files, set it to debug level
  30  * If the log files are empty look at the command the service wrapper runs
  31    and run it by hand.  This will show you any early exception preventing it
  32    from running.  It wont succesfully start but you should see why it does
  33    not get far enough to start writing logs.
  34