first stab at splitting into 2 packages nodemanager-lib and nodemanager-vs
[nodemanager.git] / README
1 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.
2
3 Copyright 2008 Princeton University
4 http://www.planet-lab.org
5
6 ========================================
7 --- NOTES on debugging
8
9
10 (*) service nm restartdebug
11 this lets you restart the nodemanager in interactive mode, and with faster periods
12
13
14 (*) logs
15 logging is a bit confusing; the main recipient is 
16     /var/log/nm
17 together with
18     /var/log/nm.daemon (which should be empty)
19
20 but beware that part of the logs eventually end up in 
21     /vservers/<slicename>/var/log/nm
22 as well as in here (although this should not be used anymore by now)
23     /vservers/<slicename>/var/log/boot.log
24
25
26 (*) connecting with PLC
27 also, note that each time GetSlivers gets sucessfully fetched, it is saved in
28     /var/log/getslivers.txt
29
30 When the connection is broken, for obscure reasons, all modules are
31 invoked anyway, but with an empty dict as data, triggering various
32 exceptions that complain about missing keys. In general these are red
33 herrings.