Meego Wiki
Views

Quality/QA-tools/OTS/UserDocumentation/Installation

From MeeGo wiki
< Quality | QA-tools | OTS | UserDocumentation(Difference between revisions)
Jump to: navigation, search
(How to install N900 automation tools to OTS worker)
(OTS server installation)
 
(7 intermediate revisions not shown)
Line 34: Line 34:
There are two ways of getting OTS binary packages: from '''the source code'''
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
or from the '''MeeGo Tools:Testing repository'''. From the repository you can get
-
the stable version and from the source code the development version.
+
the stable version and from the source code the development version. If you wish to install OTS from source follow instructions howto [[Quality/QA-tools/OTS/UserDocumentation/Installation#Building_packages_from_source|build packages from the source]].
-
* Add Tools:Testing apt source to /etc/apt/sources.list
+
=== Set up Tools:Testing repository ===
-
sudo nano /etc/apt/sources.list
+
-
deb http://download.meego.com/live/Tools:/Testing/xUbuntu_10.10/ /
+
-
Notice that if you are using Ubuntu 10.04, change the path.
+
-
* Add repository keys
+
By setting up the repository it allows you to install OTS and other MeeGo QA tools via apt-get command. Follow the [[Quality/QA-tools/How_to_set_up_repositories|instructions]].
-
gpg --keyserver subkeys.pgp.net --recv-keys 0BC7BEC479FC1F8A
+
-
gpg --export --armor 0BC7BEC479FC1F8A | sudo apt-key add -
+
-
 
+
-
* Update the repositories
+
-
sudo apt-get update
+
-
 
+
-
'''Build packages from source (optional)'''
+
-
* 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
+
== OTS server installation ==
== OTS server installation ==
-
 
-
* Install dependencies
 
-
sudo apt-get install python-django python-amqplib python-configobj rabbitmq-server test-definition
 
* Install OTS server components
* Install OTS server components
  sudo apt-get install python-ots-common python-ots-results python-ots-server
  sudo apt-get install python-ots-common python-ots-results python-ots-server
-
Or if you are using own built packages
 
-
sudo dpkg -i ...
 
* Configure OTS server settings
* Configure OTS server settings
-
  sudo nano /etc/ots_server.ini
+
  sudo nano /etc/ots/server.conf
Recommended to change following:
Recommended to change following:
Line 107: Line 80:
* Configure OTS worker settings
* Configure OTS worker settings
-
  sudo nano /etc/ots.ini
+
  sudo nano /etc/ots/worker.conf
Change 'devicegroup', example meego_n900
Change 'devicegroup', example meego_n900
Line 145: Line 118:
* Start OTS worker
* Start OTS worker
  sudo 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>

Latest revision as of 10:26, 2 August 2011

Contents

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>
Personal tools