update micro doc on the sync targets
authorThierry Parmentelat <thierry.parmentelat@inria.fr>
Mon, 9 Mar 2015 09:46:13 +0000 (10:46 +0100)
committerThierry Parmentelat <thierry.parmentelat@inria.fr>
Mon, 9 Mar 2015 09:46:13 +0000 (10:46 +0100)
ping-node.md

index 84a6ae1..23a7d7c 100644 (file)
@@ -19,19 +19,17 @@ And namely, the set of systemd files that describe booting off the CD image
 * This is **only** restarting the kvm/qemu node several times, nothing is done to recompute the .iso itself (see below for that). So the game is to easily simulate how a change to `bootcd` would affect a node ISO without rebuilding the whole damn thing
 * When -o is provided, the directory argument is created and all log files are stored in there
 
-## Easily redo a .iso
+# Easily redo a .iso
 
-* select a running test in testmaster/; like e.g. one that has failed the `ping_node` step already
+## preparation
 
-* you will need 2 local terminals with that
-  * one in `git/bootcd`
-  * one in `git/tests` 
+* select a running test in testmaster/; like e.g. one that has failed the `ping_node` step already
 
-* do the usual routine on running `exp`, exposing variables in both terminals,
+* you will need one local terminal in `git/bootcd`
 
-* then run `make sync` from workdir `tests/system` (just for `iterate-ping-node`)
+* do the usual routine on running `exp`, exposing variables in this terminal
 
-* and run `make sync-unwrap` from workdir bootcd
+* and run `make sync-unwrap` from this workdir `bootcd`
 
 At that point there will be the following files and subdirs on the KVM host (in my case boxtops)
 
@@ -44,9 +42,15 @@ At that point there will be the following files and subdirs on the KVM host (in
 * a read-only copy of the overlay image in `overlay.ref/`
 * a writable version of this in `overlay/`
 
-The workflow from then on is you can change the layout/contents of the bootcd/ directory, and then repeatedly run
+## iteration
+
+The workflow from then on is you can
 
-* `make sync-rewrap` from the `bootcd/` workdir, and then
-* `iterate-ping-node` from the `tests/` workdir
+* change the layout/contents of the `bootcd/` directory on the KVM host
+  * either manually right in the KVM host, and/or with
+  * `make sync-push` if you want to rsync the contents of `initscripts/` and ` systemd/` workdirs onto KVM 
+* and then rewrap the ISO image and hammer on it, and for this you run
+  * `make sync-rewrap` from the `bootcd/` workdir, and then
+  * `iterate-ping-node` from the `tests/` workdir
 
 Once you're satisfied you can make a difference between bootcd/ and bootcd.ref/ to see how the changes need to be implemented in `build.sh` and/or `prep.sh`