| 1 | $Id: readme.txt 82630 2019-12-21 14:48:53Z vboxsync $
|
|---|
| 2 |
|
|---|
| 3 | Directory descriptions:
|
|---|
| 4 | ./ The Test Manager.
|
|---|
| 5 | ./batch/ Batch scripts to be run via cron.
|
|---|
| 6 | ./cgi/ CGI scripts (we'll use standard CGI at first).
|
|---|
| 7 | ./core/ The core Test Manager logic (model).
|
|---|
| 8 | ./htdocs/ Files to be served directly by the web server.
|
|---|
| 9 | ./htdocs/css/ Style sheets.
|
|---|
| 10 | ./htdocs/images/ Graphics.
|
|---|
| 11 | ./webui/ The Web User Interface (WUI) bits. (Not sure if we will
|
|---|
| 12 | do model-view-controller stuff, though. Time will show.)
|
|---|
| 13 |
|
|---|
| 14 |
|
|---|
| 15 | Steps for setting up a local Test Manager instance for development:
|
|---|
| 16 |
|
|---|
| 17 | - Install apache, postgresql, python, psycopg2 (python) and pylint.
|
|---|
| 18 |
|
|---|
| 19 | - Create the database by executing 'kmk load-testmanager-db' in
|
|---|
| 20 | the './db/' subdirectory. The default psql parameters there
|
|---|
| 21 | requies pg_hba.conf to specify 'trust' instead of 'peer' as the
|
|---|
| 22 | authentication method for local connections.
|
|---|
| 23 |
|
|---|
| 24 | - Use ./db/partial-db-dump.py on the production system to extract a
|
|---|
| 25 | partial database dump (last 14 days).
|
|---|
| 26 |
|
|---|
| 27 | - Use ./db/partial-db-dump.py with the --load-dump-into-database
|
|---|
| 28 | parameter on the development box to load the dump.
|
|---|
| 29 |
|
|---|
| 30 | - Configure apache using the ./apache-template-2.4.conf (see top of
|
|---|
| 31 | file for details), for example:
|
|---|
| 32 |
|
|---|
| 33 | Define TestManagerRootDir "/mnt/scratch/vbox/svn/trunk/src/VBox/ValidationKit/testmanager"
|
|---|
| 34 | Define VBoxBuildOutputDir "/tmp"
|
|---|
| 35 | Include "${TestManagerRootDir}/apache-template-2.4.conf"
|
|---|
| 36 |
|
|---|
| 37 | Make sure to enable cgi (a2enmod cgi && systemctl restart apache2).
|
|---|
| 38 |
|
|---|
| 39 | - Default htpasswd file has users a user 'admin' with password 'admin' and a
|
|---|
| 40 | 'test' user with password 'test'. This isn't going to get you far if
|
|---|
| 41 | you've loaded something from the production server as there is typically
|
|---|
| 42 | no 'admin' user in the 'Users' table there. So, you will need to add your
|
|---|
| 43 | user and a throwaway password to 'misc/htpasswd-sample' using the htpasswd
|
|---|
| 44 | utility.
|
|---|
| 45 |
|
|---|
| 46 | - Try http://localhost/testmanager/ in a browser and see if it works.
|
|---|
| 47 |
|
|---|
| 48 |
|
|---|
| 49 |
|
|---|
| 50 | N.B. For developing tests (../tests/), setting up a local test manager will be
|
|---|
| 51 | a complete waste of time. Just run the test drivers locally.
|
|---|
| 52 |
|
|---|
| 53 |
|
|---|
| 54 |
|
|---|
| 55 |
|
|---|
| 56 |
|
|---|
| 57 |
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
