gdp / apps / rest-test / README @ master
History | View | Annotate | Download (3.05 KB)
1 |
To run the *.js tests: |
---|---|
2 |
---------------------- |
3 |
|
4 |
Copy all the .js and .html files to the root directory of your webserver |
5 |
Configure SCGI and gdp-rest |
6 |
|
7 |
TODO: |
8 |
|
9 |
Allow running tests without user interaction |
10 |
|
11 |
To run the the gdp-rest-testcases.py tests: |
12 |
------------------------------------------- |
13 |
|
14 |
# The gdp-rest-01.eecs.berkeley.edu host is servicing real GDP |
15 |
# requests on the /gdp/v1/gcl URI using installed gdp binaries, but |
16 |
# also supports development work. HTTP requests on the /gdp/v2/gcl URI |
17 |
# are directed to development binaries in a developer's git workspace, |
18 |
# when properly configured to do so (see below). |
19 |
|
20 |
# The gdp-rest-01.eecs.berkeley.edu host is not serving as a permanent |
21 |
# home for GCLs. For development and test purposes, gdplogd2 is |
22 |
# started before the test suite is run, but is always stopped at the |
23 |
# end of each test run, after which all GCLs are cleaned off |
24 |
# gdp-rest-01! Since active keys will be on gdp-rest-01 permanently, |
25 |
# care should be taken to only clean up test keys! Note that the |
26 |
# gdp-rest-01 gdplogd2-wrapper.sh script has been customized such that |
27 |
# gdplogd2 prefers connecting to gdp-01, causing RESTful unit tests to |
28 |
# travel from gdp-rest-01 out through the first default router |
29 |
# (usually gdp-03), then through gdp-01, before reaching gdp-rest-01's |
30 |
# gdplogd2 test instance. |
31 |
|
32 |
# |
33 |
# gdp-rest-01 development testbed |
34 |
# |
35 |
|
36 |
# if the following file already exists, then simply edit to suit instead! |
37 |
$ cp /usr/sbin/gdp-rest-wrapper.sh /usr/sbin/gdp-rest-wrapper-v2.sh |
38 |
$ diff /usr/sbin/gdp-rest-wrapper.sh /usr/sbin/gdp-rest-wrapper-v2.sh |
39 |
12,14c12,14 |
40 |
< : ${GDP_REST_ARGS:="-D*=10"} |
41 |
< : ${GDP_REST_BIN:=$GDP_ROOT/sbin/gdp-rest} |
42 |
< : ${GDP_REST_LOG:=$GDP_LOG_DIR/gdp-rest.log} |
43 |
--- |
44 |
> : ${GDP_REST_ARGS:="-D*=10 -p 8002 -u /gdp/v2"} |
45 |
> : ${GDP_REST_BIN:=/home/rpratt/src-signpost/gdp/apps/gdp-rest} |
46 |
> : ${GDP_REST_LOG:=$GDP_LOG_DIR/gdp-rest-v2.log} |
47 |
$ |
48 |
|
49 |
$ cd /etc/systemd/system |
50 |
# if the following file already exists, no need to revise it. |
51 |
$ cp gdp-rest.service gdp-rest-v2.service |
52 |
$ diff gdp-rest.service gdp-rest-v2.service |
53 |
13c13 |
54 |
< ExecStart=/bin/sh /usr/sbin/gdp-rest-wrapper.sh |
55 |
--- |
56 |
> ExecStart=/bin/sh /usr/sbin/gdp-rest-wrapper-v2.sh |
57 |
18c18 |
58 |
< SyslogIdentifier=gdp-rest |
59 |
--- |
60 |
> SyslogIdentifier=gdp-rest-v2 |
61 |
$ |
62 |
|
63 |
# The following are already configured properly (docs on redmine, if needed): |
64 |
# |
65 |
# /etc/lighttpd/lighttpd.conf |
66 |
# /etc/lighttpd/conf-enabled/10-scgi.conf |
67 |
# |
68 |
|
69 |
$ systemctl enable gdp-rest-v2.service |
70 |
$ systemctl start gdp-rest-v2.service |
71 |
$ systemctl restart lighttpd |
72 |
|
73 |
# Edit gdp-rest-testcases.py (see "test_auth" section) and |
74 |
# /etc/lighttpd/.plainauth to suit development needs. |
75 |
|
76 |
# Run the testcases to verify development work |
77 |
$ ./gdp-rest-testcases.py |
78 |
|
79 |
# lather, rinse, repeat! ;) |
80 |
|
81 |
# when done with development: |
82 |
# |
83 |
# 1) do not commit your edited test_auth username,password to the test script! |
84 |
# 2) remove any temporarily added test_auth entry from /etc/lighttpd/.plainauth |
85 |
# 3) disable /gdp/v2/gcl (sudo systemctl disable --now gdp-rest-v2.service) |
86 |
# 4) restart lighttpd (sudo systemctl restart lighttpd.service) |
87 |
# |
88 |
# leave everything else in place for the next RESTful todo item... |
89 |
# |