Artifact
ed8f2e030696f3ede24e3cc86f0236bce8efdb4d:
Wiki page
[howto] by
mrwellan
2018-01-30 11:12:22.
0000: 44 20 32 30 31 38 2d 30 31 2d 33 30 54 31 38 3a D 2018-01-30T18:
0010: 31 32 3a 32 32 2e 38 32 31 0a 4c 20 68 6f 77 74 12:22.821.L howt
0020: 6f 0a 50 20 63 65 34 38 39 33 35 65 36 61 37 31 o.P ce48935e6a71
0030: 30 35 34 63 31 62 33 64 38 34 64 36 39 66 64 66 054c1b3d84d69fdf
0040: 31 65 37 61 31 36 62 66 38 33 63 39 0a 55 20 6d 1e7a16bf83c9.U m
0050: 72 77 65 6c 6c 61 6e 0a 57 20 35 34 33 36 0a 0a rwellan.W 5436..
0060: 48 6f 77 20 54 6f 20 44 6f 20 54 68 69 6e 67 73 How To Do Things
0070: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
0080: 2d 0a 0a 50 72 6f 63 65 73 73 20 52 75 6e 73 0a -..Process Runs.
0090: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 52 65 ~~~~~~~~~~~~..Re
00a0: 6d 6f 76 65 20 52 75 6e 73 0a 5e 5e 5e 5e 5e 5e move Runs.^^^^^^
00b0: 5e 5e 5e 5e 5e 0a 0a 46 72 6f 6d 20 74 68 65 20 ^^^^^..From the
00c0: 64 61 73 68 62 6f 61 72 64 20 63 6c 69 63 6b 20 dashboard click
00d0: 6f 6e 20 74 68 65 20 62 75 74 74 6f 6e 20 28 50 on the button (P
00e0: 41 53 53 2f 46 41 49 4c 2e 2e 2e 29 20 66 6f 72 ASS/FAIL...) for
00f0: 20 6f 6e 65 20 6f 66 20 74 68 65 20 74 65 73 74 one of the test
0100: 73 2e 20 46 72 6f 6d 20 74 68 65 20 74 65 73 74 s. From the test
0110: 20 63 6f 6e 74 72 6f 6c 20 70 61 6e 65 6c 20 74 control panel t
0120: 68 61 74 20 0a 63 6f 6d 65 73 20 75 70 20 70 75 hat .comes up pu
0130: 73 68 20 74 68 65 20 63 6c 65 61 6e 20 74 65 73 sh the clean tes
0140: 74 20 62 75 74 74 6f 6e 2e 20 54 68 65 20 63 6f t button. The co
0150: 6d 6d 61 6e 64 20 66 69 65 6c 64 20 77 69 6c 6c mmand field will
0160: 20 62 65 20 70 72 65 66 69 6c 6c 65 64 20 77 69 be prefilled wi
0170: 74 68 20 61 20 74 65 6d 70 6c 61 74 65 20 63 6f th a template co
0180: 6d 6d 61 6e 64 20 66 6f 72 20 72 65 6d 6f 76 69 mmand for removi
0190: 6e 67 20 0a 74 68 61 74 20 74 65 73 74 2e 20 59 ng .that test. Y
01a0: 6f 75 20 63 61 6e 20 65 64 69 74 20 74 68 65 20 ou can edit the
01b0: 63 6f 6d 6d 61 6e 64 2c 20 66 6f 72 20 65 78 61 command, for exa
01c0: 6d 70 6c 65 20 63 68 61 6e 67 65 20 74 68 65 20 mple change the
01d0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 2d 74 65 73 argument to -tes
01e0: 74 70 61 74 74 20 74 6f 20 22 25 22 20 74 6f 20 tpatt to "%" to
01f0: 72 65 6d 6f 76 65 20 61 6c 6c 20 74 65 73 74 73 remove all tests
0200: 2e 0a 0a 2e 52 65 6d 6f 76 65 20 74 68 65 20 74 ....Remove the t
0210: 65 73 74 20 64 69 73 6b 70 65 72 66 20 61 6e 64 est diskperf and
0220: 20 61 6c 6c 20 69 74 27 73 20 69 74 65 6d 73 0a all it's items.
0230: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0240: 0a 6d 65 67 61 74 65 73 74 20 2d 72 65 6d 6f 76 .megatest -remov
0250: 65 2d 72 75 6e 73 20 2d 74 61 72 67 65 74 20 75 e-runs -target u
0260: 62 75 6e 74 75 2f 6e 66 73 2f 6e 6f 6e 65 20 2d buntu/nfs/none -
0270: 72 75 6e 6e 61 6d 65 20 77 77 32 38 2e 31 61 20 runname ww28.1a
0280: 2d 74 65 73 74 70 61 74 74 20 64 69 73 6b 70 65 -testpatt diskpe
0290: 72 66 2f 25 20 2d 76 0a 2d 2d 2d 2d 2d 2d 2d 2d rf/% -v.--------
02a0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 52 65 6d 6f 76 --------...Remov
02b0: 65 20 61 6c 6c 20 74 65 73 74 73 20 66 6f 72 20 e all tests for
02c0: 61 6c 6c 20 72 75 6e 73 20 61 6e 64 20 61 6c 6c all runs and all
02d0: 20 74 61 72 67 65 74 73 0a 2d 2d 2d 2d 2d 2d 2d targets.-------
02e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 6d 65 67 61 74 65 ---------.megate
02f0: 73 74 20 2d 72 65 6d 6f 76 65 2d 72 75 6e 73 20 st -remove-runs
0300: 2d 74 61 72 67 65 74 20 25 2f 25 2f 25 20 2d 72 -target %/%/% -r
0310: 75 6e 6e 61 6d 65 20 25 20 2d 74 65 73 74 70 61 unname % -testpa
0320: 74 74 20 25 20 2d 76 0a 2d 2d 2d 2d 2d 2d 2d 2d tt % -v.--------
0330: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 41 72 63 68 69 76 --------..Archiv
0340: 65 20 52 75 6e 73 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e e Runs.^^^^^^^^^
0350: 5e 5e 5e 0a 0a 4d 65 67 61 74 65 73 74 20 73 75 ^^^..Megatest su
0360: 70 70 6f 72 74 73 20 75 73 69 6e 67 20 74 68 65 pports using the
0370: 20 62 75 70 20 62 61 63 6b 75 70 20 74 6f 6f 6c bup backup tool
0380: 20 28 68 74 74 70 73 3a 2f 2f 62 75 70 2e 67 69 (https://bup.gi
0390: 74 68 75 62 2e 69 6f 2f 29 20 74 6f 20 61 72 63 thub.io/) to arc
03a0: 68 69 76 65 20 79 6f 75 72 20 74 65 73 74 73 20 hive your tests
03b0: 66 6f 72 20 65 66 66 69 63 69 65 6e 74 20 73 74 for efficient st
03c0: 6f 72 61 67 65 0a 61 6e 64 20 72 65 74 72 69 65 orage.and retrie
03d0: 76 61 6c 2e 20 41 72 63 68 69 76 65 64 20 64 61 val. Archived da
03e0: 74 61 20 63 61 6e 20 62 65 20 72 61 70 69 64 6c ta can be rapidl
03f0: 79 20 72 65 74 72 69 65 76 65 64 20 69 66 20 6e y retrieved if n
0400: 65 65 64 65 64 2e 20 54 68 65 20 6d 65 74 61 64 eeded. The metad
0410: 61 74 61 20 66 6f 72 20 74 68 65 20 72 75 6e 20 ata for the run
0420: 28 50 41 53 53 2f 46 41 49 4c 20 73 74 61 74 75 (PASS/FAIL statu
0430: 73 2c 20 72 75 6e 20 0a 64 75 72 61 74 69 6f 6e s, run .duration
0440: 73 2c 20 74 69 6d 65 20 73 74 61 6d 70 73 20 65 s, time stamps e
0450: 74 63 2e 29 20 61 72 65 20 61 6c 6c 20 70 72 65 tc.) are all pre
0460: 73 65 72 76 65 64 20 69 6e 20 74 68 65 20 6d 65 served in the me
0470: 67 61 74 65 73 74 20 64 61 74 61 62 61 73 65 2e gatest database.
0480: 0a 0a 46 6f 72 20 73 65 74 75 70 20 69 6e 66 6f ..For setup info
0490: 72 6d 61 74 69 6f 6e 20 73 65 65 20 74 68 65 20 rmation see the
04a0: 41 72 63 68 69 76 69 6e 67 20 74 6f 70 69 63 20 Archiving topic
04b0: 69 6e 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 in the reference
04c0: 20 73 65 63 74 69 6f 6e 20 6f 66 20 74 68 69 73 section of this
04d0: 20 6d 61 6e 75 61 6c 2e 0a 0a 54 6f 20 41 72 63 manual...To Arc
04e0: 68 69 76 65 0a 2b 2b 2b 2b 2b 2b 2b 2b 2b 2b 0a hive.++++++++++.
04f0: 0a 48 69 6e 74 3a 20 75 73 65 20 74 68 65 20 74 .Hint: use the t
0500: 65 73 74 20 63 6f 6e 74 72 6f 6c 20 70 61 6e 65 est control pane
0510: 6c 20 74 6f 20 63 72 65 61 74 65 20 61 20 74 65 l to create a te
0520: 6d 70 6c 61 74 65 20 63 6f 6d 6d 61 6e 64 20 62 mplate command b
0530: 79 20 70 75 73 68 69 6e 67 20 74 68 65 20 22 41 y pushing the "A
0540: 72 63 68 69 76 65 20 54 65 73 74 73 22 20 62 75 rchive Tests" bu
0550: 74 74 6f 6e 2e 0a 0a 2e 41 72 63 68 69 76 65 20 tton....Archive
0560: 61 20 66 75 6c 6c 20 72 75 6e 0a 2d 2d 2d 2d 2d a full run.-----
0570: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 6d 65 67 61 -----------.mega
0580: 74 65 73 74 20 2d 74 61 72 67 65 74 20 75 62 75 test -target ubu
0590: 6e 74 75 2f 6e 66 73 2f 6e 6f 6e 65 20 2d 72 75 ntu/nfs/none -ru
05a0: 6e 6e 61 6d 65 20 77 77 32 38 2e 31 61 20 2d 61 nname ww28.1a -a
05b0: 72 63 68 69 76 65 20 73 61 76 65 2d 72 65 6d 6f rchive save-remo
05c0: 76 65 20 2d 74 65 73 74 70 61 74 74 20 25 0a 2d ve -testpatt %.-
05d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
05e0: 0a 54 6f 20 52 65 73 74 6f 72 65 0a 2b 2b 2b 2b .To Restore.++++
05f0: 2b 2b 2b 2b 2b 2b 0a 0a 2e 52 65 74 72 69 65 76 ++++++...Retriev
0600: 65 20 61 20 73 69 6e 67 6c 65 20 74 65 73 74 0a e a single test.
0610: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0620: 0a 6d 65 67 61 74 65 73 74 20 2d 74 61 72 67 65 .megatest -targe
0630: 74 20 75 62 75 6e 74 75 2f 6e 66 73 2f 6e 6f 6e t ubuntu/nfs/non
0640: 65 20 2d 72 75 6e 6e 61 6d 65 20 77 77 32 38 2e e -runname ww28.
0650: 31 61 20 2d 61 72 63 68 69 76 65 20 72 65 73 74 1a -archive rest
0660: 6f 72 65 20 2d 74 65 73 74 70 61 74 74 20 64 69 ore -testpatt di
0670: 73 6b 70 65 72 66 2f 25 0a 2d 2d 2d 2d 2d 2d 2d skperf/%.-------
0680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 48 69 6e 74 3a ---------..Hint:
0690: 20 59 6f 75 20 63 61 6e 20 62 72 6f 77 73 65 20 You can browse
06a0: 74 68 65 20 61 72 63 68 69 76 65 20 75 73 69 6e the archive usin
06b0: 67 20 62 75 70 20 63 6f 6d 6d 61 6e 64 73 20 64 g bup commands d
06c0: 69 72 65 63 74 6c 79 2e 0a 0a 2d 2d 2d 2d 2d 2d irectly...------
06d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 62 75 70 20 2d ----------.bup -
06e0: 64 20 2f 70 61 74 68 2f 74 6f 2f 62 75 70 2f 61 d /path/to/bup/a
06f0: 72 63 68 69 76 65 20 66 74 70 0a 2d 2d 2d 2d 2d rchive ftp.-----
0700: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 53 75 62 -----------..Sub
0710: 6d 69 74 20 6a 6f 62 73 20 74 6f 20 48 6f 73 74 mit jobs to Host
0720: 20 54 79 70 65 73 20 62 61 73 65 64 20 6f 6e 20 Types based on
0730: 54 65 73 74 20 4e 61 6d 65 0a 7e 7e 7e 7e 7e 7e Test Name.~~~~~~
0740: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0750: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
0760: 7e 7e 7e 7e 7e 7e 0a 0a 2e 49 6e 20 6d 65 67 61 ~~~~~~...In mega
0770: 74 65 73 74 2e 63 6f 6e 66 69 67 0a 2d 2d 2d 2d test.config.----
0780: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0790: 2d 2d 2d 2d 0a 5b 68 6f 73 74 2d 74 79 70 65 73 ----.[host-types
07a0: 5d 0a 67 65 6e 65 72 61 6c 20 73 73 68 20 23 7b ].general ssh #{
07b0: 67 65 74 62 67 65 73 74 68 6f 73 74 20 67 65 6e getbgesthost gen
07c0: 65 72 61 6c 7d 0a 6e 62 67 65 6e 65 72 61 6c 20 eral}.nbgeneral
07d0: 6e 62 6a 6f 62 20 72 75 6e 20 4a 4f 42 43 4f 4d nbjob run JOBCOM
07e0: 4d 41 4e 44 20 2d 6c 6f 67 20 24 4d 54 5f 4c 49 MAND -log $MT_LI
07f0: 4e 4b 54 52 45 45 2f 24 4d 54 5f 54 41 52 47 45 NKTREE/$MT_TARGE
0800: 54 2f 24 4d 54 5f 52 55 4e 4e 41 4d 45 2e 24 4d T/$MT_RUNNAME.$M
0810: 54 5f 54 45 53 54 4e 41 4d 45 2d 24 4d 54 5f 49 T_TESTNAME-$MT_I
0820: 54 45 4d 5f 50 41 54 48 2e 6c 67 6f 0a 0a 5b 68 TEM_PATH.lgo..[h
0830: 6f 73 74 73 5d 0a 67 65 6e 65 72 61 6c 20 63 75 osts].general cu
0840: 62 69 61 6e 20 78 65 6e 61 0a 0a 5b 6c 61 75 6e bian xena..[laun
0850: 63 68 65 72 73 5d 0a 65 6e 76 73 65 74 75 70 20 chers].envsetup
0860: 67 65 6e 65 72 61 6c 0a 78 6f 72 2f 25 2f 6e 20 general.xor/%/n
0870: 34 43 31 36 47 0a 25 20 6e 62 67 65 6e 65 72 61 4C16G.% nbgenera
0880: 6c 0a 0a 5b 6a 6f 62 74 6f 6f 6c 73 5d 0a 6c 61 l..[jobtools].la
0890: 75 6e 63 68 65 72 20 62 73 75 62 0a 23 20 69 66 uncher bsub.# if
08a0: 20 64 65 66 69 6e 65 64 20 61 6e 64 20 6e 6f 74 defined and not
08b0: 20 22 6e 6f 22 20 66 6c 65 78 69 2d 6c 61 75 6e "no" flexi-laun
08c0: 63 68 65 72 20 77 69 6c 6c 20 62 79 70 61 73 73 cher will bypass
08d0: 20 6c 61 75 6e 63 68 65 72 20 75 6e 6c 65 73 73 launcher unless
08e0: 20 74 68 65 72 65 20 69 73 20 6e 6f 0a 23 20 6d there is no.# m
08f0: 61 74 63 68 2e 0a 66 6c 65 78 69 2d 6c 61 75 6e atch..flexi-laun
0900: 63 68 65 72 20 79 65 73 0a 2d 2d 2d 2d 2d 2d 2d cher yes.-------
0910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0920: 2d 0a 0a 54 72 69 63 6b 73 0a 2d 2d 2d 2d 2d 2d -..Tricks.------
0930: 0a 0a 54 68 69 73 20 73 65 63 74 69 6f 6e 20 69 ..This section i
0940: 73 20 61 20 63 6f 6d 70 65 6e 64 69 75 6d 20 6f s a compendium o
0950: 66 20 61 20 76 61 72 69 6f 75 73 20 75 73 65 66 f a various usef
0960: 75 6c 20 74 72 69 63 6b 73 20 66 6f 72 20 64 65 ul tricks for de
0970: 62 75 67 67 69 6e 67 2c 0a 63 6f 6e 66 69 67 75 bugging,.configu
0980: 72 69 6e 67 20 61 6e 64 20 67 65 6e 65 72 61 6c ring and general
0990: 6c 79 20 67 65 74 74 69 6e 67 20 74 68 65 20 6d ly getting the m
09a0: 6f 73 74 20 6f 75 74 20 6f 66 20 4d 65 67 61 74 ost out of Megat
09b0: 65 73 74 2e 0a 0a 4c 69 6d 69 74 69 6e 67 20 79 est...Limiting y
09c0: 6f 75 72 20 72 75 6e 6e 69 6e 67 20 6a 6f 62 73 our running jobs
09d0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
09e0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 ~~~~~~~~~~~..The
09f0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 61 6d 70 following examp
0a00: 6c 65 20 77 69 6c 6c 20 6c 69 6d 69 74 20 61 20 le will limit a
0a10: 74 65 73 74 20 69 6e 20 74 68 65 20 6a 6f 62 67 test in the jobg
0a20: 72 6f 75 70 20 22 67 72 6f 75 70 31 22 20 74 6f roup "group1" to
0a30: 20 6e 6f 20 6d 6f 72 65 20 74 68 61 6e 20 31 30 no more than 10
0a40: 20 74 65 73 74 73 20 73 69 6d 75 6c 74 61 6e 65 tests simultane
0a50: 6f 75 73 6c 79 2e 0a 0a 49 6e 20 79 6f 75 72 20 ously...In your
0a60: 74 65 73 74 63 6f 6e 66 69 67 3a 0a 0a 2d 2d 2d testconfig:..---
0a70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 74 -------------.[t
0a80: 65 73 74 5f 6d 65 74 61 5d 0a 6a 6f 62 67 72 6f est_meta].jobgro
0a90: 75 70 20 67 72 6f 75 70 31 0a 2d 2d 2d 2d 2d 2d up group1.------
0aa0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 49 6e 20 79 ----------..In y
0ab0: 6f 75 72 20 6d 65 67 61 74 65 73 74 2e 63 6f 6e our megatest.con
0ac0: 66 69 67 3a 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d fig:..----------
0ad0: 2d 2d 2d 2d 2d 0a 5b 6a 6f 62 67 72 6f 75 70 73 -----.[jobgroups
0ae0: 5d 0a 67 72 6f 75 70 31 20 31 30 0a 63 75 73 74 ].group1 10.cust
0af0: 64 65 73 20 34 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d des 4.----------
0b00: 2d 2d 2d 2d 2d 0a 0a 44 65 62 75 67 67 69 6e 67 -----..Debugging
0b10: 20 54 72 69 63 6b 73 0a 2d 2d 2d 2d 2d 2d 2d 2d Tricks.--------
0b20: 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 45 78 61 6d 69 6e --------..Examin
0b30: 69 6e 67 20 54 68 65 20 45 6e 76 69 72 6f 6e 6d ing The Environm
0b40: 65 6e 74 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ent.~~~~~~~~~~~~
0b50: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 ~~~~~~~~~~~~~..T
0b60: 65 73 74 20 43 6f 6e 74 72 6f 6c 20 50 61 6e 65 est Control Pane
0b70: 6c 20 2d 20 78 74 65 72 6d 0a 5e 5e 5e 5e 5e 5e l - xterm.^^^^^^
0b80: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0b90: 5e 5e 5e 5e 0a 0a 46 72 6f 6d 20 74 68 65 20 64 ^^^^..From the d
0ba0: 61 73 68 62 6f 61 72 64 20 63 6c 69 63 6b 20 6f ashboard click o
0bb0: 6e 20 61 20 74 65 73 74 20 50 41 53 53 2f 46 41 n a test PASS/FA
0bc0: 49 4c 20 62 75 74 74 6f 6e 2e 20 54 68 69 73 20 IL button. This
0bd0: 62 72 69 6e 67 73 20 75 70 20 61 20 74 65 73 74 brings up a test
0be0: 20 63 6f 6e 74 72 6f 6c 20 70 61 6e 65 6c 2e 20 control panel.
0bf0: 41 70 72 6f 78 69 6d 61 74 65 6c 79 20 6e 65 61 Aproximately nea
0c00: 72 20 74 68 65 20 63 65 6e 74 65 72 20 6c 65 66 r the center lef
0c10: 74 20 6f 66 20 74 68 65 20 0a 77 69 6e 64 6f 77 t of the .window
0c20: 20 74 68 65 72 65 20 69 73 20 61 20 62 75 74 74 there is a butt
0c30: 6f 6e 20 22 53 74 61 72 74 20 58 74 65 72 6d 22 on "Start Xterm"
0c40: 2e 20 50 75 73 68 20 74 68 69 73 20 74 6f 20 67 . Push this to g
0c50: 65 74 20 61 6e 20 78 74 65 72 6d 20 77 69 74 68 et an xterm with
0c60: 20 74 68 65 20 66 75 6c 6c 20 63 6f 6e 74 65 78 the full contex
0c70: 74 20 61 6e 64 20 65 6e 76 69 72 6f 6e 6d 65 6e t and environmen
0c80: 74 20 6c 6f 61 64 65 64 20 66 6f 72 20 74 68 61 t loaded for tha
0c90: 74 20 74 65 73 74 2e 20 59 6f 75 20 63 61 6e 20 t test. You can
0ca0: 72 75 6e 0a 73 63 72 69 70 74 73 20 6f 72 20 65 run.scripts or e
0cb0: 7a 73 74 65 70 73 20 62 79 20 63 6f 70 79 69 6e zsteps by copyin
0cc0: 67 20 66 72 6f 6d 20 74 68 65 20 74 65 73 74 63 g from the testc
0cd0: 6f 6e 66 69 67 20 28 68 69 6e 74 2c 20 6c 6f 61 onfig (hint, loa
0ce0: 64 20 75 70 20 74 68 65 20 74 65 73 74 63 6f 6e d up the testcon
0cf0: 66 69 67 20 69 6e 20 61 20 73 65 70 61 72 61 74 fig in a separat
0d00: 65 20 67 76 69 6d 20 6f 72 20 65 6d 61 63 73 20 e gvim or emacs
0d10: 77 69 6e 64 6f 77 29 2e 20 54 68 69 73 20 69 73 window). This is
0d20: 20 74 68 65 20 65 61 73 69 65 73 74 20 77 61 79 the easiest way
0d30: 0a 74 6f 20 64 65 62 75 67 20 79 6f 75 72 20 74 .to debug your t
0d40: 65 73 74 73 2e 0a 0a 44 75 72 69 6e 67 20 43 6f ests...During Co
0d50: 6e 66 69 67 20 46 69 6c 65 20 50 72 6f 63 65 73 nfig File Proces
0d60: 73 69 6e 67 0a 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e sing.^^^^^^^^^^^
0d70: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
0d80: 5e 5e 0a 0a 49 74 20 69 73 20 6f 66 74 65 6e 20 ^^..It is often
0d90: 68 65 6c 70 66 75 6c 20 74 6f 20 6b 6e 6f 77 20 helpful to know
0da0: 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 76 the content of v
0db0: 61 72 69 61 62 6c 65 73 20 69 6e 20 76 61 72 69 ariables in vari
0dc0: 6f 75 73 0a 63 6f 6e 74 65 78 74 73 20 61 73 20 ous.contexts as
0dd0: 4d 65 67 61 74 65 73 74 20 64 6f 65 73 20 74 68 Megatest does th
0de0: 65 20 61 63 74 69 6f 6e 73 20 6e 65 65 64 65 64 e actions needed
0df0: 20 74 6f 20 72 75 6e 20 79 6f 75 72 20 74 65 73 to run your tes
0e00: 74 73 2e 20 41 20 68 61 6e 64 79 20 74 65 63 68 ts. A handy tech
0e10: 6e 69 71 75 65 20 69 73 20 74 6f 20 66 6f 72 63 nique is to forc
0e20: 65 20 74 68 65 20 73 74 61 72 74 75 70 20 6f 66 e the startup of
0e30: 20 61 6e 20 78 74 65 72 6d 20 69 6e 20 74 68 65 an xterm in the
0e40: 20 63 6f 6e 74 65 78 74 20 62 65 69 6e 67 20 65 context being e
0e50: 78 61 6d 69 6e 65 64 2e 0a 0a 46 6f 72 20 65 78 xamined...For ex
0e60: 61 6d 70 6c 65 2c 20 69 66 20 61 6e 20 69 74 65 ample, if an ite
0e70: 6d 20 6c 69 73 74 20 69 73 20 6e 6f 74 20 62 65 m list is not be
0e80: 69 6e 67 20 67 65 6e 65 72 61 74 65 64 20 61 73 ing generated as
0e90: 20 65 78 70 65 63 74 65 64 20 79 6f 75 0a 63 61 expected you.ca
0ea0: 6e 20 69 6e 6a 65 63 74 20 74 68 65 20 73 74 61 n inject the sta
0eb0: 72 74 75 70 20 6f 66 20 61 6e 20 78 74 65 72 6d rtup of an xterm
0ec0: 20 61 73 20 69 66 20 69 74 20 77 65 72 65 20 61 as if it were a
0ed0: 6e 20 69 74 65 6d 3a 0a 0a 2e 4f 72 69 67 69 6e n item:...Origin
0ee0: 61 6c 20 69 74 65 6d 73 20 74 61 62 6c 65 0a 2d al items table.-
0ef0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0f00: 0a 5b 69 74 65 6d 73 5d 0a 43 45 4c 4c 4e 41 4d .[items].CELLNAM
0f10: 45 20 5b 73 79 73 74 65 6d 20 67 65 74 63 65 6c E [system getcel
0f20: 6c 6e 61 6d 65 2e 73 68 5d 0a 2d 2d 2d 2d 2d 2d lname.sh].------
0f30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 2e 49 74 -----------...It
0f40: 65 6d 73 20 74 61 62 6c 65 20 6d 6f 64 69 66 69 ems table modifi
0f50: 65 64 20 66 6f 72 20 64 65 62 75 67 0a 2d 2d 2d ed for debug.---
0f60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b --------------.[
0f70: 69 74 65 6d 73 5d 0a 44 45 42 55 47 20 5b 73 79 items].DEBUG [sy
0f80: 73 74 65 6d 20 78 74 65 72 6d 5d 0a 43 45 4c 4c stem xterm].CELL
0f90: 4e 41 4d 45 20 5b 73 79 73 74 65 6d 20 67 65 74 NAME [system get
0fa0: 63 65 6c 6c 6e 61 6d 65 73 2e 73 68 5d 0a 2d 2d cellnames.sh].--
0fb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0fc0: 0a 57 68 65 6e 20 74 68 69 73 20 74 65 73 74 20 .When this test
0fd0: 69 73 20 72 75 6e 20 61 6e 20 78 74 65 72 6d 20 is run an xterm
0fe0: 77 69 6c 6c 20 70 6f 70 20 75 70 2e 20 49 6e 20 will pop up. In
0ff0: 74 68 61 74 20 78 74 65 72 6d 20 74 68 65 0a 65 that xterm the.e
1000: 6e 76 69 72 6f 6e 6d 65 6e 74 20 69 73 20 65 78 nvironment is ex
1010: 61 63 74 6c 79 20 74 68 61 74 20 69 6e 20 77 68 actly that in wh
1020: 69 63 68 20 74 68 65 20 73 63 72 69 70 74 20 22 ich the script "
1030: 67 65 74 63 65 6c 6c 6e 61 6d 65 73 2e 73 68 22 getcellnames.sh"
1040: 0a 77 6f 75 6c 64 20 72 75 6e 2e 20 59 6f 75 20 .would run. You
1050: 63 61 6e 20 6e 6f 77 20 64 65 62 75 67 20 74 68 can now debug th
1060: 65 20 73 63 72 69 70 74 20 74 6f 20 66 69 6e 64 e script to find
1070: 20 6f 75 74 20 77 68 79 20 69 74 20 69 73 6e 27 out why it isn'
1080: 74 0a 77 6f 72 6b 69 6e 67 20 61 73 20 65 78 70 t.working as exp
1090: 65 63 74 65 64 2e 0a 0a 4f 72 67 61 6e 69 73 69 ected...Organisi
10a0: 6e 67 20 59 6f 75 72 20 54 65 73 74 73 20 61 6e ng Your Tests an
10b0: 64 20 54 61 73 6b 73 0a 5e 5e 5e 5e 5e 5e 5e 5e d Tasks.^^^^^^^^
10c0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
10d0: 5e 5e 5e 5e 5e 5e 5e 0a 0a 54 68 65 20 64 65 66 ^^^^^^^..The def
10e0: 61 75 6c 74 20 6c 6f 63 61 74 69 6f 6e 20 22 74 ault location "t
10f0: 65 73 74 73 22 20 66 6f 72 20 73 74 6f 72 69 6e ests" for storin
1100: 67 20 74 65 73 74 73 20 63 61 6e 20 62 65 20 65 g tests can be e
1110: 78 74 65 6e 64 65 64 20 62 79 0a 61 64 64 69 6e xtended by.addin
1120: 67 20 74 6f 20 79 6f 75 72 20 74 65 73 74 73 2d g to your tests-
1130: 70 61 74 68 73 20 73 65 63 74 69 6f 6e 2e 0a 0a paths section...
1140: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1150: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 5b 6d 69 ------------.[mi
1160: 73 63 5d 0a 70 61 72 65 6e 74 20 23 7b 73 68 65 sc].parent #{she
1170: 6c 6c 20 64 69 72 6e 61 6d 65 20 24 28 72 65 61 ll dirname $(rea
1180: 64 6c 69 6e 6b 20 2d 66 20 2e 29 7d 0a 0a 5b 74 dlink -f .)}..[t
1190: 65 73 74 73 2d 70 61 74 68 73 5d 0a 31 20 23 7b ests-paths].1 #{
11a0: 67 65 74 20 6d 69 73 63 20 70 61 72 65 6e 74 7d get misc parent}
11b0: 2f 73 69 6d 70 6c 65 72 75 6e 2f 74 65 73 74 73 /simplerun/tests
11c0: 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .---------------
11d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 -------------..T
11e0: 68 65 20 61 62 6f 76 65 20 65 78 61 6d 70 6c 65 he above example
11f0: 20 73 68 6f 77 73 20 68 6f 77 20 79 6f 75 20 63 shows how you c
1200: 61 6e 20 75 73 65 20 61 64 64 69 74 69 6f 6e 20 an use addition
1210: 73 65 63 74 69 6f 6e 73 20 69 6e 20 79 6f 75 72 sections in your
1220: 0a 63 6f 6e 66 69 67 20 66 69 6c 65 20 74 6f 20 .config file to
1230: 64 6f 20 63 6f 6d 70 6c 65 78 20 70 72 6f 63 65 do complex proce
1240: 73 73 69 6e 67 2e 20 42 79 20 70 75 74 74 69 6e ssing. By puttin
1250: 67 20 72 65 73 75 6c 74 73 20 6f 66 20 72 65 6c g results of rel
1260: 61 74 69 76 65 6c 79 0a 73 6c 6f 77 20 6f 70 65 atively.slow ope
1270: 72 61 74 69 6f 6e 73 20 69 6e 74 6f 20 76 61 72 rations into var
1280: 69 61 62 6c 65 73 20 74 68 65 20 70 72 6f 63 65 iables the proce
1290: 73 73 69 6e 67 20 6f 66 20 79 6f 75 72 20 63 6f ssing of your co
12a0: 6e 66 69 67 73 20 63 61 6e 20 62 65 0a 6b 65 70 nfigs can be.kep
12b0: 74 20 66 61 73 74 2e 0a 0a 41 6c 74 65 72 6e 61 t fast...Alterna
12c0: 74 69 76 65 20 4d 65 74 68 6f 64 20 66 6f 72 20 tive Method for
12d0: 52 75 6e 6e 69 6e 67 20 79 6f 75 72 20 4a 6f 62 Running your Job
12e0: 20 53 63 72 69 70 74 0a 5e 5e 5e 5e 5e 5e 5e 5e Script.^^^^^^^^
12f0: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
1300: 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e 5e ^^^^^^^^^^^^^^^^
1310: 5e 5e 5e 5e 5e 5e 0a 0a 2e 44 69 72 65 63 74 6c ^^^^^^...Directl
1320: 79 20 72 75 6e 6e 69 6e 67 20 6a 6f 62 20 69 6e y running job in
1330: 20 74 65 73 74 63 6f 6e 66 69 67 0a 2d 2d 2d 2d testconfig.----
1340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
1350: 5b 73 65 74 75 70 5d 0a 72 75 6e 73 63 72 69 70 [setup].runscrip
1360: 74 20 6d 61 69 6e 2e 63 73 68 0a 2d 2d 2d 2d 2d t main.csh.-----
1370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a --------------..
1380: 54 68 65 20 72 75 6e 73 63 72 69 70 74 20 6d 65 The runscript me
1390: 74 68 6f 64 20 69 73 20 65 73 73 65 6e 74 69 61 thod is essentia
13a0: 6c 6c 79 20 61 20 62 72 75 74 65 20 66 6f 72 63 lly a brute forc
13b0: 65 20 77 61 79 20 74 6f 20 72 75 6e 20 73 63 72 e way to run scr
13c0: 69 70 74 73 20 77 68 65 72 65 20 74 68 65 0a 75 ipts where the.u
13d0: 73 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62 ser is responsib
13e0: 6c 65 20 66 6f 72 20 73 65 74 74 69 6e 67 20 53 le for setting S
13f0: 54 41 54 45 20 61 6e 64 20 53 54 41 54 55 53 20 TATE and STATUS
1400: 61 6e 64 20 6d 61 6e 61 67 69 6e 67 20 74 68 65 and managing the
1410: 20 64 65 74 61 69 6c 73 20 6f 66 20 72 75 6e 6e details of runn
1420: 69 6e 67 20 61 20 74 65 73 74 2e 20 0a 0a 44 65 ing a test. ..De
1430: 62 75 67 67 69 6e 67 20 53 65 72 76 65 72 20 50 bugging Server P
1440: 72 6f 62 6c 65 6d 73 0a 7e 7e 7e 7e 7e 7e 7e 7e roblems.~~~~~~~~
1450: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~~
1460: 7e 0a 0a 53 6f 6d 65 20 68 61 6e 64 79 20 55 6e ~..Some handy Un
1470: 69 78 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 74 ix commands to t
1480: 72 61 63 6b 20 64 6f 77 6e 20 69 73 73 75 65 73 rack down issues
1490: 20 77 69 74 68 20 73 65 72 76 65 72 73 20 6e 6f with servers no
14a0: 74 0a 63 6f 6d 6d 75 6e 69 63 61 74 69 6e 67 20 t.communicating
14b0: 77 69 74 68 20 79 6f 75 72 20 74 65 73 74 20 6d with your test m
14c0: 61 6e 61 67 65 72 20 70 72 6f 63 65 73 73 65 73 anager processes
14d0: 2e 20 50 6c 65 61 73 65 20 70 75 74 20 69 6e 20 . Please put in
14e0: 74 69 63 6b 65 74 73 0a 61 74 20 68 74 74 70 73 tickets.at https
14f0: 3a 2f 2f 77 77 77 2e 6b 69 61 74 6f 61 2e 63 6f ://www.kiatoa.co
1500: 6d 2f 66 6f 73 73 69 6c 73 2f 6d 65 67 61 74 65 m/fossils/megate
1510: 73 74 20 69 66 20 79 6f 75 20 68 61 76 65 20 70 st if you have p
1520: 72 6f 62 6c 65 6d 73 20 77 69 74 68 0a 73 65 72 roblems with.ser
1530: 76 65 72 73 20 67 65 74 74 69 6e 67 20 73 74 75 vers getting stu
1540: 63 6b 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ck...-----------
1550: 2d 2d 2d 2d 2d 0a 73 75 64 6f 20 6c 73 6f 66 20 -----.sudo lsof
1560: 2d 69 0a 73 75 64 6f 20 6e 65 74 73 74 61 74 20 -i.sudo netstat
1570: 2d 6c 70 74 75 0a 73 75 64 6f 20 6e 65 74 73 74 -lptu.sudo netst
1580: 61 74 20 2d 74 75 6c 70 6e 0a 2d 2d 2d 2d 2d 2d at -tulpn.------
1590: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 5a 20 61 62 ----------..Z ab
15a0: 61 31 37 37 61 65 38 66 62 63 37 63 37 61 39 32 a177ae8fbc7c7a92
15b0: 34 30 30 39 64 65 38 33 30 33 30 38 36 65 0a 4009de8303086e.