From Fedora Project Wiki

(mention also autotest-server installation, since it's needed)
m (fix cron path)
 
(14 intermediate revisions by 4 users not shown)
Line 10: Line 10:
* Otherwise, for '''EPEL''', execute the command: {{command|wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/epel-autoqa.repo}}  
* Otherwise, for '''EPEL''', execute the command: {{command|wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/epel-autoqa.repo}}  


= Install Autotest Server (optional) =
{{admon/note|updates-testing?|Just like with Fedora, there is an autoqa <code>updates-testing</code> package repository.  If you would like to test early releases of autoqa, and related packages, subscribe to the following package repositories:
 
* For '''Fedora''', execute the command: {{command|wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/fedora-autoqa-testing.repo}}
Most probably you will want to use server-client architecture: server scheduling jobs and clients executing them (see [[AutoQA architecture]]). In this case you need to install Autotest server prior to installing AutoQA. Follow the guide [[Install and configure autotest]].
* Otherwise, for '''EPEL''', execute the command: {{command|wget -P /etc/yum.repos.d http://repos.fedorapeople.org/repos/fedora-qa/autoqa/epel-autoqa-testing.repo}}
 
}}
If you don't install Autotest server, you will still be able to manually execute any test on the local machine. This may be convenient e.g. for test development needs.


= Install AutoQA =
= Install AutoQA =
Line 21: Line 20:


<pre>yum install autoqa</pre>
<pre>yum install autoqa</pre>
{{admon/question|Need autotest-server?|If you are planning to use AutoQA to develop and run tests on a single system, the {{package|autoqa}} package is all you'll need.  However, if you want multiple systems scheduling and running tests (see [[AutoQA architecture]]), you will want to install the {{package|autotest-server}} package.  For more information, see [[Install and configure autotest]].}}


= Configure AutoQA =
= Configure AutoQA =


All the configuration files are stored in ''/etc/autoqa/''. They are well documented, edit them and adjust the settings to your needs. Available config files:
AutoQA tries to have reasonable defaults. But you will still probably want to configure additional optional services that can be integrated into AutoQA. Read more at [[AutoQA Configuration]] to see the list of available configuration files and their settings.
* {{filename|autoqa.conf}} - main config file
* {{filename|fas.conf}} - config file with [[Account System|FAS]] credentials, used for services that require FAS authentication (like [[Bodhi]])


= Configure Cron =
= Configure Cron =
Line 32: Line 31:
On the server you will want to periodically run AutoQA [[AutoQA architecture|watchers]], which will schedule corresponding tests. We have prepared a cron file for these purposes, you can install it by:
On the server you will want to periodically run AutoQA [[AutoQA architecture|watchers]], which will schedule corresponding tests. We have prepared a cron file for these purposes, you can install it by:
<pre>
<pre>
cp /usr/share/autoqa/autoqa.cron /etc/cron.d/
cp /usr/share/doc/autoqa-*/autoqa.cron /etc/cron.d/
</pre>
</pre>
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.
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.


[[Category:AutoQA]]
[[Category:AutoQA]]

Latest revision as of 16:33, 11 January 2012

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.

updates-testing?
Just like with Fedora, there is an autoqa updates-testing package repository. If you would like to test early releases of autoqa, and related packages, subscribe to the following package repositories:

Install AutoQA

Use the following yum command to install AutoQA and its dependencies:

yum install autoqa
Need autotest-server?
If you are planning to use AutoQA to develop and run tests on a single system, the autoqa package is all you'll need. However, if you want multiple systems scheduling and running tests (see AutoQA architecture), you will want to install the autotest-server package. For more information, see Install and configure autotest.

Configure AutoQA

AutoQA tries to have reasonable defaults. But you will still probably want to configure additional optional services that can be integrated into AutoQA. Read more at AutoQA Configuration to see the list of available configuration files and their settings.

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/doc/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.