Smartphone Test Farm Setup Examples

This repository contains setup examples of openstf/stf on various hosts using Vagrant with VirtualBox provider.

Supported Hosts

• CoreOS

Requirements

• VirtualBox >= 5.0.0
• Vagrant >= 1.7.3

Setup

git clone https://github.com/openstf/setup-examples.git stf-setup-examples
cd stf-setup-examples

Run Rethinkdb Cluster

cd ./db
vagrant up

Above command will do

• Download ubuntu/trusty64 image if image is not present (this may take time depending on internet speed)
• Launch Ubuntu VM and set its IP to $rethinkdb_host_ip configured in Configuration File (Default: 198.162.50.11)
• Install and run rethinkdb server

You can confirm if rethinkdb is up by visiting rethinkdb admin console (http://198.162.50.11:8080 or http://RETHINKDB_HOST_IP:8080)

Run STF on CoreOS Cluster

Requirements

• Install fleetctl client
  • On OS X, you can install it using brew install fleetctl.
• Make sure that rethinkdb is running by following these instructions

Configuration

You can configure global variable present in CoreOS Configuration File according to your Requirements.

Run CoreOS Cluster

cd coreos
vagrant up

Above command will do

• Download CoreOS image if image is not present (this may take time depending on internet speed)
• Launch $num_instances configured in CoreOS Configuration File instances of CoreOS VM
• You can check if all the instances are running using vagrant global-status command

Configuring fleetctl

Next, we will be launching services inside CoreOS cluster using fleetctl. First we need to export a global variable FLEETCTL_ENDPOINT. This endpoint will tell fleetctl running on host os (OS X in my case) to talk with fleet daemon running inside one of the guest OS.

export FLEETCTL_ENDPOINT=http://172.17.8.101:2379

Using core-01 guest OS.

Now, run fleetctl list-machines command, You will see something like below

MACHINE     IP           METADATA
6e3e7dc2... 172.17.8.101 -
9821f508... 172.17.8.102 -
ab5747a8... 172.17.8.103 -

Now, your CoreOS cluster is ready to deploy STF Components.

Deploy STF Components

adbd.service

You need to have a single adbd.service unit running on each host where devices are connected.Global=true X-Fleet parameter in adbd.service will make it run on each cluster host.

Deploy using below command

fleetctl submit ./unit_files/adbd.service
fleetctl start adbd

It will take adbd.service some time to start on each host. Once it is done, you can check by running fleetctl list-units command. You will see

UNIT		MACHINE				ACTIVE	SUB
adbd.service	6e3e7dc2.../172.17.8.101	active	running
adbd.service	9821f508.../172.17.8.102	active	running
adbd.service	ab5747a8.../172.17.8.103	active	running

rethinkdb-proxy-28015.service

You need a single instance of the rethinkdb-proxy-28015.service unit on each host where you have another unit that needs to access the database. In this example we will run this unit on all host by setting Global=true parameter in rethinkdb-proxy-28015.service unit file.

Start service using

fleetctl submit ./unit_files/rethinkdb-proxy-28015.service
fleetctl start rethinkdb-proxy-28015

stf-migrate.service

This unit creates database and tables necessary for STF. This is a oneshot unit, meaning that it shuts down after it's done.

Start service using

fleetctl submit ./unit_files/stf-migrate.service
fleetctl start stf-migrate

Again, this unit will take time to start since, it will be downloading stf docker image for the first time.

Once the service is done, go to the rethinkdb admin console (http://198.162.50.11:8080/) and check if you can see [devices, logs, users, vncauth] tables in "Tables" tab.

stf-app@.service

This unit provides the main HTTP server. It can have many instances running on same or different host using different port. But in this example, we will run only one unit.

Start service using

fleetctl submit ./unit_files/stf-app@.service
fleetctl start stf-app@3100

This will run stf-app at 3100 port on one of the server. You can check where it is running by fleetctl list-units command.

stf-auth@.service

This unit is responsible for authorizing the user. STF provides many options for this. In this example we will use mock login.

Start service using

fleetctl submit ./unit_files/stf-auth@.service
fleetctl start stf-auth@3200

This will run stf-app at 3200 port on one of the server. You can check where it is running by fleetctl list-units command.

stf-triproxy-app.service

This unit provide triproxy service for application side.

Start service using

fleetctl submit ./unit_files/stf-triproxy-app.service
fleetctl start stf-triproxy-app

After running this service note the IP of the machine on which this unit is running by fleetctl list-units command. From now, we will call this IP as appside.stf.mydomain.org

stf-triproxy-dev.service

This unit provide triproxy service for device side.

Start service using

fleetctl submit ./unit_files/stf-triproxy-dev.service
fleetctl start stf-triproxy-dev

After running this service note the IP of the machine on which this unit is running by fleetctl list-units command. From now, we will call this IP as devside.stf.mydomain.org