just modified the tools.py
[nodemanager.git] / 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