Provisioning
============

UTAH is very simple in terms of testing reliably and being able to reproduce a
test run in a consistent manner. A command line specifies the test environment,
type of machine to test on and a runlist. Then wait for it to finish and
analyze the results.

UTAH can drive testing on whichever machine it is running or on a different one,
by provisioning it with a particular provisioning method.

**WARNING: Your machine will be modified, not to interfere with your current
set-up or virtualized environment, so UTAH will create a new user called utah
with sudo privileges to run the tests and have an inventory of existing VMs
that you could be interested in for running tests.**

Installation
------------

There are some dependencies that need to be met in order to test with VMs, in a
nutshell::

    sudo apt-add-repository -y ppa:utah/stable
    sudo apt-get update
    sudo apt-get install utah

This will install the provisioning code as well as the test runner.  To install
just the test runner, install the utah-client package.

Provision and Test
------------------

Using a Touch Device
~~~~~~~~~~~~~~~~~~~~

.. include:: run_utah_phablet.txt


Using an x86 Virtual Machine
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. include:: run_utah_tests.txt