Index: openacs-4/packages/acs-automated-testing/www/doc/usage.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-automated-testing/www/doc/usage.adp,v diff -u -r1.4.2.3 -r1.4.2.4 --- openacs-4/packages/acs-automated-testing/www/doc/usage.adp 13 Jul 2023 12:49:25 -0000 1.4.2.3 +++ openacs-4/packages/acs-automated-testing/www/doc/usage.adp 2 Sep 2024 09:40:20 -0000 1.4.2.4 @@ -2,6 +2,10 @@ {/doc/acs-automated-testing/ {ACS Automated Testing}} {Usage} Usage +

Suppose the first test server is service1. Set up a dedicated user and automated install script.

  • To run automated testing automatically each time the server is -rebuilt, add this to /home/service1/install/install.tcl:

    -       set do_tclapi_testing "yes"
    -
    +rebuilt, add this to /home/service1/install/install.tcl:

           set do_tclapi_testing "yes"
  • Get the results of the automated tests dumped where the master server can see them - in this example, the same directory as above, /var/log/openacs-install, by adding -this to install.tcl (requires 5.1):

    -          set install_xml_file          "/var/lib/aolserver/service0/packages/acs-core-docs/www/files/install-autotest.xml"
    -

    This will copy in the file install-autotest.xml:

    -<?xml version="1.0"?>
    +this to install.tcl (requires 5.1):

              set install_xml_file          "/var/lib/aolserver/service0/packages/acs-core-docs/www/files/install-autotest.xml"

    This will copy in the file install-autotest.xml:

    <?xml version="1.0"?>
     
     <!-- This is an install.xml which can be used to configure servers for reporting their automated test results.  Requires acs-automated-testing 5.1.0b2 or better -->
     
    @@ -58,8 +57,7 @@
     
     
  • To enable the 'rebuild server' link, edit the file -/usr/local/bin/rebuild-server.sh:

    -#!/bin/sh
    +/usr/local/bin/rebuild-server.sh:

    #!/bin/sh
     # script to trigger a server rebuild
     
     # hard-coding the valid server names here for some minimal security
    @@ -71,12 +69,9 @@
             exit;;
     esac
     
    -sudo /home/$1/install/install.sh 2>&1
    -

    and allow the master user to +sudo /home/$1/install/install.sh 2>&1

    and allow the master user to execute this file as root (this is a limitation of the automatic -install script, which must be root). In /etc/sudoers, include a line:

    -master ALL = NOPASSWD: /usr/local/bin/rebuild-server.sh
    -
    +install script, which must be root). In /etc/sudoers, include a line:

    master ALL = NOPASSWD: /usr/local/bin/rebuild-server.sh