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