bugfix del-controllers + doc
[sliver-openvswitch.git] / planetlab / exp-tool / Makefile
1 # see README
2 # conf.mk is expected to define
3 # HOST_<id> and IP_<id> for all nodes involved, as well as 
4 # LINKS as a list of <node_id>-<node_id> elements
5
6 # run make CONF=anotherconfig.mk if you need several configs
7
8 CONF ?= conf.mk
9 include $(CONF)
10
11 # if undefined in the conf file, use single dash
12 SEP?=-
13
14 # bridge name (XXX the same on all nodes)
15 BRIDGE?=$(SLICE)
16
17 ### helper functions
18 # flip(1) = 2
19 # flip(2) = 1
20 flip=$(if $(findstring 1,$(1)),2,1)
21 # cutsep (x-y)-> x y
22 cutsep=$(subst $(SEP), ,$(1))
23 # leftnode (x-y) -> x
24 leftnode=$(word 1,$(call cutsep,$(1)))
25 # rightnode (x-y) -> y
26 rightnode=$(word 2,$(call cutsep,$(1)))
27 # linkpart(x@y) = x
28 linkpart=$(word 1,$(subst @, ,$(1)))
29 # endpart(x@y) = y
30 endpart=$(word 2,$(subst @, ,$(1)))
31 # get(x-y@1) = x
32 # get(x-y@2) = y
33 get=$(word $(call endpart,$(1)),$(call cutsep,$(call linkpart,$(1))))
34 # opp(x-y@1) = x-y@2
35 # opp(x-y@2) = x-y@1
36 opp=$(call linkpart,$(1))@$(call flip,$(call endpart,$(1)))
37 # rget(x-y@1) = y
38 # rget(x-y@2) = x
39 rget=$(call get,$(call opp,$(1)))
40 ###
41 default=$(if $($(1)_$(2)),$($(1)_$(2)),$($(1)))
42 solve=$(HOST_$(1))
43 solve_ip=$(IP_$(1))
44 # can be redefined in conf.mk if that's not the expected behaviour
45 display?=host $(1) aka $(call solve,$(1))
46
47 # log file name
48 log=$(addprefix log/,$(notdir $(1)))
49
50 #################### set variables after conf.mk
51 ifeq "$(SSH_KEY)" ""
52 SSH_KEY_OPTION ?=
53 else
54 SSH_KEY_OPTION ?= -i $(SSH_KEY)
55 endif
56
57 SSH_OPTIONS ?= $(SSH_KEY_OPTION) -l $(SLICE)
58 SSH = ssh $(SSH_OPTIONS)
59
60 SUDO ?= sudo -S
61
62 ALL_NODE_IDS=$(sort $(foreach link,$(LINKS),$(call leftnode,$(link))) $(foreach link,$(LINKS),$(call rightnode,$(link))))
63 ALL_NODE_HOSTS=$(foreach id,$(ALL_NODE_IDS),$(call solve,$(id)))
64 ALL_LINK_IDS=$(addsuffix @1,$(LINKS)) $(addsuffix @2,$(LINKS))
65 CONF_NODE_IDS=$(subst HOST_,,$(filter HOST_%,$(.VARIABLES)))
66
67 ####################
68 init_all: init all
69 init:
70         @[ -d L ] || ( echo Creating tmp dir L; mkdir L)
71         @[ -d log ] || (echo Creating tmp dir log; mkdir log)
72         @[ -d cache ] || ( echo Creating tmp dir cache; mkdir cache)
73 .PHONY: init_all init
74
75 FORCE:
76
77 .SECONDARY:
78
79 LINKTARGETS=$(addprefix L/,$(LINKS))
80 all: $(LINKTARGETS)
81 .PHONY: all
82
83 # could also do make ++SLICE
84 showslice: ++SLICE FORCE
85
86 shownodes:
87         @$(foreach id,$(ALL_NODE_IDS),echo $(id)=$(call display,$(id));)
88 showhostnames: ++ALL_NODE_HOSTS
89 showips:
90         @$(foreach id,$(ALL_NODE_IDS),echo $(id)=$(call display,$(id)) has ip/network set to $(IP_$(id));)
91 showlinks:
92         @$(foreach link,$(LINKS), echo $(call display,$(call leftnode,$(link))) '====>' $(call display,$(call rightnode,$(link)));)
93 showcontrollers:
94         @$(foreach id,$(ALL_NODE_IDS), echo $(call display,$(id)) has controller $(call default,CONTROLLER,$(id));)
95 .PHONY: shownodes showhostnames showips showlinks showcontrollers
96
97 sshchecks: $(foreach id,$(ALL_NODE_IDS),sshcheck-$(id))
98 .PHONY: sshchecks
99 ovsversions: $(foreach id,$(ALL_NODE_IDS),ovsversion-$(id))
100 .PHONY: ovsversions
101 # more general form; run with  make sshs SSH-COMMAND="bla bla bla"
102 sshs: $(foreach id,$(ALL_NODE_IDS),ssh-$(id))
103 .PHONY: sshs
104
105 DBS=$(foreach id,$(ALL_NODE_IDS),cache/db.$(id))
106 dbs: $(DBS)
107 .PHONY: dbs
108
109 SWITCHS=$(foreach id,$(ALL_NODE_IDS),cache/switch.$(id))
110 switchs: $(SWITCHS)
111 .PHONY: switchs
112
113 start: dbs switchs
114 .PHONY: start
115
116 stop:$(foreach id,$(ALL_NODE_IDS),cache/stop.$(id))
117 .PHONY: stop
118
119 status:$(foreach id,$(ALL_NODE_IDS),cache/status.$(id))
120 .PHONY: status
121
122 BRIDGES=$(foreach id,$(ALL_NODE_IDS),cache/bridge.$(id))
123 bridges: $(BRIDGES)
124 .PHONY: bridges
125
126 CONTROLLERS=$(foreach id,$(ALL_NODE_IDS),cache/controller.$(id))
127 controllers: $(CONTROLLERS)
128 .PHONY: controllers
129
130 del-controllers: $(foreach id,$(ALL_NODE_IDS),del-controller-$(id))
131 .PHONY: del-controllers
132
133 ### node-oriented targets
134 # check ssh connectivity
135 sshcheck-%: FORCE
136         @if $(SSH) $(HOST_$*) hostname &> /dev/null; then echo "ssh on" $(call display,$*) "OK" ; \
137          else echo "ssh on" $(call display,$*) "KO !!!"; fi
138
139 ovsversion-%: FORCE
140         @OVSVERSION=$$($(SSH) $(HOST_$*) rpm -q sliver-openvswitch); echo $(call display,$*) has $$OVSVERSION
141
142 ssh-%: FORCE
143         @$(SSH) $(HOST_$*) $(SUDO) $(SSH-COMMAND)
144
145 # should probably replace sshcheck
146 cache/status.%: FORCE
147         @echo "=== DB and SWITCH processes on $(call display,$*)"
148         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs status ||:
149
150 cache/host.%:
151         @echo "IP lookup for $(call display,$*)"
152         @host $(HOST_$*) | sed -n 's/^.*has address *//p' > $@
153
154 cache/db.%:
155         @echo "Starting db server on $(call display,$*) - logs in $(call log,$@)"
156         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs start-db &> $(call log,$@) && touch $@
157
158 cache/switch.%: cache/db.%
159         @echo "Starting vswitchd on $(call display,$*) - logs in $(call log,$@)"
160         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs start-switch &> $(call log,$@) && touch $@
161
162 cache/bridge.%: cache/switch.%
163         @echo "Creating bridge on $(call display,$*) - logs in $(call log,$@)"
164         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs create-bridge $(BRIDGE) $(IP_$*) > $@ 2> $(call log,$@) || { rm $@; exit 1; }
165         @echo Created bridge with tap $$(cat $@) on $(call display,$*)
166
167 cache/controller.%: cache/bridge.%
168         @echo "Setting controller $(call default,CONTROLLER,$*) on $(call display,$*) - logs in $(call log,$@)"
169         @$(SSH) $(HOST_$*) $(SUDO) ovs-vsctl set-controller $(BRIDGE) $(call default,CONTROLLER,$*) &> $(call log,$@) || { rm $@; exit 1; }
170
171 # xxx this probably needs a more thorough cleanup in cache/
172 cache/stop.%: del-bridge.%
173         @echo "Stopping switch & db on $(call display,$*)"
174         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs stop && rm cache/switch.$* cache/db.$*
175
176 ### link-oriented targets
177 # L/<nodeid>-<node_id>
178 L/%: cache/link.%@1 cache/link.%@2
179         @touch $@
180         @echo "Created link $*"
181
182 U/%: del-iface.%@1 del-iface.%@2
183         @rm -f L/$*
184         @echo "Deleted link $*"
185
186 del-bridge.%: cache/db.%
187         @echo "Deleting bridge on $(call display,$*)"
188         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs del-bridge $(BRIDGE);
189         @rm -f cache/bridge.$* \
190               cache/iface.$*$(SEP)*@1 cache/iface.*$(SEP)$*@2 \
191               cache/link.$*$(SEP)*@?  cache/link.*$(SEP)$*@?  \
192               L/$*$(SEP)*             L/*$(SEP)$*
193
194 del-switch.%: del-bridge.%
195         @echo "Shutting down switch on $(call display,$*)"
196         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs stop-switch
197         @rm -f cache/switch.$* 
198
199 del-db.%:
200         @echo "Shutting down db on $(call display,$*)"
201         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs stop-db
202         @rm -f cache/db.$*
203
204 del-controller-%:
205         @echo "Removing controller for $(call display,$*)"
206         @$(SSH) $(HOST_$*) $(SUDO) sliver-ovs del-controller $(BRIDGE)
207         @rm -f cache/controller.$*
208
209 del-links: $(addprefix U/,$(notdir $(filter-out %.log,$(wildcard L/*))))
210
211 del-switchs: $(addprefix del-,$(notdir $(filter-out %.log,$(wildcard cache/switch.*))))
212
213 del-dbs: $(addprefix del-,$(notdir $(filter-out %.log,$(wildcard cache/db.*))))
214
215 shutdown: del-switchs del-dbs
216
217 .PHONY: del-links del-switchs del-dbs shutdown
218
219
220 ### snapshots
221 remote-snapshot: remote-snapshot-ips remote-snapshot-links
222         @true
223
224 remote-snapshot-ips: $(addprefix cache/rsnap.ip.,$(CONF_NODE_IDS))
225         @cat /dev/null $^
226
227 remote-snapshot-links: $(addprefix cache/rsnap.links.,$(CONF_NODE_IDS))
228         @sort -u /dev/null $^
229
230 ### update sliver-ovs
231 update: $(addprefix update-,$(CONF_NODE_IDS))
232         @true
233
234 update-%: FORCE
235         @[ -n "$(SLIVER_OVS)" ] || { echo "SLIVER_OVS not set" >&2; exit 1; }
236         @[ -f "$(SLIVER_OVS)" ] || { echo "$(SLIVER_OVS) not found" >&2; exit 1; }
237         @echo "Sending $(SLIVER_OVS) to $(call display,$*)"
238         @scp -q $(SLIVER_OVS) $(SLICE)@$(call solve,$*):
239         @$(SSH) $(call solve,$*) $(SUDO) mv $(notdir $(SLIVER_OVS)) /usr/sbin/sliver-ovs
240
241 .PHONY: remote-snapshot remote-snapshot-ips remote-snapshot-links
242
243 cache/rsnap.ip.%: 
244         @$(SSH) $(HOST_$*) $(SUDO) ovs-vsctl -- \
245                 get interface $(BRIDGE) options:local_ip options:local_netmask |\
246                 sed -n 's|"||g;1h;2{G;s|\(.*\)\n\(.*\)|IP_$* = \2/\1|p}' > $@ || \
247          { rm $@; exit 1; }
248
249 cache/rsnap.links.%: 
250         @$(SSH) $(HOST_$*) $(SUDO) ovs-vsctl list-ifaces $(BRIDGE) | \
251          sed -n 's/^L/LINKS += /p' > $@ || \
252          { rm $@; exit 1; }
253
254 .SECONDEXPANSION:
255
256 del-iface.%: cache/db.$$(call get,%)
257         @echo "Removing interface for link $(call linkpart,$*) from $(call get,$*)"
258         @$(SSH) $(HOST_$(call get,$*)) \
259                 $(SUDO) sliver-ovs del-port L$(call linkpart,$*)
260         @rm -f cache/iface.$* cache/link.$* cache/link.$(call opp,$*)
261
262
263 ### '%' here is leftid-rightid@{1,2}
264 # we retrieve % as $(*F)
265 #linkid=$(call linkpart,%)
266 #nodeid=$(call get,%)
267 #bridgefile=cache/bridge.$(nodeid)
268 cache/iface.%: cache/bridge.$$(call get,%)
269         @echo "Creating interface for link $(call linkpart,$(*F)) on $(call display,$(call get,$(*F))) - logs in $(call log,$@)"
270         @$(SSH) $(call solve,$(call get,$(*F))) $(SUDO) sliver-ovs create-port $(BRIDGE) \
271                 L$(call linkpart,$(*F)) > $@ 2> $(call log,$@) || { rm $@; exit 1; }
272
273
274 # linkid=$(call linkpart,%)
275 # nodeid=$(call get,%)
276 # iface1=cache/iface.%
277 # iface2=cache/iface.$(call opp,%)
278 cache/link.%: cache/host.$$(call rget,%) cache/iface.% cache/iface.$$(call opp,%)
279         @echo "Setting port number of link $(call linkpart,$(*F)) on $(call display,$(call get,$(*F))) - logs in $(call log,$@)"
280         @$(SSH) $(call solve,$(call get,$(*F))) $(SUDO) sliver-ovs set-remote-endpoint L$(call linkpart,$(*F)) \
281                         $$(cat cache/host.$(call rget,$(*F))) \
282                         $$(cat cache/iface.$(call opp,$(*F))) 2> $(call log,$@) \
283          && touch $@
284
285 ####################
286 CLEANTARGETS=$(addprefix del-,$(notdir $(filter-out %.log,$(wildcard cache/bridge.*))))
287 clean: $(CLEANTARGETS)
288 distclean:
289         rm -rf L log cache
290 .PHONY: clean distclean
291
292 ####################
293 graph.dot:
294         ( echo "digraph $(SLICE) {"; ls L | sed 's/$(SEP)/->/;s/$$/;/'; echo "}" ) > $@
295 graph.ps: graph.dot
296         dot -Tps < $^ > $@      
297
298
299 ####################
300 # 'virtual' targets in that there's no real file attached
301 define node_shortcuts
302 sshcheck.$(1): sshcheck-$(1) FORCE
303 db.$(1): cache/db.$(1) FORCE
304 switch.$(1): cache/switch.$(1) FORCE
305 start.$(1): cache/start.$(1) FORCE
306 stop.$(1): cache/stop.$(1) FORCE
307 status.$(1): cache/status.$(1) FORCE
308 bridge.$(1): cache/bridge.$(1) FORCE
309 host.$(1): cache/host.$(1) FORCE
310 # switch already depends on db, but well
311 cache/start.$(1): cache/db.$(1) cache/switch.$(1) FORCE
312 endef
313
314 $(foreach id,$(ALL_NODE_IDS), $(eval $(call node_shortcuts,$(id))))
315
316 define link_shortcuts
317 iface.%: cache/iface.%
318 link.%: cache/link.%
319 endef
320
321 $(foreach id,$(ALL_LINK_IDS), $(eval $(call link_shortcuts,$(id))))
322
323 help:
324         @cat Makefile.help
325
326 #################### convenience, for debugging only
327 # make +foo : prints the value of $(foo)
328 # make ++foo : idem but verbose, i.e. foo=$(foo)
329 ++%: varname=$(subst +,,$@)
330 ++%:
331         @echo "$(varname)=$($(varname))"
332 +%: varname=$(subst +,,$@)
333 +%:
334         @echo "$($(varname))"