m (→Configure AutoQA: changing docs to reflect change to configuration file format) |
|||
Line 31: | Line 31: | ||
<li>{{filename|fas.conf}} - config file with [[Account System|FAS]] credentials, used for services that require FAS authentication (like [[Bodhi]]); adjust only if you want to submit results using FAS</li> | <li>{{filename|fas.conf}} - config file with [[Account System|FAS]] credentials, used for services that require FAS authentication (like [[Bodhi]]); adjust only if you want to submit results using FAS</li> | ||
<li>{{filename|yourls.conf}} - config with [http://www.yourls.org yourls] shortening service credentials and other settings (refer to [[Install and configure YOURLS for AutoQA]]); adjust only if you want to enable URL shortening | <li>{{filename|yourls.conf}} - config with [http://www.yourls.org yourls] shortening service credentials and other settings (refer to [[Install and configure YOURLS for AutoQA]]); adjust only if you want to enable URL shortening | ||
<ul><li> | <ul><li>The <code>apiurl</code> option is based on main URL for YOURLS. If the main url is <code>http://localhost/report/</code>, then the <code>apiurl</code> would be <code>http://localhost/report/yourls-api.php</code>.</li> | ||
< | |||
</ | |||
</ul></li> | </ul></li> | ||
<li>{{filename|/etc/httpd/conf.d/wsgi.conf}} - The {{filename|git-post-receive}} relies on WSGI. Support for wsgi is provided by {{package|mod_wsgi}} and it must be manually enabled in the provided Apache configuration file.</li> | <li>{{filename|/etc/httpd/conf.d/wsgi.conf}} - The {{filename|git-post-receive}} relies on WSGI. Support for wsgi is provided by {{package|mod_wsgi}} and it must be manually enabled in the provided Apache configuration file.</li> |
Revision as of 15:32, 23 November 2011
This page details installing and configuring an AutoQA server. AutoQA is currently packaged for Fedora and EPEL, but due to library dependencies, the package is not yet available in official Fedora repositories. The following section describes how to install AutoQA.
Use the Right Repo
Configure the system to receive updates from the the AutoQA package repository. To use the AutoQA package repository, download the appropriate repository file listed below.
- For Fedora, execute the command:
wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/fedora-autoqa.repo
- Otherwise, for EPEL, execute the command:
wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/epel-autoqa.repo
Install AutoQA
Use the following yum command to install AutoQA and its dependencies:
yum install autoqa
Configure AutoQA
Almost all configuration files are stored in the /etc/autoqa
directory. They are well documented, edit them and adjust the settings to your needs. Available config file:
autoqa.conf
- main config filerepoinfo.conf
- package repository configuration (refer to How to update AutoQA repoinfo.conf)fas.conf
- config file with FAS credentials, used for services that require FAS authentication (like Bodhi); adjust only if you want to submit results using FASyourls.conf
- config with yourls shortening service credentials and other settings (refer to Install and configure YOURLS for AutoQA); adjust only if you want to enable URL shortening- The
apiurl
option is based on main URL for YOURLS. If the main url ishttp://localhost/report/
, then theapiurl
would behttp://localhost/report/yourls-api.php
.
- The
/etc/httpd/conf.d/wsgi.conf
- Thegit-post-receive
relies on WSGI. Support for wsgi is provided bymod_wsgi
and it must be manually enabled in the provided Apache configuration file./etc/httpd/conf.d/autoqa.conf
- AutoQA's apache configuration file, now used for custom 404 page
Configure Cron
On the server you will want to periodically run AutoQA watchers, which will schedule corresponding tests. We have prepared a cron file for these purposes, you can install it by:
cp /usr/share/autoqa/autoqa.cron /etc/cron.d/
If you think that some watcher should be run more or less frequently (or you want to disable some of them completely), just edit the installed cron file.