Artifact
15718f423c27dd7d311fdf97a3fd42269be293fb:
0000: 54 68 65 20 4d 65 67 61 74 65 73 74 20 55 73 65 The Megatest Use
0010: 72 73 20 4d 61 6e 75 61 6c 0a 3d 3d 3d 3d 3d 3d rs Manual.======
0020: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0030: 3d 3d 3d 0a 4d 61 74 74 20 57 65 6c 6c 61 6e 64 ===.Matt Welland
0040: 20 3c 6d 61 74 74 40 6b 69 61 74 6f 61 2e 63 6f <matt@kiatoa.co
0050: 6d 3e 0a 76 31 2e 35 2c 20 4a 75 6e 65 20 32 30 m>.v1.5, June 20
0060: 32 30 0a 3a 64 6f 63 74 79 70 65 3a 20 62 6f 6f 20.:doctype: boo
0070: 6b 0a 0a 0a 5b 70 72 65 66 61 63 65 5d 0a 50 72 k...[preface].Pr
0080: 65 66 61 63 65 0a 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 eface.-------..T
0090: 68 69 73 20 62 6f 6f 6b 20 69 73 20 6f 72 67 61 his book is orga
00a0: 6e 69 73 65 64 20 61 73 20 74 68 72 65 65 20 73 nised as three s
00b0: 75 62 2d 62 6f 6f 6b 73 3b 20 67 65 74 74 69 6e ub-books; gettin
00c0: 67 20 73 74 61 72 74 65 64 2c 20 77 72 69 74 69 g started, writi
00d0: 6e 67 20 74 65 73 74 73 20 61 6e 64 20 72 65 66 ng tests and ref
00e0: 65 72 65 6e 63 65 2e 0a 0a 2e 4c 69 63 65 6e 73 erence....Licens
00f0: 65 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d e.--------------
0100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 --------------.
0110: 20 20 20 43 6f 70 79 72 69 67 68 74 20 32 30 30 Copyright 200
0120: 36 2d 32 30 32 30 2c 20 4d 61 74 74 68 65 77 20 6-2020, Matthew
0130: 57 65 6c 6c 61 6e 64 2e 0a 0a 20 20 20 20 54 68 Welland... Th
0140: 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 70 is document is p
0150: 61 72 74 20 6f 66 20 4d 65 67 61 74 65 73 74 2e art of Megatest.
0160: 0a 0a 20 20 20 20 4d 65 67 61 74 65 73 74 20 69 .. Megatest i
0170: 73 20 66 72 65 65 20 73 6f 66 74 77 61 72 65 3a s free software:
0180: 20 79 6f 75 20 63 61 6e 20 72 65 64 69 73 74 72 you can redistr
0190: 69 62 75 74 65 20 69 74 20 61 6e 64 2f 6f 72 20 ibute it and/or
01a0: 6d 6f 64 69 66 79 0a 20 20 20 20 69 74 20 75 6e modify. it un
01b0: 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 6f 66 der the terms of
01c0: 20 74 68 65 20 47 4e 55 20 47 65 6e 65 72 61 6c the GNU General
01d0: 20 50 75 62 6c 69 63 20 4c 69 63 65 6e 73 65 20 Public License
01e0: 61 73 20 70 75 62 6c 69 73 68 65 64 20 62 79 0a as published by.
01f0: 20 20 20 20 74 68 65 20 46 72 65 65 20 53 6f 66 the Free Sof
0200: 74 77 61 72 65 20 46 6f 75 6e 64 61 74 69 6f 6e tware Foundation
0210: 2c 20 65 69 74 68 65 72 20 76 65 72 73 69 6f 6e , either version
0220: 20 33 20 6f 66 20 74 68 65 20 4c 69 63 65 6e 73 3 of the Licens
0230: 65 2c 20 6f 72 0a 20 20 20 20 28 61 74 20 79 6f e, or. (at yo
0240: 75 72 20 6f 70 74 69 6f 6e 29 20 61 6e 79 20 6c ur option) any l
0250: 61 74 65 72 20 76 65 72 73 69 6f 6e 2e 0a 0a 20 ater version...
0260: 20 20 20 4d 65 67 61 74 65 73 74 20 69 73 20 64 Megatest is d
0270: 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 74 68 istributed in th
0280: 65 20 68 6f 70 65 20 74 68 61 74 20 69 74 20 77 e hope that it w
0290: 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2c 0a 20 ill be useful,.
02a0: 20 20 20 62 75 74 20 57 49 54 48 4f 55 54 20 41 but WITHOUT A
02b0: 4e 59 20 57 41 52 52 41 4e 54 59 3b 20 77 69 74 NY WARRANTY; wit
02c0: 68 6f 75 74 20 65 76 65 6e 20 74 68 65 20 69 6d hout even the im
02d0: 70 6c 69 65 64 20 77 61 72 72 61 6e 74 79 20 6f plied warranty o
02e0: 66 0a 20 20 20 20 4d 45 52 43 48 41 4e 54 41 42 f. MERCHANTAB
02f0: 49 4c 49 54 59 20 6f 72 20 46 49 54 4e 45 53 53 ILITY or FITNESS
0300: 20 46 4f 52 20 41 20 50 41 52 54 49 43 55 4c 41 FOR A PARTICULA
0310: 52 20 50 55 52 50 4f 53 45 2e 20 20 53 65 65 20 R PURPOSE. See
0320: 74 68 65 0a 20 20 20 20 47 4e 55 20 47 65 6e 65 the. GNU Gene
0330: 72 61 6c 20 50 75 62 6c 69 63 20 4c 69 63 65 6e ral Public Licen
0340: 73 65 20 66 6f 72 20 6d 6f 72 65 20 64 65 74 61 se for more deta
0350: 69 6c 73 2e 0a 0a 20 20 20 20 59 6f 75 20 73 68 ils... You sh
0360: 6f 75 6c 64 20 68 61 76 65 20 72 65 63 65 69 76 ould have receiv
0370: 65 64 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 ed a copy of the
0380: 20 47 4e 55 20 47 65 6e 65 72 61 6c 20 50 75 62 GNU General Pub
0390: 6c 69 63 20 4c 69 63 65 6e 73 65 0a 20 20 20 20 lic License.
03a0: 61 6c 6f 6e 67 20 77 69 74 68 20 4d 65 67 61 74 along with Megat
03b0: 65 73 74 2e 20 20 49 66 20 6e 6f 74 2c 20 73 65 est. If not, se
03c0: 65 20 3c 68 74 74 70 3a 2f 2f 77 77 77 2e 67 6e e <http://www.gn
03d0: 75 2e 6f 72 67 2f 6c 69 63 65 6e 73 65 73 2f 3e u.org/licenses/>
03e0: 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ...-------------
03f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0400: 0a 57 68 79 20 4d 65 67 61 74 65 73 74 3f 0a 2d .Why Megatest?.-
0410: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 ------------..Th
0420: 65 20 4d 65 67 61 74 65 73 74 20 70 72 6f 6a 65 e Megatest proje
0430: 63 74 20 77 61 73 20 73 74 61 72 74 65 64 20 66 ct was started f
0440: 6f 72 20 74 77 6f 20 72 65 61 73 6f 6e 73 2c 20 or two reasons,
0450: 74 68 65 20 66 69 72 73 74 20 77 61 73 20 61 6e the first was an
0460: 0a 69 6d 6d 65 64 69 61 74 65 20 61 6e 64 20 70 .immediate and p
0470: 72 65 73 73 69 6e 67 20 6e 65 65 64 20 66 6f 72 ressing need for
0480: 20 61 20 67 65 6e 65 72 61 6c 69 7a 65 64 20 74 a generalized t
0490: 6f 6f 6c 20 74 6f 20 6d 61 6e 61 67 65 20 61 20 ool to manage a
04a0: 73 75 69 74 65 0a 6f 66 20 72 65 67 72 65 73 73 suite.of regress
04b0: 69 6f 6e 20 74 65 73 74 73 20 61 6e 64 20 74 68 ion tests and th
04c0: 65 20 73 65 63 6f 6e 64 20 77 61 73 20 74 68 65 e second was the
04d0: 20 66 61 63 74 20 74 68 61 74 20 49 20 68 61 64 fact that I had
04e0: 20 77 72 69 74 74 65 6e 20 6f 72 0a 6d 61 69 6e written or.main
04f0: 74 61 69 6e 65 64 20 73 65 76 65 72 61 6c 20 73 tained several s
0500: 75 63 68 20 74 6f 6f 6c 73 20 61 74 20 64 69 66 uch tools at dif
0510: 66 65 72 65 6e 74 20 63 6f 6d 70 61 6e 69 65 73 ferent companies
0520: 20 6f 76 65 72 20 74 68 65 20 79 65 61 72 73 2e over the years.
0530: 20 49 0a 74 68 6f 75 67 68 74 20 61 20 73 69 6e I.thought a sin
0540: 67 6c 65 20 6f 70 65 6e 20 73 6f 75 72 63 65 20 gle open source
0550: 74 6f 6f 6c 2c 20 66 6c 65 78 69 62 6c 65 20 65 tool, flexible e
0560: 6e 6f 75 67 68 20 74 6f 20 6d 65 65 74 20 74 68 nough to meet th
0570: 65 20 6e 65 65 64 73 0a 6f 66 20 61 6e 79 20 74 e needs.of any t
0580: 65 61 6d 20 64 6f 69 6e 67 20 63 6f 6e 74 69 6e eam doing contin
0590: 75 6f 75 73 20 69 6e 74 65 67 72 61 74 69 6f 6e uous integration
05a0: 20 61 6e 64 20 6f 72 20 72 75 6e 6e 69 6e 67 20 and or running
05b0: 61 20 63 6f 6d 70 6c 65 78 0a 73 75 69 74 65 20 a complex.suite
05c0: 6f 66 20 74 65 73 74 73 20 66 6f 72 20 72 65 6c of tests for rel
05d0: 65 61 73 65 20 71 75 61 6c 69 66 69 63 61 74 69 ease qualificati
05e0: 6f 6e 20 77 6f 75 6c 64 20 73 6f 6c 76 65 20 73 on would solve s
05f0: 6f 6d 65 20 70 72 6f 62 6c 65 6d 73 20 66 6f 72 ome problems for
0600: 0a 6d 65 20 61 6e 64 20 66 6f 72 20 6f 74 68 65 .me and for othe
0610: 72 73 2e 0a 0a 20 2d 2d 20 4d 61 74 74 20 57 65 rs... -- Matt We
0620: 6c 6c 61 6e 64 2c 20 6f 72 69 67 69 6e 61 6c 20 lland, original
0630: 61 75 74 68 6f 72 20 6f 66 20 74 68 65 20 4d 65 author of the Me
0640: 67 61 74 65 73 74 20 74 6f 6f 6c 20 73 75 69 74 gatest tool suit
0650: 65 2e 0a 0a 4d 65 67 61 74 65 73 74 20 44 65 73 e...Megatest Des
0660: 69 67 6e 20 50 68 69 6c 6f 73 6f 70 68 79 0a 2d ign Philosophy.-
0670: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0680: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 4d 65 67 61 74 ---------..Megat
0690: 65 73 74 20 69 73 20 61 20 64 69 73 74 72 69 62 est is a distrib
06a0: 75 74 65 64 20 73 79 73 74 65 6d 20 69 6e 74 65 uted system inte
06b0: 6e 64 65 64 20 74 6f 20 70 72 6f 76 69 64 65 20 nded to provide
06c0: 74 68 65 20 6d 69 6e 69 6d 75 6d 20 6e 65 65 64 the minimum need
06d0: 65 64 0a 72 65 73 6f 75 72 63 65 73 20 74 6f 20 ed.resources to
06e0: 6d 61 6b 65 20 77 72 69 74 69 6e 67 20 61 20 73 make writing a s
06f0: 75 69 74 65 20 6f 66 20 74 65 73 74 73 20 61 6e uite of tests an
0700: 64 20 74 61 73 6b 73 20 66 6f 72 20 69 6d 70 6c d tasks for impl
0710: 65 6d 65 6e 74 69 6e 67 0a 63 6f 6e 74 69 6e 75 ementing.continu
0720: 6f 75 73 20 62 75 69 6c 64 20 66 6f 72 20 73 6f ous build for so
0730: 66 74 77 61 72 65 2c 20 64 65 73 69 67 6e 20 65 ftware, design e
0740: 6e 67 69 6e 65 65 72 69 6e 67 20 6f 72 20 70 72 ngineering or pr
0750: 6f 63 65 73 73 20 63 6f 6e 74 72 6f 6c 20 28 76 ocess control (v
0760: 69 61 0a 6f 77 6c 66 73 20 66 6f 72 20 65 78 61 ia.owlfs for exa
0770: 6d 70 6c 65 29 20 77 69 74 68 6f 75 74 20 62 65 mple) without be
0780: 69 6e 67 20 73 70 65 63 69 61 6c 69 7a 65 64 20 ing specialized
0790: 66 6f 72 20 61 6e 79 20 73 70 65 63 69 66 69 63 for any specific
07a0: 20 70 72 6f 62 6c 65 6d 0a 73 70 61 63 65 2e 20 problem.space.
07b0: 4d 65 67 61 74 65 73 74 20 69 6e 20 6f 66 20 69 Megatest in of i
07c0: 74 73 65 6c 66 20 64 6f 65 73 20 6e 6f 74 20 6b tself does not k
07d0: 6e 6f 77 20 77 68 61 74 20 63 6f 6e 73 74 69 74 now what constit
07e0: 75 74 65 73 20 61 20 50 41 53 53 20 6f 72 20 46 utes a PASS or F
07f0: 41 49 4c 0a 6f 66 20 61 20 74 65 73 74 20 6f 72 AIL.of a test or
0800: 20 74 61 73 6b 2e 20 49 6e 20 6d 6f 73 74 20 63 task. In most c
0810: 61 73 65 73 20 6d 65 67 61 74 65 73 74 20 69 73 ases megatest is
0820: 20 62 65 73 74 20 75 73 65 64 20 69 6e 20 63 6f best used in co
0830: 6e 6a 75 6e 63 74 69 6f 6e 20 77 69 74 68 0a 6c njunction with.l
0840: 6f 67 70 72 6f 20 6f 72 20 61 20 73 69 6d 69 6c ogpro or a simil
0850: 61 72 20 74 6f 6f 6c 20 74 6f 20 70 61 72 73 65 ar tool to parse
0860: 2c 20 61 6e 61 6c 79 7a 65 20 61 6e 64 20 64 65 , analyze and de
0870: 63 69 64 65 20 6f 6e 20 74 68 65 20 74 65 73 74 cide on the test
0880: 20 6f 75 74 63 6f 6d 65 2e 0a 0a 20 2a 20 53 65 outcome... * Se
0890: 6c 66 2d 63 68 65 63 6b 69 6e 67 20 2d 20 6d 61 lf-checking - ma
08a0: 6b 65 20 69 74 20 61 73 20 65 61 73 79 20 61 73 ke it as easy as
08b0: 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 77 72 69 possible to wri
08c0: 74 65 20 73 65 6c 66 2d 63 68 65 63 6b 69 6e 67 te self-checking
08d0: 0a 20 20 20 74 65 73 74 73 20 28 61 73 20 6f 70 . tests (as op
08e0: 70 6f 73 65 64 20 74 6f 20 75 73 69 6e 67 20 64 posed to using d
08f0: 65 6c 74 61 73 2c 20 69 2e 65 2e 20 74 65 73 74 eltas, i.e. test
0900: 73 20 74 68 61 74 20 63 6f 6d 70 61 72 65 20 77 s that compare w
0910: 69 74 68 20 61 0a 20 20 20 70 72 65 76 69 6f 75 ith a. previou
0920: 73 20 6d 65 61 73 75 72 65 6d 65 6e 74 20 74 6f s measurement to
0930: 20 64 65 74 65 72 69 6e 65 20 50 41 53 53 2f 46 deterine PASS/F
0940: 41 49 4c 29 2e 0a 0a 20 2a 20 54 72 61 63 65 61 AIL)... * Tracea
0950: 62 6c 65 20 2d 20 65 6e 76 69 72 6f 6e 6d 65 6e ble - environmen
0960: 74 20 76 61 72 69 61 62 6c 65 73 2c 20 68 6f 73 t variables, hos
0970: 74 20 4f 53 20 61 6e 64 20 6f 74 68 65 72 20 70 t OS and other p
0980: 6f 73 73 69 62 6c 79 0a 20 20 20 69 6e 66 6c 75 ossibly. influ
0990: 65 6e 74 69 61 6c 20 76 61 72 69 61 62 6c 65 73 ential variables
09a0: 20 61 72 65 20 63 61 70 74 75 72 65 64 20 61 6e are captured an
09b0: 64 20 6b 65 70 74 20 72 65 63 6f 72 64 65 64 2e d kept recorded.
09c0: 0a 0a 20 2a 20 49 6d 6d 75 74 61 62 6c 65 20 2d .. * Immutable -
09d0: 20 6f 6e 63 65 20 61 20 74 65 73 74 20 69 73 20 once a test is
09e0: 72 75 6e 20 69 74 20 63 61 6e 6e 6f 74 20 62 65 run it cannot be
09f0: 20 65 61 73 69 6c 79 20 6f 76 65 72 77 72 69 74 easily overwrit
0a00: 74 65 6e 20 6f 72 0a 20 20 20 6d 6f 64 69 66 69 ten or. modifi
0a10: 65 64 20 61 63 63 69 64 65 6e 74 61 6c 6c 79 2e ed accidentally.
0a20: 0a 0a 20 2a 20 52 65 70 65 61 74 61 62 6c 65 20 .. * Repeatable
0a30: 2d 20 74 65 73 74 20 72 65 73 75 6c 74 73 20 63 - test results c
0a40: 61 6e 20 62 65 20 72 65 63 72 65 61 74 65 64 20 an be recreated
0a50: 69 6e 20 74 68 65 20 66 75 74 75 72 65 20 75 73 in the future us
0a60: 69 6e 67 20 61 6c 6c 0a 20 20 20 74 68 65 20 6f ing all. the o
0a70: 72 69 67 69 6e 61 6c 20 76 61 72 69 61 62 6c 65 riginal variable
0a80: 73 2e 0a 0a 20 2a 20 52 65 6c 6f 63 61 74 61 62 s... * Relocatab
0a90: 6c 65 20 2d 20 74 68 65 20 74 65 73 74 73 75 69 le - the testsui
0aa0: 74 65 20 6f 72 20 61 75 74 6f 6d 61 74 69 6f 6e te or automation
0ab0: 20 61 72 65 61 20 63 61 6e 20 62 65 20 63 68 65 area can be che
0ac0: 63 6b 65 64 20 6f 75 74 0a 20 20 20 61 6e 64 20 cked out. and
0ad0: 74 68 65 20 74 65 73 74 73 20 72 75 6e 20 61 6e the tests run an
0ae0: 79 77 68 65 72 65 20 69 6e 20 74 68 65 20 64 69 ywhere in the di
0af0: 73 6b 20 68 69 65 72 61 72 63 68 79 2e 0a 0a 20 sk hierarchy...
0b00: 2a 20 45 6e 63 61 70 73 75 6c 61 74 65 64 20 2d * Encapsulated -
0b10: 20 74 68 65 20 74 65 73 74 73 20 72 75 6e 20 69 the tests run i
0b20: 6e 20 73 65 6c 66 2d 63 6f 6e 74 61 69 6e 65 64 n self-contained
0b30: 20 64 69 72 65 63 74 6f 72 69 65 73 20 61 6e 64 directories and
0b40: 20 61 6c 6c 0a 20 20 20 69 6e 70 75 74 73 20 61 all. inputs a
0b50: 6e 64 20 6f 75 74 70 75 74 73 20 74 6f 20 74 68 nd outputs to th
0b60: 65 20 70 72 6f 63 65 73 73 20 63 61 6e 20 62 65 e process can be
0b70: 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 72 75 found in the ru
0b80: 6e 20 61 72 65 61 73 2e 0a 0a 20 2a 20 44 65 70 n areas... * Dep
0b90: 6c 6f 79 61 62 6c 65 20 2d 20 61 20 74 65 73 74 loyable - a test
0ba0: 73 75 69 74 65 20 69 73 20 73 65 6c 66 2d 63 6f suite is self-co
0bb0: 6e 74 61 69 6e 65 64 20 61 6e 64 20 63 61 6e 20 ntained and can
0bc0: 62 65 20 62 75 6e 64 6c 65 64 20 77 69 74 68 0a be bundled with.
0bd0: 20 20 20 61 20 73 6f 66 74 77 61 72 65 20 70 72 a software pr
0be0: 6f 6a 65 63 74 20 61 6e 64 20 65 61 73 69 6c 79 oject and easily
0bf0: 20 75 73 65 64 20 62 79 20 6f 74 68 65 72 73 20 used by others
0c00: 77 69 74 68 20 6c 69 74 74 6c 65 20 74 6f 20 6e with little to n
0c10: 6f 0a 20 20 20 73 65 74 75 70 20 62 75 72 64 65 o. setup burde
0c20: 6e 2e 0a 0a 4d 65 67 61 74 65 73 74 20 41 72 63 n...Megatest Arc
0c30: 68 69 74 65 63 74 75 72 65 0a 2d 2d 2d 2d 2d 2d hitecture.------
0c40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
0c50: 0a 44 61 74 61 20 73 65 70 61 72 61 74 69 6f 6e .Data separation
0c60: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e .~~~~~~~~~~~~~~~
0c70: 0a 0a 41 6c 6c 20 64 61 74 61 20 74 6f 20 73 70 ..All data to sp
0c80: 65 63 69 66 79 20 74 68 65 20 74 65 73 74 73 20 ecify the tests
0c90: 61 6e 64 20 63 6f 6e 66 69 67 75 72 65 20 74 68 and configure th
0ca0: 65 20 73 79 73 74 65 6d 20 69 73 20 73 74 6f 72 e system is stor
0cb0: 65 64 20 69 6e 0a 70 6c 61 69 6e 20 74 65 78 74 ed in.plain text
0cc0: 20 63 6f 6e 66 69 67 20 66 69 6c 65 73 2e 20 41 config files. A
0cd0: 6c 6c 20 73 79 73 74 65 6d 20 73 74 61 74 65 20 ll system state
0ce0: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 6e 20 is stored in an
0cf0: 73 71 6c 69 74 65 33 0a 64 61 74 61 62 61 73 65 sqlite3.database
0d00: 2e 0a 0a 44 69 73 74 72 69 62 75 74 65 64 20 43 ...Distributed C
0d10: 6f 6d 70 75 74 65 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e ompute.~~~~~~~~~
0d20: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 65 73 74 ~~~~~~~~~~..Test
0d30: 73 20 61 72 65 20 6c 61 75 6e 63 68 65 64 20 75 s are launched u
0d40: 73 69 6e 67 20 74 68 65 20 6c 61 75 6e 63 68 69 sing the launchi
0d50: 6e 67 20 73 79 73 74 65 6d 20 61 76 61 69 6c 61 ng system availa
0d60: 62 6c 65 20 66 6f 72 20 74 68 65 0a 64 69 73 74 ble for the.dist
0d70: 72 69 62 75 74 65 64 20 63 6f 6d 70 75 74 65 20 ributed compute
0d80: 70 6c 61 74 66 6f 72 6d 20 69 6e 20 75 73 65 2e platform in use.
0d90: 20 41 20 74 65 6d 70 6c 61 74 65 20 73 63 72 69 A template scri
0da0: 70 74 20 69 73 20 70 72 6f 76 69 64 65 64 0a 77 pt is provided.w
0db0: 68 69 63 68 20 63 61 6e 20 6c 61 75 6e 63 68 20 hich can launch
0dc0: 6a 6f 62 73 20 6f 6e 20 6c 6f 63 61 6c 20 61 6e jobs on local an
0dd0: 64 20 72 65 6d 6f 74 65 20 4c 69 6e 75 78 20 68 d remote Linux h
0de0: 6f 73 74 73 2e 20 43 75 72 72 65 6e 74 6c 79 0a osts. Currently.
0df0: 6d 65 67 61 74 65 73 74 20 75 73 65 73 20 74 68 megatest uses th
0e00: 65 20 6e 65 74 77 6f 72 6b 20 66 69 6c 65 73 79 e network filesy
0e10: 73 74 65 6d 20 74 6f 20 63 61 6c 6c 20 68 6f 6d stem to call hom
0e20: 65 20 74 6f 20 79 6f 75 72 20 6d 61 73 74 65 72 e to your master
0e30: 0a 73 71 6c 69 74 65 33 20 64 61 74 61 62 61 73 .sqlite3 databas
0e40: 65 2e 20 4d 65 67 61 74 65 73 74 20 68 61 73 20 e. Megatest has
0e50: 62 65 65 6e 20 75 73 65 64 20 77 69 74 68 20 74 been used with t
0e60: 68 65 20 49 6e 74 65 6c 20 4e 65 74 62 61 74 63 he Intel Netbatc
0e70: 68 20 61 6e 64 0a 6c 73 66 20 28 61 6c 73 6f 20 h and.lsf (also
0e80: 6b 6e 6f 77 6e 20 61 73 20 6f 70 65 6e 6c 61 76 known as openlav
0e90: 61 29 20 62 61 74 63 68 20 73 79 73 74 65 6d 73 a) batch systems
0ea0: 20 61 6e 64 20 69 74 20 73 68 6f 75 6c 64 20 62 and it should b
0eb0: 65 0a 73 74 72 61 69 67 68 74 66 6f 72 77 61 72 e.straightforwar
0ec0: 64 20 74 6f 20 75 73 65 20 69 74 20 77 69 74 68 d to use it with
0ed0: 20 6f 74 68 65 72 20 73 69 6d 69 6c 61 72 20 73 other similar s
0ee0: 79 73 74 65 6d 73 2e 0a 0a 69 6e 63 6c 75 64 65 ystems...include
0ef0: 3a 3a 6f 76 65 72 76 69 65 77 2e 74 78 74 5b 5d ::overview.txt[]
0f00: 0a 0a 69 6e 63 6c 75 64 65 3a 3a 70 6c 61 6e 2e ..include::plan.
0f10: 74 78 74 5b 5d 0a 0a 69 6e 63 6c 75 64 65 3a 3a txt[]..include::
0f20: 69 6e 73 74 61 6c 6c 61 74 69 6f 6e 2e 74 78 74 installation.txt
0f30: 5b 5d 0a 0a 69 6e 63 6c 75 64 65 3a 3a 67 65 74 []..include::get
0f40: 74 69 6e 67 5f 73 74 61 72 74 65 64 2e 74 78 74 ting_started.txt
0f50: 5b 5d 0a 0a 69 6e 63 6c 75 64 65 3a 3a 73 74 75 []..include::stu
0f60: 64 79 5f 70 6c 61 6e 2e 74 78 74 5b 5d 0a 0a 2f dy_plan.txt[]../
0f70: 2f 20 3a 6c 65 76 65 6c 6f 66 66 73 65 74 3a 20 / :leveloffset:
0f80: 30 0a 0a 69 6e 63 6c 75 64 65 3a 3a 77 72 69 74 0..include::writ
0f90: 69 6e 67 5f 74 65 73 74 73 2e 74 78 74 5b 5d 0a ing_tests.txt[].
0fa0: 69 6e 63 6c 75 64 65 3a 3a 68 6f 77 74 6f 2e 74 include::howto.t
0fb0: 78 74 5b 5d 0a 0a 69 6e 63 6c 75 64 65 3a 3a 72 xt[]..include::r
0fc0: 65 66 65 72 65 6e 63 65 2e 74 78 74 5b 5d 0a 0a eference.txt[]..
0fd0: 0a 4d 65 67 61 74 65 73 74 20 49 6e 74 65 72 6e .Megatest Intern
0fe0: 61 6c 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d als.------------
0ff0: 2d 2d 2d 2d 2d 2d 0a 0a 5b 22 67 72 61 70 68 76 ------..["graphv
1000: 69 7a 22 2c 20 22 73 65 72 76 65 72 2e 70 6e 67 iz", "server.png
1010: 22 5d 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d "].-------------
1020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1050: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 69 6e 63 6c 75 64 ---------.includ
1060: 65 3a 3a 73 65 72 76 65 72 2e 64 6f 74 5b 5d 0a e::server.dot[].
1070: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
10b0: 2d 2d 2d 2d 2d 2d 0a 0a 2f 2f 20 69 6e 63 6c 75 ------..// inclu
10c0: 64 65 3a 3a 70 6c 61 6e 2e 74 78 74 5b 5d 0a 2f de::plan.txt[]./
10d0: 2f 20 74 6f 20 61 6c 6c 6f 77 20 74 68 65 20 67 / to allow the g
10e0: 65 74 74 69 6e 67 5f 73 74 61 72 74 65 64 2e 74 etting_started.t
10f0: 78 74 20 74 6f 20 62 65 20 61 20 73 74 61 6e 64 xt to be a stand
1100: 2d 61 6c 6f 6e 65 20 64 6f 63 75 6d 65 6e 74 20 -alone document
1110: 75 73 65 20 6c 65 76 65 6c 0a 2f 2f 20 73 68 69 use level.// shi
1120: 66 74 69 6e 67 2c 20 6e 6f 74 65 20 74 68 61 74 fting, note that
1130: 20 74 68 65 20 70 72 65 63 65 64 69 6e 67 20 62 the preceding b
1140: 6c 61 6e 6b 20 6c 69 6e 65 20 69 73 20 6e 65 65 lank line is nee
1150: 64 65 64 2e 0a 2f 2f 20 3a 6c 65 76 65 6c 6f 66 ded..// :levelof
1160: 66 73 65 74 3a 20 32 0a 0a 0a 2f 2f 20 5b 61 70 fset: 2...// [ap
1170: 70 65 6e 64 69 78 5d 0a 2f 2f 20 45 78 61 6d 70 pendix].// Examp
1180: 6c 65 20 41 70 70 65 6e 64 69 78 0a 2f 2f 20 3d le Appendix.// =
1190: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a ===============.
11a0: 2f 2f 20 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f // One or more o
11b0: 70 74 69 6f 6e 61 6c 20 61 70 70 65 6e 64 69 78 ptional appendix
11c0: 65 73 20 67 6f 20 68 65 72 65 20 61 74 20 73 65 es go here at se
11d0: 63 74 69 6f 6e 20 6c 65 76 65 6c 20 7a 65 72 6f ction level zero
11e0: 2e 0a 2f 2f 20 0a 2f 2f 20 41 70 70 65 6e 64 69 ..// .// Appendi
11f0: 78 20 53 75 62 2d 73 65 63 74 69 6f 6e 0a 2f 2f x Sub-section.//
1200: 20 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e ~~~~~~~~~~~~~~~
1210: 7e 7e 7e 7e 0a 2f 2f 20 4e 4f 54 45 3a 20 50 72 ~~~~.// NOTE: Pr
1220: 65 66 61 63 65 20 61 6e 64 20 61 70 70 65 6e 64 eface and append
1230: 69 78 20 73 75 62 73 65 63 74 69 6f 6e 73 20 73 ix subsections s
1240: 74 61 72 74 20 6f 75 74 20 6f 66 20 73 65 71 75 tart out of sequ
1250: 65 6e 63 65 20 61 74 20 6c 65 76 65 6c 0a 2f 2f ence at level.//
1260: 20 32 20 28 6c 65 76 65 6c 20 31 20 69 73 20 73 2 (level 1 is s
1270: 6b 69 70 70 65 64 29 2e 20 20 54 68 69 73 20 6f kipped). This o
1280: 6e 6c 79 20 61 70 70 6c 69 65 73 20 74 6f 20 6d nly applies to m
1290: 75 6c 74 69 2d 70 61 72 74 20 62 6f 6f 6b 0a 2f ulti-part book./
12a0: 2f 20 64 6f 63 75 6d 65 6e 74 73 2e 0a 2f 2f 20 / documents..//
12b0: 0a 2f 2f 20 0a 2f 2f 20 0a 2f 2f 20 5b 62 69 62 .// .// .// [bib
12c0: 6c 69 6f 67 72 61 70 68 79 5d 0a 2f 2f 20 45 78 liography].// Ex
12d0: 61 6d 70 6c 65 20 42 69 62 6c 69 6f 67 72 61 70 ample Bibliograp
12e0: 68 79 0a 2f 2f 20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d hy.// ==========
12f0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 2f 2f 20 54 68 ==========.// Th
1300: 65 20 62 69 62 6c 69 6f 67 72 61 70 68 79 20 6c e bibliography l
1310: 69 73 74 20 69 73 20 61 20 73 74 79 6c 65 20 6f ist is a style o
1320: 66 20 41 73 63 69 69 44 6f 63 20 62 75 6c 6c 65 f AsciiDoc bulle
1330: 74 65 64 20 6c 69 73 74 2e 0a 2f 2f 20 0a 2f 2f ted list..// .//
1340: 20 5b 62 69 62 6c 69 6f 67 72 61 70 68 79 5d 0a [bibliography].
1350: 2f 2f 20 2d 20 5b 5b 5b 74 61 6f 75 70 5d 5d 5d // - [[[taoup]]]
1360: 20 45 72 69 63 20 53 74 65 76 65 6e 20 52 61 79 Eric Steven Ray
1370: 6d 6f 6e 64 2e 20 27 54 68 65 20 41 72 74 20 6f mond. 'The Art o
1380: 66 20 55 6e 69 78 0a 2f 2f 20 20 20 50 72 6f 67 f Unix.// Prog
1390: 72 61 6d 6d 69 6e 67 27 2e 20 41 64 64 69 73 6f ramming'. Addiso
13a0: 6e 2d 57 65 73 6c 65 79 2e 20 49 53 42 4e 20 30 n-Wesley. ISBN 0
13b0: 2d 31 33 2d 31 34 32 39 30 31 2d 39 2e 0a 2f 2f -13-142901-9..//
13c0: 20 2d 20 5b 5b 5b 77 61 6c 73 68 2d 6d 75 65 6c - [[[walsh-muel
13d0: 6c 6e 65 72 5d 5d 5d 20 4e 6f 72 6d 61 6e 20 57 lner]]] Norman W
13e0: 61 6c 73 68 20 26 20 4c 65 6f 6e 61 72 64 20 4d alsh & Leonard M
13f0: 75 65 6c 6c 6e 65 72 2e 0a 2f 2f 20 20 20 27 44 uellner..// 'D
1400: 6f 63 42 6f 6f 6b 20 2d 20 54 68 65 20 44 65 66 ocBook - The Def
1410: 69 6e 69 74 69 76 65 20 47 75 69 64 65 27 2e 20 initive Guide'.
1420: 4f 27 52 65 69 6c 6c 79 20 26 20 41 73 73 6f 63 O'Reilly & Assoc
1430: 69 61 74 65 73 2e 20 31 39 39 39 2e 0a 2f 2f 20 iates. 1999..//
1440: 20 20 49 53 42 4e 20 31 2d 35 36 35 39 32 2d 35 ISBN 1-56592-5
1450: 38 30 2d 37 2e 0a 2f 2f 20 0a 2f 2f 20 0a 2f 2f 80-7..// .// .//
1460: 20 5b 67 6c 6f 73 73 61 72 79 5d 0a 2f 2f 20 45 [glossary].// E
1470: 78 61 6d 70 6c 65 20 47 6c 6f 73 73 61 72 79 0a xample Glossary.
1480: 2f 2f 20 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d // =============
1490: 3d 3d 3d 0a 2f 2f 20 47 6c 6f 73 73 61 72 69 65 ===.// Glossarie
14a0: 73 20 61 72 65 20 6f 70 74 69 6f 6e 61 6c 2e 20 s are optional.
14b0: 47 6c 6f 73 73 61 72 69 65 73 20 65 6e 74 72 69 Glossaries entri
14c0: 65 73 20 61 72 65 20 61 6e 20 65 78 61 6d 70 6c es are an exampl
14d0: 65 20 6f 66 20 61 20 73 74 79 6c 65 0a 2f 2f 20 e of a style.//
14e0: 6f 66 20 41 73 63 69 69 44 6f 63 20 6c 61 62 65 of AsciiDoc labe
14f0: 6c 65 64 20 6c 69 73 74 73 2e 0a 2f 2f 20 0a 2f led lists..// ./
1500: 2f 20 5b 67 6c 6f 73 73 61 72 79 5d 0a 2f 2f 20 / [glossary].//
1510: 41 20 67 6c 6f 73 73 61 72 79 20 74 65 72 6d 3a A glossary term:
1520: 3a 0a 2f 2f 20 20 20 54 68 65 20 63 6f 72 72 65 :.// The corre
1530: 73 70 6f 6e 64 69 6e 67 20 28 69 6e 64 65 6e 74 sponding (indent
1540: 65 64 29 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a ed) definition..
1550: 2f 2f 20 0a 2f 2f 20 41 20 73 65 63 6f 6e 64 20 // .// A second
1560: 67 6c 6f 73 73 61 72 79 20 74 65 72 6d 3a 3a 0a glossary term::.
1570: 2f 2f 20 20 20 54 68 65 20 63 6f 72 72 65 73 70 // The corresp
1580: 6f 6e 64 69 6e 67 20 28 69 6e 64 65 6e 74 65 64 onding (indented
1590: 29 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 2f 2f ) definition..//
15a0: 20 0a 2f 2f 20 0a 2f 2f 20 5b 63 6f 6c 6f 70 68 .// .// [coloph
15b0: 6f 6e 5d 0a 2f 2f 20 45 78 61 6d 70 6c 65 20 43 on].// Example C
15c0: 6f 6c 6f 70 68 6f 6e 0a 2f 2f 20 3d 3d 3d 3d 3d olophon.// =====
15d0: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 2f 2f 20 54 ===========.// T
15e0: 65 78 74 20 61 74 20 74 68 65 20 65 6e 64 20 6f ext at the end o
15f0: 66 20 61 20 62 6f 6f 6b 20 64 65 73 63 72 69 62 f a book describ
1600: 69 6e 67 20 66 61 63 74 73 20 61 62 6f 75 74 20 ing facts about
1610: 69 74 73 20 70 72 6f 64 75 63 74 69 6f 6e 2e 0a its production..
1620: 0a 5b 69 6e 64 65 78 5d 0a 49 6e 64 65 78 0a 2d .[index].Index.-
1630: 2d 2d 2d 2d 0a 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ----.///////////
1640: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1650: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1660: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1670: 2f 2f 2f 2f 2f 0a 54 68 65 20 69 6e 64 65 78 20 /////.The index
1680: 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 6c 65 66 74 is normally left
1690: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 65 6d 70 74 completely empt
16a0: 79 2c 20 69 74 27 73 20 63 6f 6e 74 65 6e 74 73 y, it's contents
16b0: 20 61 72 65 0a 67 65 6e 65 72 61 74 65 64 20 61 are.generated a
16c0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 utomatically by
16d0: 74 68 65 20 44 6f 63 42 6f 6f 6b 20 74 6f 6f 6c the DocBook tool
16e0: 63 68 61 69 6e 2e 0a 2f 2f 2f 2f 2f 2f 2f 2f 2f chain../////////
16f0: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1700: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1710: 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f 2f ////////////////
1720: 2f 2f 2f 2f 2f 2f 2f 0a ///////.