Artifact
db9edbb5ab9b1ff1a019b9deb54acdfb0ef48495:
Wiki page
[howto] by
mrwellan
2018-03-05 08:10:55.
0000: 44 20 32 30 31 38 2d 30 33 2d 30 35 54 31 35 3a D 2018-03-05T15:
0010: 31 30 3a 35 35 2e 30 32 39 0a 4c 20 68 6f 77 74 10:55.029.L howt
0020: 6f 0a 4e 20 74 65 78 74 2f 70 6c 61 69 6e 0a 50 o.N text/plain.P
0030: 20 62 63 66 34 37 30 61 34 63 33 35 32 61 35 63 bcf470a4c352a5c
0040: 35 33 31 63 30 34 34 63 38 33 31 65 65 39 64 36 531c044c831ee9d6
0050: 31 32 61 39 36 37 38 62 35 0a 55 20 6d 72 77 65 12a9678b5.U mrwe
0060: 6c 6c 61 6e 0a 57 20 36 33 34 30 0a 2f 2f 20 54 llan.W 6340.// T
0070: 68 69 73 20 66 69 6c 65 20 69 73 20 70 61 72 74 his file is part
0080: 20 6f 66 20 4d 65 67 61 74 65 73 74 2e 0a 2f 2f of Megatest..//
0090: 20 0a 2f 2f 20 20 20 20 20 4d 65 67 61 74 65 73 .// Megates
00a0: 74 20 69 73 20 66 72 65 65 20 73 6f 66 74 77 61 t is free softwa
00b0: 72 65 3a 20 79 6f 75 20 63 61 6e 20 72 65 64 69 re: you can redi
00c0: 73 74 72 69 62 75 74 65 20 69 74 20 61 6e 64 2f stribute it and/
00d0: 6f 72 20 6d 6f 64 69 66 79 0a 2f 2f 20 20 20 20 or modify.//
00e0: 20 69 74 20 75 6e 64 65 72 20 74 68 65 20 74 65 it under the te
00f0: 72 6d 73 20 6f 66 20 74 68 65 20 47 4e 55 20 47 rms of the GNU G
0100: 65 6e 65 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 eneral Public Li
0110: 63 65 6e 73 65 20 61 73 20 70 75 62 6c 69 73 68 cense as publish
0120: 65 64 20 62 79 0a 2f 2f 20 20 20 20 20 74 68 65 ed by.// the
0130: 20 46 72 65 65 20 53 6f 66 74 77 61 72 65 20 46 Free Software F
0140: 6f 75 6e 64 61 74 69 6f 6e 2c 20 65 69 74 68 65 oundation, eithe
0150: 72 20 76 65 72 73 69 6f 6e 20 33 20 6f 66 20 74 r version 3 of t
0160: 68 65 20 4c 69 63 65 6e 73 65 2c 20 6f 72 0a 2f he License, or./
0170: 2f 20 20 20 20 20 28 61 74 20 79 6f 75 72 20 6f / (at your o
0180: 70 74 69 6f 6e 29 20 61 6e 79 20 6c 61 74 65 72 ption) any later
0190: 20 76 65 72 73 69 6f 6e 2e 0a 2f 2f 20 0a 2f 2f version..// .//
01a0: 20 20 20 20 20 4d 65 67 61 74 65 73 74 20 69 73 Megatest is
01b0: 20 64 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 distributed in
01c0: 74 68 65 20 68 6f 70 65 20 74 68 61 74 20 69 74 the hope that it
01d0: 20 77 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2c will be useful,
01e0: 0a 2f 2f 20 20 20 20 20 62 75 74 20 57 49 54 48 .// but WITH
01f0: 4f 55 54 20 41 4e 59 20 57 41 52 52 41 4e 54 59 OUT ANY WARRANTY
0200: 3b 20 77 69 74 68 6f 75 74 20 65 76 65 6e 20 74 ; without even t
0210: 68 65 20 69 6d 70 6c 69 65 64 20 77 61 72 72 61 he implied warra
0220: 6e 74 79 20 6f 66 0a 2f 2f 20 20 20 20 20 4d 45 nty of.// ME
0230: 52 43 48 41 4e 54 41 42 49 4c 49 54 59 20 6f 72 RCHANTABILITY or
0240: 20 46 49 54 4e 45 53 53 20 46 4f 52 20 41 20 50 FITNESS FOR A P
0250: 41 52 54 49 43 55 4c 41 52 20 50 55 52 50 4f 53 ARTICULAR PURPOS
0260: 45 2e 20 20 53 65 65 20 74 68 65 0a 2f 2f 20 20 E. See the.//
0270: 20 20 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 GNU General P
0280: 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 66 6f ublic License fo
0290: 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e 0a r more details..
02a0: 2f 2f 20 0a 2f 2f 20 20 20 20 20 59 6f 75 20 73 // .// You s
02b0: 68 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65 69 hould have recei
02c0: 76 65 64 20 61 20 63 6f 70 79 20 6f 66 20 74 68 ved a copy of th
02d0: 65 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 e GNU General Pu
02e0: 62 6c 69 63 20 4c 69 63 65 6e 73 65 0a 2f 2f 20 blic License.//
02f0: 20 20 20 20 61 6c 6f 6e 67 20 77 69 74 68 20 4d along with M
0300: 65 67 61 74 65 73 74 2e 20 20 49 66 20 6e 6f 74 egatest. If not
0310: 2c 20 73 65 65 20 3c 68 74 74 70 3a 2f 2f 77 77 , see <http://ww
0320: 77 2e 67 6e 75 2e 6f 72 67 2f 6c 69 63 65 6e 73 w.gnu.org/licens
0330: 65 73 2f 3e 2e 0a 0a 48 6f 77 20 54 6f 20 44 6f es/>...How To Do
0340: 20 54 68 69 6e 67 73 0d 0a 2d 2d 2d 2d 2d 2d 2d Things..-------
0350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 50 72 6f ---------....Pro
0360: 63 65 73 73 20 52 75 6e 73 0d 0a 7e 7e 7e 7e 7e cess Runs..~~~~~
0370: 7e 7e 7e 7e 7e 7e 7e 0d 0a 0d 0a 52 65 6d 6f 76 ~~~~~~~....Remov
0380: 65 20 52 75 6e 73 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e e Runs..^^^^^^^^
0390: 5e 5e 5e 0d 0a 0d 0a 46 72 6f 6d 20 74 68 65 20 ^^^....From the
03a0: 64 61 73 68 62 6f 61 72 64 20 63 6c 69 63 6b 20 dashboard click
03b0: 6f 6e 20 74 68 65 20 62 75 74 74 6f 6e 20 28 50 on the button (P
03c0: 41 53 53 2f 46 41 49 4c 2e 2e 2e 29 20 66 6f 72 ASS/FAIL...) for
03d0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 74 65 73 74 one of the test
03e0: 73 2e 20 46 72 6f 6d 20 74 68 65 20 74 65 73 74 s. From the test
03f0: 20 63 6f 6e 74 72 6f 6c 20 70 61 6e 65 6c 20 74 control panel t
0400: 68 61 74 20 0d 0a 63 6f 6d 65 73 20 75 70 20 70 hat ..comes up p
0410: 75 73 68 20 74 68 65 20 63 6c 65 61 6e 20 74 65 ush the clean te
0420: 73 74 20 62 75 74 74 6f 6e 2e 20 54 68 65 20 63 st button. The c
0430: 6f 6d 6d 61 6e 64 20 66 69 65 6c 64 20 77 69 6c ommand field wil
0440: 6c 20 62 65 20 70 72 65 66 69 6c 6c 65 64 20 77 l be prefilled w
0450: 69 74 68 20 61 20 74 65 6d 70 6c 61 74 65 20 63 ith a template c
0460: 6f 6d 6d 61 6e 64 20 66 6f 72 20 72 65 6d 6f 76 ommand for remov
0470: 69 6e 67 20 0d 0a 74 68 61 74 20 74 65 73 74 2e ing ..that test.
0480: 20 59 6f 75 20 63 61 6e 20 65 64 69 74 20 74 68 You can edit th
0490: 65 20 63 6f 6d 6d 61 6e 64 2c 20 66 6f 72 20 65 e command, for e
04a0: 78 61 6d 70 6c 65 20 63 68 61 6e 67 65 20 74 68 xample change th
04b0: 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 2d 74 e argument to -t
04c0: 65 73 74 70 61 74 74 20 74 6f 20 22 25 22 20 74 estpatt to "%" t
04d0: 6f 20 72 65 6d 6f 76 65 20 61 6c 6c 20 74 65 73 o remove all tes
04e0: 74 73 2e 0d 0a 0d 0a 2e 52 65 6d 6f 76 65 20 74 ts......Remove t
04f0: 68 65 20 74 65 73 74 20 64 69 73 6b 70 65 72 66 he test diskperf
0500: 20 61 6e 64 20 61 6c 6c 20 69 74 27 73 20 69 74 and all it's it
0510: 65 6d 73 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ems..-----------
0520: 2d 2d 2d 2d 2d 0d 0a 6d 65 67 61 74 65 73 74 20 -----..megatest
0530: 2d 72 65 6d 6f 76 65 2d 72 75 6e 73 20 2d 74 61 -remove-runs -ta
0540: 72 67 65 74 20 75 62 75 6e 74 75 2f 6e 66 73 2f rget ubuntu/nfs/
0550: 6e 6f 6e 65 20 2d 72 75 6e 6e 61 6d 65 20 77 77 none -runname ww
0560: 32 38 2e 31 61 20 2d 74 65 73 74 70 61 74 74 20 28.1a -testpatt
0570: 64 69 73 6b 70 65 72 66 2f 25 20 2d 76 0d 0a 2d diskperf/% -v..-
0580: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d ---------------.
0590: 0a 0d 0a 2e 52 65 6d 6f 76 65 20 61 6c 6c 20 74 ....Remove all t
05a0: 65 73 74 73 20 66 6f 72 20 61 6c 6c 20 72 75 6e ests for all run
05b0: 73 20 61 6e 64 20 61 6c 6c 20 74 61 72 67 65 74 s and all target
05c0: 73 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s..-------------
05d0: 2d 2d 2d 0d 0a 6d 65 67 61 74 65 73 74 20 2d 72 ---..megatest -r
05e0: 65 6d 6f 76 65 2d 72 75 6e 73 20 2d 74 61 72 67 emove-runs -targ
05f0: 65 74 20 25 2f 25 2f 25 20 2d 72 75 6e 6e 61 6d et %/%/% -runnam
0600: 65 20 25 20 2d 74 65 73 74 70 61 74 74 20 25 20 e % -testpatt %
0610: 2d 76 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d -v..------------
0620: 2d 2d 2d 2d 0d 0a 0d 0a 41 72 63 68 69 76 65 20 ----....Archive
0630: 52 75 6e 73 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e Runs..^^^^^^^^^^
0640: 5e 5e 0d 0a 0d 0a 4d 65 67 61 74 65 73 74 20 73 ^^....Megatest s
0650: 75 70 70 6f 72 74 73 20 75 73 69 6e 67 20 74 68 upports using th
0660: 65 20 62 75 70 20 62 61 63 6b 75 70 20 74 6f 6f e bup backup too
0670: 6c 20 28 68 74 74 70 73 3a 2f 2f 62 75 70 2e 67 l (https://bup.g
0680: 69 74 68 75 62 2e 69 6f 2f 29 20 74 6f 20 61 72 ithub.io/) to ar
0690: 63 68 69 76 65 20 79 6f 75 72 20 74 65 73 74 73 chive your tests
06a0: 20 66 6f 72 20 65 66 66 69 63 69 65 6e 74 20 73 for efficient s
06b0: 74 6f 72 61 67 65 0d 0a 61 6e 64 20 72 65 74 72 torage..and retr
06c0: 69 65 76 61 6c 2e 20 41 72 63 68 69 76 65 64 20 ieval. Archived
06d0: 64 61 74 61 20 63 61 6e 20 62 65 20 72 61 70 69 data can be rapi
06e0: 64 6c 79 20 72 65 74 72 69 65 76 65 64 20 69 66 dly retrieved if
06f0: 20 6e 65 65 64 65 64 2e 20 54 68 65 20 6d 65 74 needed. The met
0700: 61 64 61 74 61 20 66 6f 72 20 74 68 65 20 72 75 adata for the ru
0710: 6e 20 28 50 41 53 53 2f 46 41 49 4c 20 73 74 61 n (PASS/FAIL sta
0720: 74 75 73 2c 20 72 75 6e 20 0d 0a 64 75 72 61 74 tus, run ..durat
0730: 69 6f 6e 73 2c 20 74 69 6d 65 20 73 74 61 6d 70 ions, time stamp
0740: 73 20 65 74 63 2e 29 20 61 72 65 20 61 6c 6c 20 s etc.) are all
0750: 70 72 65 73 65 72 76 65 64 20 69 6e 20 74 68 65 preserved in the
0760: 20 6d 65 67 61 74 65 73 74 20 64 61 74 61 62 61 megatest databa
0770: 73 65 2e 0d 0a 0d 0a 46 6f 72 20 73 65 74 75 70 se.....For setup
0780: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 65 65 information see
0790: 20 74 68 65 20 41 72 63 68 69 76 69 6e 67 20 74 the Archiving t
07a0: 6f 70 69 63 20 69 6e 20 74 68 65 20 72 65 66 65 opic in the refe
07b0: 72 65 6e 63 65 20 73 65 63 74 69 6f 6e 20 6f 66 rence section of
07c0: 20 74 68 69 73 20 6d 61 6e 75 61 6c 2e 0d 0a 0d this manual....
07d0: 0a 54 6f 20 41 72 63 68 69 76 65 0d 0a 2b 2b 2b .To Archive..+++
07e0: 2b 2b 2b 2b 2b 2b 2b 0d 0a 0d 0a 48 69 6e 74 3a +++++++....Hint:
07f0: 20 75 73 65 20 74 68 65 20 74 65 73 74 20 63 6f use the test co
0800: 6e 74 72 6f 6c 20 70 61 6e 65 6c 20 74 6f 20 63 ntrol panel to c
0810: 72 65 61 74 65 20 61 20 74 65 6d 70 6c 61 74 65 reate a template
0820: 20 63 6f 6d 6d 61 6e 64 20 62 79 20 70 75 73 68 command by push
0830: 69 6e 67 20 74 68 65 20 22 41 72 63 68 69 76 65 ing the "Archive
0840: 20 54 65 73 74 73 22 20 62 75 74 74 6f 6e 2e 0d Tests" button..
0850: 0a 0d 0a 2e 41 72 63 68 69 76 65 20 61 20 66 75 ....Archive a fu
0860: 6c 6c 20 72 75 6e 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d ll run..--------
0870: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 6d 65 67 61 74 65 --------..megate
0880: 73 74 20 2d 74 61 72 67 65 74 20 75 62 75 6e 74 st -target ubunt
0890: 75 2f 6e 66 73 2f 6e 6f 6e 65 20 2d 72 75 6e 6e u/nfs/none -runn
08a0: 61 6d 65 20 77 77 32 38 2e 31 61 20 2d 61 72 63 ame ww28.1a -arc
08b0: 68 69 76 65 20 73 61 76 65 2d 72 65 6d 6f 76 65 hive save-remove
08c0: 20 2d 74 65 73 74 70 61 74 74 20 25 0d 0a 2d 2d -testpatt %..--
08d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a --------------..
08e0: 0d 0a 54 6f 20 52 65 73 74 6f 72 65 0d 0a 2b 2b ..To Restore..++
08f0: 2b 2b 2b 2b 2b 2b 2b 2b 0d 0a 0d 0a 2e 52 65 74 ++++++++.....Ret
0900: 72 69 65 76 65 20 61 20 73 69 6e 67 6c 65 20 74 rieve a single t
0910: 65 73 74 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d est..-----------
0920: 2d 2d 2d 2d 2d 0d 0a 6d 65 67 61 74 65 73 74 20 -----..megatest
0930: 2d 74 61 72 67 65 74 20 75 62 75 6e 74 75 2f 6e -target ubuntu/n
0940: 66 73 2f 6e 6f 6e 65 20 2d 72 75 6e 6e 61 6d 65 fs/none -runname
0950: 20 77 77 32 38 2e 31 61 20 2d 61 72 63 68 69 76 ww28.1a -archiv
0960: 65 20 72 65 73 74 6f 72 65 20 2d 74 65 73 74 70 e restore -testp
0970: 61 74 74 20 64 69 73 6b 70 65 72 66 2f 25 0d 0a att diskperf/%..
0980: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0990: 0d 0a 0d 0a 48 69 6e 74 3a 20 59 6f 75 20 63 61 ....Hint: You ca
09a0: 6e 20 62 72 6f 77 73 65 20 74 68 65 20 61 72 63 n browse the arc
09b0: 68 69 76 65 20 75 73 69 6e 67 20 62 75 70 20 63 hive using bup c
09c0: 6f 6d 6d 61 6e 64 73 20 64 69 72 65 63 74 6c 79 ommands directly
09d0: 2e 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .....-----------
09e0: 2d 2d 2d 2d 2d 0d 0a 62 75 70 20 2d 64 20 2f 70 -----..bup -d /p
09f0: 61 74 68 2f 74 6f 2f 62 75 70 2f 61 72 63 68 69 ath/to/bup/archi
0a00: 76 65 20 66 74 70 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d ve ftp..--------
0a10: 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 53 75 62 6d --------....Subm
0a20: 69 74 20 6a 6f 62 73 20 74 6f 20 48 6f 73 74 20 it jobs to Host
0a30: 54 79 70 65 73 20 62 61 73 65 64 20 6f 6e 20 54 Types based on T
0a40: 65 73 74 20 4e 61 6d 65 0d 0a 7e 7e 7e 7e 7e 7e est Name..~~~~~~
0a50: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0a60: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0a70: 7e 7e 7e 7e 7e 7e 0d 0a 0d 0a 2e 49 6e 20 6d 65 ~~~~~~.....In me
0a80: 67 61 74 65 73 74 2e 63 6f 6e 66 69 67 0d 0a 2d gatest.config..-
0a90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0aa0: 2d 2d 2d 2d 2d 2d 2d 0d 0a 5b 68 6f 73 74 2d 74 -------..[host-t
0ab0: 79 70 65 73 5d 0d 0a 67 65 6e 65 72 61 6c 20 73 ypes]..general s
0ac0: 73 68 20 23 7b 67 65 74 62 67 65 73 74 68 6f 73 sh #{getbgesthos
0ad0: 74 20 67 65 6e 65 72 61 6c 7d 0d 0a 6e 62 67 65 t general}..nbge
0ae0: 6e 65 72 61 6c 20 6e 62 6a 6f 62 20 72 75 6e 20 neral nbjob run
0af0: 4a 4f 42 43 4f 4d 4d 41 4e 44 20 2d 6c 6f 67 20 JOBCOMMAND -log
0b00: 24 4d 54 5f 4c 49 4e 4b 54 52 45 45 2f 24 4d 54 $MT_LINKTREE/$MT
0b10: 5f 54 41 52 47 45 54 2f 24 4d 54 5f 52 55 4e 4e _TARGET/$MT_RUNN
0b20: 41 4d 45 2e 24 4d 54 5f 54 45 53 54 4e 41 4d 45 AME.$MT_TESTNAME
0b30: 2d 24 4d 54 5f 49 54 45 4d 5f 50 41 54 48 2e 6c -$MT_ITEM_PATH.l
0b40: 67 6f 0d 0a 0d 0a 5b 68 6f 73 74 73 5d 0d 0a 67 go....[hosts]..g
0b50: 65 6e 65 72 61 6c 20 63 75 62 69 61 6e 20 78 65 eneral cubian xe
0b60: 6e 61 0d 0a 0d 0a 5b 6c 61 75 6e 63 68 65 72 73 na....[launchers
0b70: 5d 0d 0a 65 6e 76 73 65 74 75 70 20 67 65 6e 65 ]..envsetup gene
0b80: 72 61 6c 0d 0a 78 6f 72 2f 25 2f 6e 20 34 43 31 ral..xor/%/n 4C1
0b90: 36 47 0d 0a 25 20 6e 62 67 65 6e 65 72 61 6c 0d 6G..% nbgeneral.
0ba0: 0a 0d 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0d 0a 6c ...[jobtools]..l
0bb0: 61 75 6e 63 68 65 72 20 62 73 75 62 0d 0a 23 20 auncher bsub..#
0bc0: 69 66 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e if defined and n
0bd0: 6f 74 20 22 6e 6f 22 20 66 6c 65 78 69 2d 6c 61 ot "no" flexi-la
0be0: 75 6e 63 68 65 72 20 77 69 6c 6c 20 62 79 70 61 uncher will bypa
0bf0: 73 73 20 6c 61 75 6e 63 68 65 72 20 75 6e 6c 65 ss launcher unle
0c00: 73 73 20 74 68 65 72 65 20 69 73 20 6e 6f 0d 0a ss there is no..
0c10: 23 20 6d 61 74 63 68 2e 0d 0a 66 6c 65 78 69 2d # match...flexi-
0c20: 6c 61 75 6e 63 68 65 72 20 79 65 73 0d 0a 2d 2d launcher yes..--
0c30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0c40: 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 54 72 69 63 6b 73 ------....Tricks
0c50: 0d 0a 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 54 68 69 73 ..------....This
0c60: 20 73 65 63 74 69 6f 6e 20 69 73 20 61 20 63 6f section is a co
0c70: 6d 70 65 6e 64 69 75 6d 20 6f 66 20 61 20 76 61 mpendium of a va
0c80: 72 69 6f 75 73 20 75 73 65 66 75 6c 20 74 72 69 rious useful tri
0c90: 63 6b 73 20 66 6f 72 20 64 65 62 75 67 67 69 6e cks for debuggin
0ca0: 67 2c 0d 0a 63 6f 6e 66 69 67 75 72 69 6e 67 20 g,..configuring
0cb0: 61 6e 64 20 67 65 6e 65 72 61 6c 6c 79 20 67 65 and generally ge
0cc0: 74 74 69 6e 67 20 74 68 65 20 6d 6f 73 74 20 6f tting the most o
0cd0: 75 74 20 6f 66 20 4d 65 67 61 74 65 73 74 2e 0d ut of Megatest..
0ce0: 0a 0d 0a 4c 69 6d 69 74 69 6e 67 20 79 6f 75 72 ...Limiting your
0cf0: 20 72 75 6e 6e 69 6e 67 20 6a 6f 62 73 0d 0a 7e running jobs..~
0d00: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0d10: 7e 7e 7e 7e 7e 7e 7e 7e 7e 0d 0a 0d 0a 54 68 65 ~~~~~~~~~....The
0d20: 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 following examp
0d30: 6c 65 20 77 69 6c 6c 20 6c 69 6d 69 74 20 61 20 le will limit a
0d40: 74 65 73 74 20 69 6e 20 74 68 65 20 6a 6f 62 67 test in the jobg
0d50: 72 6f 75 70 20 22 67 72 6f 75 70 31 22 20 74 6f roup "group1" to
0d60: 20 6e 6f 20 6d 6f 72 65 20 74 68 61 6e 20 31 30 no more than 10
0d70: 20 74 65 73 74 73 20 73 69 6d 75 6c 74 61 6e 65 tests simultane
0d80: 6f 75 73 6c 79 2e 0d 0a 0d 0a 49 6e 20 79 6f 75 ously.....In you
0d90: 72 20 74 65 73 74 63 6f 6e 66 69 67 3a 0d 0a 0d r testconfig:...
0da0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0db0: 2d 0d 0a 5b 74 65 73 74 5f 6d 65 74 61 5d 0d 0a -..[test_meta]..
0dc0: 6a 6f 62 67 72 6f 75 70 20 67 72 6f 75 70 31 0d jobgroup group1.
0dd0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0de0: 2d 0d 0a 0d 0a 49 6e 20 79 6f 75 72 20 6d 65 67 -....In your meg
0df0: 61 74 65 73 74 2e 63 6f 6e 66 69 67 3a 0d 0a 0d atest.config:...
0e00: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0e10: 0d 0a 5b 6a 6f 62 67 72 6f 75 70 73 5d 0d 0a 67 ..[jobgroups]..g
0e20: 72 6f 75 70 31 20 31 30 0d 0a 63 75 73 74 64 65 roup1 10..custde
0e30: 73 20 34 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d s 4..-----------
0e40: 2d 2d 2d 2d 0d 0a 0d 0a 44 65 62 75 67 67 69 6e ----....Debuggin
0e50: 67 20 54 72 69 63 6b 73 0d 0a 2d 2d 2d 2d 2d 2d g Tricks..------
0e60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 45 78 ----------....Ex
0e70: 61 6d 69 6e 69 6e 67 20 54 68 65 20 45 6e 76 69 amining The Envi
0e80: 72 6f 6e 6d 65 6e 74 0d 0a 7e 7e 7e 7e 7e 7e 7e ronment..~~~~~~~
0e90: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0ea0: 7e 7e 0d 0a 0d 0a 54 65 73 74 20 43 6f 6e 74 72 ~~....Test Contr
0eb0: 6f 6c 20 50 61 6e 65 6c 20 2d 20 78 74 65 72 6d ol Panel - xterm
0ec0: 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ..^^^^^^^^^^^^^^
0ed0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 0d 0a 0d 0a ^^^^^^^^^^^^....
0ee0: 46 72 6f 6d 20 74 68 65 20 64 61 73 68 62 6f 61 From the dashboa
0ef0: 72 64 20 63 6c 69 63 6b 20 6f 6e 20 61 20 74 65 rd click on a te
0f00: 73 74 20 50 41 53 53 2f 46 41 49 4c 20 62 75 74 st PASS/FAIL but
0f10: 74 6f 6e 2e 20 54 68 69 73 20 62 72 69 6e 67 73 ton. This brings
0f20: 20 75 70 20 61 20 74 65 73 74 20 63 6f 6e 74 72 up a test contr
0f30: 6f 6c 20 70 61 6e 65 6c 2e 20 41 70 72 6f 78 69 ol panel. Aproxi
0f40: 6d 61 74 65 6c 79 20 6e 65 61 72 20 74 68 65 20 mately near the
0f50: 63 65 6e 74 65 72 20 6c 65 66 74 20 6f 66 20 74 center left of t
0f60: 68 65 20 0d 0a 77 69 6e 64 6f 77 20 74 68 65 72 he ..window ther
0f70: 65 20 69 73 20 61 20 62 75 74 74 6f 6e 20 22 53 e is a button "S
0f80: 74 61 72 74 20 58 74 65 72 6d 22 2e 20 50 75 73 tart Xterm". Pus
0f90: 68 20 74 68 69 73 20 74 6f 20 67 65 74 20 61 6e h this to get an
0fa0: 20 78 74 65 72 6d 20 77 69 74 68 20 74 68 65 20 xterm with the
0fb0: 66 75 6c 6c 20 63 6f 6e 74 65 78 74 20 61 6e 64 full context and
0fc0: 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 6c 6f 61 environment loa
0fd0: 64 65 64 20 66 6f 72 20 74 68 61 74 20 74 65 73 ded for that tes
0fe0: 74 2e 20 59 6f 75 20 63 61 6e 20 72 75 6e 0d 0a t. You can run..
0ff0: 73 63 72 69 70 74 73 20 6f 72 20 65 7a 73 74 65 scripts or ezste
1000: 70 73 20 62 79 20 63 6f 70 79 69 6e 67 20 66 72 ps by copying fr
1010: 6f 6d 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 om the testconfi
1020: 67 20 28 68 69 6e 74 2c 20 6c 6f 61 64 20 75 70 g (hint, load up
1030: 20 74 68 65 20 74 65 73 74 63 6f 6e 66 69 67 20 the testconfig
1040: 69 6e 20 61 20 73 65 70 61 72 61 74 65 20 67 76 in a separate gv
1050: 69 6d 20 6f 72 20 65 6d 61 63 73 20 77 69 6e 64 im or emacs wind
1060: 6f 77 29 2e 20 54 68 69 73 20 69 73 20 74 68 65 ow). This is the
1070: 20 65 61 73 69 65 73 74 20 77 61 79 0d 0a 74 6f easiest way..to
1080: 20 64 65 62 75 67 20 79 6f 75 72 20 74 65 73 74 debug your test
1090: 73 2e 0d 0a 0d 0a 44 75 72 69 6e 67 20 43 6f 6e s.....During Con
10a0: 66 69 67 20 46 69 6c 65 20 50 72 6f 63 65 73 73 fig File Process
10b0: 69 6e 67 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ing..^^^^^^^^^^^
10c0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
10d0: 5e 5e 0d 0a 0d 0a 49 74 20 69 73 20 6f 66 74 65 ^^....It is ofte
10e0: 6e 20 68 65 6c 70 66 75 6c 20 74 6f 20 6b 6e 6f n helpful to kno
10f0: 77 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 w the content of
1100: 20 76 61 72 69 61 62 6c 65 73 20 69 6e 20 76 61 variables in va
1110: 72 69 6f 75 73 0d 0a 63 6f 6e 74 65 78 74 73 20 rious..contexts
1120: 61 73 20 4d 65 67 61 74 65 73 74 20 64 6f 65 73 as Megatest does
1130: 20 74 68 65 20 61 63 74 69 6f 6e 73 20 6e 65 65 the actions nee
1140: 64 65 64 20 74 6f 20 72 75 6e 20 79 6f 75 72 20 ded to run your
1150: 74 65 73 74 73 2e 20 41 20 68 61 6e 64 79 20 74 tests. A handy t
1160: 65 63 68 6e 69 71 75 65 20 69 73 20 74 6f 20 66 echnique is to f
1170: 6f 72 63 65 20 74 68 65 20 73 74 61 72 74 75 70 orce the startup
1180: 20 6f 66 20 61 6e 20 78 74 65 72 6d 20 69 6e 20 of an xterm in
1190: 74 68 65 20 63 6f 6e 74 65 78 74 20 62 65 69 6e the context bein
11a0: 67 20 65 78 61 6d 69 6e 65 64 2e 0d 0a 0d 0a 46 g examined.....F
11b0: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 or example, if a
11c0: 6e 20 69 74 65 6d 20 6c 69 73 74 20 69 73 20 6e n item list is n
11d0: 6f 74 20 62 65 69 6e 67 20 67 65 6e 65 72 61 74 ot being generat
11e0: 65 64 20 61 73 20 65 78 70 65 63 74 65 64 20 79 ed as expected y
11f0: 6f 75 0d 0a 63 61 6e 20 69 6e 6a 65 63 74 20 74 ou..can inject t
1200: 68 65 20 73 74 61 72 74 75 70 20 6f 66 20 61 6e he startup of an
1210: 20 78 74 65 72 6d 20 61 73 20 69 66 20 69 74 20 xterm as if it
1220: 77 65 72 65 20 61 6e 20 69 74 65 6d 3a 0d 0a 0d were an item:...
1230: 0a 2e 4f 72 69 67 69 6e 61 6c 20 69 74 65 6d 73 ..Original items
1240: 20 74 61 62 6c 65 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d table..--------
1250: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 5b 69 74 65 6d ---------..[item
1260: 73 5d 0d 0a 43 45 4c 4c 4e 41 4d 45 20 5b 73 79 s]..CELLNAME [sy
1270: 73 74 65 6d 20 67 65 74 63 65 6c 6c 6e 61 6d 65 stem getcellname
1280: 2e 73 68 5d 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .sh]..----------
1290: 2d 2d 2d 2d 2d 2d 2d 0d 0a 0d 0a 2e 49 74 65 6d -------.....Item
12a0: 73 20 74 61 62 6c 65 20 6d 6f 64 69 66 69 65 64 s table modified
12b0: 20 66 6f 72 20 64 65 62 75 67 0d 0a 2d 2d 2d 2d for debug..----
12c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 5b -------------..[
12d0: 69 74 65 6d 73 5d 0d 0a 44 45 42 55 47 20 5b 73 items]..DEBUG [s
12e0: 79 73 74 65 6d 20 78 74 65 72 6d 5d 0d 0a 43 45 ystem xterm]..CE
12f0: 4c 4c 4e 41 4d 45 20 5b 73 79 73 74 65 6d 20 67 LLNAME [system g
1300: 65 74 63 65 6c 6c 6e 61 6d 65 73 2e 73 68 5d 0d etcellnames.sh].
1310: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
1320: 2d 2d 0d 0a 0d 0a 57 68 65 6e 20 74 68 69 73 20 --....When this
1330: 74 65 73 74 20 69 73 20 72 75 6e 20 61 6e 20 78 test is run an x
1340: 74 65 72 6d 20 77 69 6c 6c 20 70 6f 70 20 75 70 term will pop up
1350: 2e 20 49 6e 20 74 68 61 74 20 78 74 65 72 6d 20 . In that xterm
1360: 74 68 65 0d 0a 65 6e 76 69 72 6f 6e 6d 65 6e 74 the..environment
1370: 20 69 73 20 65 78 61 63 74 6c 79 20 74 68 61 74 is exactly that
1380: 20 69 6e 20 77 68 69 63 68 20 74 68 65 20 73 63 in which the sc
1390: 72 69 70 74 20 22 67 65 74 63 65 6c 6c 6e 61 6d ript "getcellnam
13a0: 65 73 2e 73 68 22 0d 0a 77 6f 75 6c 64 20 72 75 es.sh"..would ru
13b0: 6e 2e 20 59 6f 75 20 63 61 6e 20 6e 6f 77 20 64 n. You can now d
13c0: 65 62 75 67 20 74 68 65 20 73 63 72 69 70 74 20 ebug the script
13d0: 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 79 20 to find out why
13e0: 69 74 20 69 73 6e 27 74 0d 0a 77 6f 72 6b 69 6e it isn't..workin
13f0: 67 20 61 73 20 65 78 70 65 63 74 65 64 2e 0d 0a g as expected...
1400: 0d 0a 4f 72 67 61 6e 69 73 69 6e 67 20 59 6f 75 ..Organising You
1410: 72 20 54 65 73 74 73 20 61 6e 64 20 54 61 73 6b r Tests and Task
1420: 73 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e s..^^^^^^^^^^^^^
1430: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
1440: 5e 5e 0d 0a 0d 0a 54 68 65 20 64 65 66 61 75 6c ^^....The defaul
1450: 74 20 6c 6f 63 61 74 69 6f 6e 20 22 74 65 73 74 t location "test
1460: 73 22 20 66 6f 72 20 73 74 6f 72 69 6e 67 20 74 s" for storing t
1470: 65 73 74 73 20 63 61 6e 20 62 65 20 65 78 74 65 ests can be exte
1480: 6e 64 65 64 20 62 79 0d 0a 61 64 64 69 6e 67 20 nded by..adding
1490: 74 6f 20 79 6f 75 72 20 74 65 73 74 73 2d 70 61 to your tests-pa
14a0: 74 68 73 20 73 65 63 74 69 6f 6e 2e 0d 0a 0d 0a ths section.....
14b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
14c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0d 0a 5b 6d ------------..[m
14d0: 69 73 63 5d 0d 0a 70 61 72 65 6e 74 20 23 7b 73 isc]..parent #{s
14e0: 68 65 6c 6c 20 64 69 72 6e 61 6d 65 20 24 28 72 hell dirname $(r
14f0: 65 61 64 6c 69 6e 6b 20 2d 66 20 2e 29 7d 0d 0a eadlink -f .)}..
1500: 0d 0a 5b 74 65 73 74 73 2d 70 61 74 68 73 5d 0d ..[tests-paths].
1510: 0a 31 20 23 7b 67 65 74 20 6d 69 73 63 20 70 61 .1 #{get misc pa
1520: 72 65 6e 74 7d 2f 73 69 6d 70 6c 65 72 75 6e 2f rent}/simplerun/
1530: 74 65 73 74 73 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d tests..---------
1540: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1550: 2d 2d 2d 0d 0a 0d 0a 54 68 65 20 61 62 6f 76 65 ---....The above
1560: 20 65 78 61 6d 70 6c 65 20 73 68 6f 77 73 20 68 example shows h
1570: 6f 77 20 79 6f 75 20 63 61 6e 20 75 73 65 20 61 ow you can use a
1580: 64 64 69 74 69 6f 6e 20 73 65 63 74 69 6f 6e 73 ddition sections
1590: 20 69 6e 20 79 6f 75 72 0d 0a 63 6f 6e 66 69 67 in your..config
15a0: 20 66 69 6c 65 20 74 6f 20 64 6f 20 63 6f 6d 70 file to do comp
15b0: 6c 65 78 20 70 72 6f 63 65 73 73 69 6e 67 2e 20 lex processing.
15c0: 42 79 20 70 75 74 74 69 6e 67 20 72 65 73 75 6c By putting resul
15d0: 74 73 20 6f 66 20 72 65 6c 61 74 69 76 65 6c 79 ts of relatively
15e0: 0d 0a 73 6c 6f 77 20 6f 70 65 72 61 74 69 6f 6e ..slow operation
15f0: 73 20 69 6e 74 6f 20 76 61 72 69 61 62 6c 65 73 s into variables
1600: 20 74 68 65 20 70 72 6f 63 65 73 73 69 6e 67 20 the processing
1610: 6f 66 20 79 6f 75 72 20 63 6f 6e 66 69 67 73 20 of your configs
1620: 63 61 6e 20 62 65 0d 0a 6b 65 70 74 20 66 61 73 can be..kept fas
1630: 74 2e 0d 0a 0d 0a 41 6c 74 65 72 6e 61 74 69 76 t.....Alternativ
1640: 65 20 4d 65 74 68 6f 64 20 66 6f 72 20 52 75 6e e Method for Run
1650: 6e 69 6e 67 20 79 6f 75 72 20 4a 6f 62 20 53 63 ning your Job Sc
1660: 72 69 70 74 0d 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ript..^^^^^^^^^^
1670: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
1680: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
1690: 5e 5e 5e 5e 0d 0a 0d 0a 2e 44 69 72 65 63 74 6c ^^^^.....Directl
16a0: 79 20 72 75 6e 6e 69 6e 67 20 6a 6f 62 20 69 6e y running job in
16b0: 20 74 65 73 74 63 6f 6e 66 69 67 0d 0a 2d 2d 2d testconfig..---
16c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
16d0: 0d 0a 5b 73 65 74 75 70 5d 0d 0a 72 75 6e 73 63 ..[setup]..runsc
16e0: 72 69 70 74 20 6d 61 69 6e 2e 63 73 68 0d 0a 2d ript main.csh..-
16f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1700: 2d 2d 0d 0a 0d 0a 54 68 65 20 72 75 6e 73 63 72 --....The runscr
1710: 69 70 74 20 6d 65 74 68 6f 64 20 69 73 20 65 73 ipt method is es
1720: 73 65 6e 74 69 61 6c 6c 79 20 61 20 62 72 75 74 sentially a brut
1730: 65 20 66 6f 72 63 65 20 77 61 79 20 74 6f 20 72 e force way to r
1740: 75 6e 20 73 63 72 69 70 74 73 20 77 68 65 72 65 un scripts where
1750: 20 74 68 65 0d 0a 75 73 65 72 20 69 73 20 72 65 the..user is re
1760: 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 73 65 sponsible for se
1770: 74 74 69 6e 67 20 53 54 41 54 45 20 61 6e 64 20 tting STATE and
1780: 53 54 41 54 55 53 20 61 6e 64 20 6d 61 6e 61 67 STATUS and manag
1790: 69 6e 67 20 74 68 65 20 64 65 74 61 69 6c 73 20 ing the details
17a0: 6f 66 20 72 75 6e 6e 69 6e 67 20 61 20 74 65 73 of running a tes
17b0: 74 2e 20 0d 0a 0d 0a 44 65 62 75 67 67 69 6e 67 t. ....Debugging
17c0: 20 53 65 72 76 65 72 20 50 72 6f 62 6c 65 6d 73 Server Problems
17d0: 0d 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ..~~~~~~~~~~~~~~
17e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0d 0a 0d 0a 53 ~~~~~~~~~~~....S
17f0: 6f 6d 65 20 68 61 6e 64 79 20 55 6e 69 78 20 63 ome handy Unix c
1800: 6f 6d 6d 61 6e 64 73 20 74 6f 20 74 72 61 63 6b ommands to track
1810: 20 64 6f 77 6e 20 69 73 73 75 65 73 20 77 69 74 down issues wit
1820: 68 20 73 65 72 76 65 72 73 20 6e 6f 74 0d 0a 63 h servers not..c
1830: 6f 6d 6d 75 6e 69 63 61 74 69 6e 67 20 77 69 74 ommunicating wit
1840: 68 20 79 6f 75 72 20 74 65 73 74 20 6d 61 6e 61 h your test mana
1850: 67 65 72 20 70 72 6f 63 65 73 73 65 73 2e 20 50 ger processes. P
1860: 6c 65 61 73 65 20 70 75 74 20 69 6e 20 74 69 63 lease put in tic
1870: 6b 65 74 73 0d 0a 61 74 20 68 74 74 70 73 3a 2f kets..at https:/
1880: 2f 77 77 77 2e 6b 69 61 74 6f 61 2e 63 6f 6d 2f /www.kiatoa.com/
1890: 66 6f 73 73 69 6c 73 2f 6d 65 67 61 74 65 73 74 fossils/megatest
18a0: 20 69 66 20 79 6f 75 20 68 61 76 65 20 70 72 6f if you have pro
18b0: 62 6c 65 6d 73 20 77 69 74 68 0d 0a 73 65 72 76 blems with..serv
18c0: 65 72 73 20 67 65 74 74 69 6e 67 20 73 74 75 63 ers getting stuc
18d0: 6b 2e 0d 0a 0d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d k.....----------
18e0: 2d 2d 2d 2d 2d 2d 0d 0a 73 75 64 6f 20 6c 73 6f ------..sudo lso
18f0: 66 20 2d 69 0d 0a 73 75 64 6f 20 6e 65 74 73 74 f -i..sudo netst
1900: 61 74 20 2d 6c 70 74 75 0d 0a 73 75 64 6f 20 6e at -lptu..sudo n
1910: 65 74 73 74 61 74 20 2d 74 75 6c 70 6e 0d 0a 2d etstat -tulpn..-
1920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1930: 0a 5a 20 36 66 37 36 34 31 63 66 36 31 36 35 65 .Z 6f7641cf6165e
1940: 65 66 30 65 62 63 64 39 63 39 63 32 32 38 33 39 ef0ebcd9c9c22839
1950: 62 30 37 0a b07.