Views

Quality/QA-tools/OTS/UserDocumentation/Installation

From MeeGo wiki

< Quality | QA-tools | OTS | UserDocumentation(Difference between revisions)

Jump to: navigation, search

Latest revision as of 10:26, 2 August 2011

1 OTS 0.8.x installation Ubuntu

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>

Retrieved from "http://wiki.meego.com/Quality/QA-tools/OTS/UserDocumentation/Installation"

@@ Line 1: / Line 1: @@
-= OTS Setup =
+= OTS 0.8.x installation Ubuntu =
+If using 0.1.x version, see [[Quality/QA-tools/OTS/UserDocumentation/Migration_0.1_0.8| migration from 0.1.x to 0.8.x]] document.
 == Used hardware ==
@@ Line 16: / Line 18: @@
 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.
-All OTS machines need to be able to access other OTS machines based on their hostname.
+'''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:
+. Check OTS server's hostname
+ hostname
+. 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 ==
@@ Line 22: / Line 34: @@
 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.
+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 ==
-* Install dependencies
- sudo apt-get install python-django python-amqplib python-configobj rabbitmq-server test-definition
 * Install OTS server components
   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
-  sudo nano /etc/ots_server.ini
+  sudo nano /etc/ots/server.conf
 Recommended to change following:
@@ Line 68: / Line 53: @@
 * Install OTS server plug-ins
-  [http://wiki.meego.com/Quality/QA-tools/OTS/Plugins/HTTP_logger Logger plug-in] (recommended)
+  [[Quality/QA-tools/OTS/Plugins/HTTP_logger|Logger plug-in]] (recommended)
-  [http://wiki.meego.com/Quality/QA-tools/OTS/Plugins/Email Email plug-in] (recommended)
+  [[Quality/QA-tools/OTS/Plugins/Email|Email plug-in]] (recommended)
-See more plug-ins from [http://wiki.meego.com/Quality/QA-tools/OTS/Plugins OTS Plug-ins]
+See more plug-ins from [[Quality/QA-tools/OTS/Plugins|OTS Plug-ins]]
 * If logger plug-in is installed
@@ Line 83: / Line 68: @@
   sudo chown <user>:<group> /var/log/ots
+* Now you can start OTS server
   ots_server
@@ Line 94: / Line 80: @@
 * Configure OTS worker settings
-  sudo nano /etc/ots.ini
+  sudo nano /etc/ots/worker.conf
 Change 'devicegroup', example meego_n900
 Change 'host' to server's address
-* Change permissions to OTS worker log
- sudo chown <user>:<group> /var/log/ots.log
 * Start OTS worker
-  ots_worker
+  sudo ots_worker
 == OTS tools ==
@@ Line 115: / Line 98: @@
 * 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
-* Kickstart file for automation can be found from
- http://meego.gitorious.org/meego-quality-assurance/enables-automated-testing/blobs/ks/meego-n900-autotest.ks
-* You need to build the image with mic-image-creator with parameters:
- --save-kernel --package=tar.gz
 == 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-flaster eat-host-ubuntu
+  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
-* Configure conductor to use rpm and fetch /var/log/messages
+* Start HAT driver
-  sudo nano /etc/conductor.conf
+  sudo hat_drv &
-* If you want run ots_worker as user, copy SSH keys to the user and make udev rule for n900
+* Test manually that everything is OK, this is executed in the worker
- install-eat-key.sh
+  sudo conductor -u <image url>
-  sudo nano /etc/udev/rules.d/meego-n900.rules
- SUBSYSTEMS=="usb", ATTR{idVendor}=="0421", ATTR{idProduct}=="0105", GROUP="<group>", MODE="0664"
-* Create a power_cycle.sh script for turning N900 on/off. This requires external accessory, like [http://wiki.meego.com/Quality/QA-tools/hat-control HAT]
+* Start OTS worker
-  sudo nano /usr/bin/power_cycle.sh
+  sudo ots_worker
- #!/bin/bash
+== Building packages from source ==
- hat_drv &
- hat_ctrl -pwr1=off
- hat_ctrl -usb1data=off
- hat_ctrl -usb1pwr=off
- sleep 2;
- hat_ctrl -usb1pwr=on
- hat_ctrl -usb1data=on
- hat_ctrl -pwr1=on
- killall hat_drv
-* Test manually that everything is OK, this is executed in the worker
+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.
-  conductor -u <image url>
+* 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>