README

   1 The PlanetLab NodeManager manages all aspects of PlanetLab node and
   2 slice management once the node has been initialized and configured by
   3 the Boot Manager. It periodically contacts its management authority
   4 for configuration updates. It provides an XML-RPC API for performing
   5 local operations on slices.
   6
   7 Copyright 2008 Princeton University
   8 http://www.planet-lab.org
   9
  10 ========================================
  11 --- NOTES on packaging
  12
  13 we use the same codebase for vs-nodes and lxc-nodes
  14 common software gets shipped in nodemanager-lib, and specifics go in
  15 nodemanager-vs or nodemanager-lxc resp.
  16
  17 we have chosen to keep the same historical layout for codebase,
  18 see setup-{lib,vs,lxc}.py for details of what goes where
  19
  20 --- NOTES on debugging
  21
  22 (*) service nm restartdebug
  23 this lets you restart the nodemanager in interactive mode, and with faster periods
  24
  25
  26 (*) logs
  27 logging is a bit confusing; the main recipient is
  28     /var/log/nodemanager
  29
  30 [older notes, not sure thisis still relevant]
  31 but beware that part of the logs eventually end up in
  32     /vservers/<slicename>/var/log/nodemanager
  33 as well as in here (although this should not be used anymore by now)
  34     /vservers/<slicename>/var/log/boot.log
  35
  36 (*) connecting with PLC
  37 also, note that each time GetSlivers gets sucessfully fetched, it is saved in
  38     /var/lib/nodemanager/getslivers.txt
  39
  40 An effort was made so that the various pieces of nodemanager do not
  41 get called when connection with PLC is broken, however be aware that
  42 this might not be too robust and end up with red herrings