Changeset 82630 in vbox for trunk/src

Timestamp:

Dec 21, 2019 2:48:53 PM (5 years ago)

Author:

vboxsync

Message:

testmanager/readme.txt: Added some words about how to set up a test manager instance locally.

File:

• trunk/src/VBox/ValidationKit/testmanager/readme.txt (modified) (1 diff)

trunk/src/VBox/ValidationKit/testmanager/readme.txt

@@ -12 +12 @@
                         do model-view-controller stuff, though. Time will show.)
 
+
+Steps for setting up a local Test Manager instance for development:
+
+  - Install apache, postgresql, python, psycopg2 (python) and pylint.
+
+  - Create the database by executing 'kmk load-testmanager-db' in
+    the './db/' subdirectory.   The default psql parameters there
+    requies pg_hba.conf to specify 'trust' instead of 'peer' as the
+    authentication method for local connections.
+
+  - Use ./db/partial-db-dump.py on the production system to extract a
+    partial database dump (last 14 days).
+
+  - Use ./db/partial-db-dump.py with the --load-dump-into-database
+    parameter on the development box to load the dump.
+
+  - Configure apache using the ./apache-template-2.4.conf (see top of
+    file for details), for example:
+
+        Define TestManagerRootDir "/mnt/scratch/vbox/svn/trunk/src/VBox/ValidationKit/testmanager"
+        Define VBoxBuildOutputDir "/tmp"
+        Include "${TestManagerRootDir}/apache-template-2.4.conf"
+
+    Make sure to enable cgi (a2enmod cgi && systemctl restart apache2).
+
+  - Default htpasswd file has users a user 'admin' with password 'admin' and a
+    'test' user with password 'test'.  This isn't going to get you far if
+    you've  loaded something from the production server as there is typically
+    no 'admin' user in the 'Users' table there.  So, you will need to add your
+    user and a throwaway password to 'misc/htpasswd-sample' using the htpasswd
+    utility.
+
+  - Try http://localhost/testmanager/ in a browser and see if it works.
+
+
+
+N.B. For developing tests (../tests/), setting up a local test manager will be
+     a complete waste of time.  Just run the test drivers locally.
+
+
+
+
+
+
+
+