bonds: use rung <=> run -G that hurts my pinky
[tests.git] / system / AA-bonding.md
1 # bonding
2
3 Say you have 
4
5 * one build `2015.04.13--f14` under test
6 * another build `2015.04.13--f18` that you would like to use to create f18 nodes inside         `2015.04.13--f14`
7
8 general idea is to use this command
9
10         root@testmaster ~/2015.04.13--f14 # run -g 2015.04.13--f18 ...
11         
12 or in an equivalent manner
13
14         export bonding= 2015.04.13--f18
15         run -G
16         
17 # requirements
18
19 * the build to test (f14) must be running
20 * the build to bond with does not need to run but needs to be have run under `../2015.04.13--f18` so that its arg-* files reflect its flavour
21
22 # convenience
23
24 * rung can be used as a symlink to `TestMain.py`
25 * in this case it is like running `run -G`
26
27 * plus, `comp-testmaster` offers the convenience function
28                 
29                 bond ../$(t)*18
30                 
31 * or, even simpler
32
33                 bond18          
34
35 # initialisation
36
37         bond18
38         rung
39     
40 will define the f18 node flavour to the f14 build
41  
42 # creating bonding node
43
44         rung nodes
45
46 will create an additional node in tested myplc. 
47
48 **NOTE** for efficiency the IP and hostname of that node are stored in `arg-bonding-$bonding`
49
50 # starting node
51
52 as a matter of fact when doing `run -g $bonding` one can invoke most of the usual targets, including for starting the node
53
54         rung start-node wait-node
55         
56 # usual sequence
57
58         alias rung='run -g $bonding'
59         bonding=2015.04.13--f21
60         rung 
61         rung -n bonding-node
62         cat arg-bonding-$bonding
63         <<visual check>>
64         rung bonding-node
65