Installation

The following steps will guide you through the setup process of Mozmill CI.

Prerequisites

Before you can install Mozmill CI make sure the following applications and tools are installed:

• Python 2.7 and Python header package (only necessary for Linux, e.g. on Ubuntu the python-dev package)
• libffi and libssl package (necessary for Linux if Python <2.7.10 is in use, e.g. on Ubuntu the libffi-dev and libssl-dev packages)
• [Java] (https://www.java.com/en/download/help/index_installing.xml) (Detailed instructions for: Ubuntu)
• git, curl, screen

Installation

There is no installation package available for Mozmill CI. So you will have to use Git to get a copy of all the files. This can be done from within a terminal window by executing the following command:

git clone git://github.com/mozilla/mozmill-ci.git mozmill-ci
cd mozmill-ci

It will create a new sub directory called mozmill-ci with all the files contained. If you want a different name for the folder, change the last argument to the above command.

Now you are ready to run the ./setup.sh script, which creates a new virtual environment for Python under jenkins-env, and automatically installs all the necessary packages and their dependencies via PyPI.

Optional Tools

To make it easier to work with Mozmill CI we propose to setup the following additional tools.

Screen

Screen is a window manager for the terminal console. You will be able to switch between multiple windows in the same terminal session. This is especially helpful if you want to connect via SSH to your Mozmill CI machine. With its help you can run all the different commands in parallel, and they are not stopped when you exit the terminal session.

This tool should be available by default on OS X and Linux, so it can directly be used. To make it easier for you we provide a .screenrc example configuration file. You can use it by launching screen via screen -c .screenrc. All the necessary virtual windows will already be open.