Latest revision as of 10:26, 2 August 2011

OTS 0.8.x installation Ubuntu

If using 0.1.x version, see migration from 0.1.x to 0.8.x document.

Used hardware

1 x Server (Ubuntu 10.10)

1 x Client (Ubuntu 10.10)

1 x HAT controller

1 x Power cable

1 x Power supply

2 x USB A-B cable

1 x USB A-microB cable

1 x N900

Network Setup

Using static IP addresses on all OTS machines is strongly recommended. It is possible to setup the system also with dynamic IP addresses but it might cause problems every now and then because IP's and hostnames change.

Note All OTS machines need to be able to access other OTS machines based on their hostname.

How to check that DNS names are correct:

1. Check OTS server's hostname

hostname

2. Ping the OTS server's hostname from the OTS worker

ping <hostname>

If ping fails, add manually OTS server's hostname to OTS workers /etc/hosts file

<IP> <hostname>

Preparation

There are two ways of getting OTS binary packages: from the source code or from the MeeGo Tools:Testing repository. From the repository you can get the stable version and from the source code the development version. If you wish to install OTS from source follow instructions howto build packages from the source.

Set up Tools:Testing repository

By setting up the repository it allows you to install OTS and other MeeGo QA tools via apt-get command. Follow the instructions.

OTS server installation

• Install OTS server components

sudo apt-get install python-ots-common python-ots-results python-ots-server

• Configure OTS server settings

sudo nano /etc/ots/server.conf

Recommended to change following:

'example_sw_product', example to 'meego_product'
'devicegroup', example to 'meego_n900'

• Install OTS server plug-ins

Logger plug-in (recommended)
Email plug-in (recommended)

See more plug-ins from OTS Plug-ins

• If logger plug-in is installed

Change permissions to logging directory
sudo chown www-data:www-data /var/log/ots

Now the OTS server can be used via apache (django_xmlrpc).

• If logger plug-in is not installed

Change user permissions to logging directory
sudo chown <user>:<group> /var/log/ots

• Now you can start OTS server

ots_server

OTS worker installation

• Install dependencies

sudo apt-get install python-amqplib testrunner-lite

• Install OTS worker packages

sudo apt-get install python-ots-common python-ots-worker

• Configure OTS worker settings

sudo nano /etc/ots/worker.conf

Change 'devicegroup', example meego_n900

Change 'host' to server's address

• Start OTS worker

sudo ots_worker

OTS tools

Tools are used for triggering test runs from the command line.

• Install OTS tools

sudo apt-get install python-ots-tools

• Trigger a test run

ots_trigger -s localhost/xmlrpc -b test_build -i http://url_to_image -p example_sw_product -e test@man.com

How to install N900 automation tools to OTS worker

• Remove network-manager, because it breaks the USB connection. See more information from autotest-guide.

• Install dependencies

sudo apt-get install meego-ai-flasher eat-host-ubuntu

• Get N900 flasher from the Nokia's tablets-dev portal

http://tablets-dev.nokia.com/maemo-dev-env-downloads.php?f=maemo_flasher-3.5_2.5.2.2_i386.deb
sudo dpkg -i maemo_flasher-3.5_2.5.2.2_i386.deb

• Start HAT driver

sudo hat_drv &

• Test manually that everything is OK, this is executed in the worker

sudo conductor -u <image url>

• Start OTS worker

sudo ots_worker

Building packages from source

If you which to build your own packages and install OTS from them here are the instructions. But it is recommended to install OTS using the repository.

• Install git core

sudo apt-get install git-core

• Get sources

git clone git://gitorious.org/meego-quality-assurance/ots.git

• Get building tools

sudo apt-get install dpkg-dev debhelper python-setuptools

• Build packages

cd ots
dpkg-buildpackage -rfakeroot

• Install dependencies

sudo apt-get install python-django python-amqplib python-configobj rabbitmq-server test-definition

• Now you can install the packages

sudo dpkg -i <package>