Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 68 lines (52 sloc) 2.387 kb
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
1 Nimbus Build and Test
2 =====================
3
f6865f8 build and test seems to work
BuzzTroll authored
4 This document is for developers of Nimbus. It describes how to use the
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
5 automated build, configure, and test system. This system is NOT intended
6 for users and is not supported. It touches some very important files
7 on your system and thus should be considered dangerous.
8
9 ---------
10 Important
11 ---------
12 This system may destroy your ~/.ssh ~/.globus and ~/.nimbus directories!
f9550ef spell check on README
BuzzTroll authored
13 While it makes every effort to back them up and reestablish them, this is
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
14 developer code and it does touch these files! It is best run under a
15 new and clean user. Please back all of these directories up before using
16 this system!
17
18 Testing
19 =======
20
21 simply run the program ./bt-nimbus.sh with no arguments. This will
22 do the following:
f6865f8 build and test seems to work
BuzzTroll authored
23 1) Nimbus from the github master branch
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
24 2) build and install
f6865f8 build and test seems to work
BuzzTroll authored
25 -- Nimbus
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
26 -- workspace control in propagate only mode
27 -- cloud-client
28 3) run all tests in the current directory
29 -- any file that that matches '.*test.{sh,py} will be run
30 4) clean up
31
32 Results
33 -------
34
35 All output is sent to the console. Within the last few lines there will
36 be a summary line similar to:
37
6892d83 readme updates, more patches
BuzzTroll authored
38 4 parent tests passed (many more subtests were run)
39 3 parent tests failed
40 cc1-test.sh ec2-test.sh cc-list-test.py
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
41
42 Log files are also created. The main build log can be found in the source
43 directory at 'bandt.log'. Each test also creates a log file <test name>.log.
44
45
46 Adding New Tests
47 ----------------
48
49 To add a new test simply create an executable bash or python script and
50 name it according to the convention <your test name>test.{py,sh}. The
51 script will be run with the following environment:
52
f6865f8 build and test seems to work
BuzzTroll authored
53 NIMBUS_HOME=<Nimbus service installation>
54 NIMBUS_TEST_USER=<a configured Nimbus user name>
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
55 CLOUD_CLIENT_HOME=<location of the cloud client install>
56 NIMBUS_WORKSPACE_CONTROL_HOME=<location of the workspace control install>
57
f6865f8 build and test seems to work
BuzzTroll authored
58 All tests must return 0 for success. All other return codes are considered
59 failure. Tests may log whatever they want to stdout/err.
60
7d52929 adding a read me and making other minor corrections
BuzzTroll authored
61 Propagation Only
62 ----------------
63
64 It should be noted that all tests are run in 'propagation only' mode. This
65 means that no VMs are actually started. However the service, storage,
66 propagation code, and cloud client code is tested. While this is not
f9550ef spell check on README
BuzzTroll authored
67 exhaustive, it does provided a good sanity check of the codebase.
Something went wrong with that request. Please try again.