README

   1 # $Id$
   2 # $HeadURL$
   3
   4 The PlanetLab NodeManager manages all aspects of PlanetLab node and slice management once the node has been initialized and configured by the Boot Manager. It periodically contacts its management authority for configuration updates. It provides an XML-RPC API for performing local operations on slices.
   5
   6 Copyright 2008 Princeton University
   7 http://www.planet-lab.org
   8
   9 ========================================
  10 --- NOTES on debugging
  11
  12
  13 (*) service nm restartdebug
  14 this lets you restart the nodemanager in interactive mode, and with faster periods
  15
  16
  17 (*) logs
  18 logging is a bit confusing; the main recipient is
  19     /var/log/nm
  20 together with
  21     /var/log/nm.daemon (which should be empty)
  22
  23 but beware that part of the logs eventually end up in
  24     /vservers/<slicename>/var/log/nm
  25 as well as in here (although this should not be used anymore by now)
  26     /vservers/<slicename>/var/log/boot.log
  27
  28
  29 (*) connecting with PLC
  30 also, note that each time GetSlivers gets sucessfully fetched, it is saved in
  31     /var/log/getslivers.txt
  32
  33 When the connection is broken, for obscure reasons, all modules are
  34 invoked anyway, but with an empty dict as data, triggering various
  35 exceptions that complain about missing keys. In general these are red
  36 herrings.