QA/Telemetry/Installing Staging Server: Difference between revisions

Line 1: Line 1:
= Short Summary =
= Quick Summary =


The following document will guide users on how to install and setup a telemetry experiment staging server on the local machine. Once the staging server is installed, Firefox will be able to contact the server and install the current experiment.
The following document will guide users on how to install and setup a telemetry experiment staging server on the local machine. Once the staging server is installed, Firefox will be able to contact the server and install the current experiment.
Line 11: Line 11:
* This guide assumes that you're using either OSX or Linux. Trying to get the server working on Windows is just a pain.
* This guide assumes that you're using either OSX or Linux. Trying to get the server working on Windows is just a pain.
* This can also be installed on a cloud instance and doesn't necessarily have to be installed locally. I personally have a telemetry experiment installed on a Digital Ocean linux instance that I use as my main testing server.
* This can also be installed on a cloud instance and doesn't necessarily have to be installed locally. I personally have a telemetry experiment installed on a Digital Ocean linux instance that I use as my main testing server.
= Setup =
* The first step is to run the OSX m-c bootstrap, the command can be found in the link below: (right below '''One-Line Setup (Try This First!)''')
** https://developer.mozilla.org/en-US/docs/Developer_Guide/Build_Instructions/Mac_OS_X_Prerequisites
* Clone the telemetry experiment server using the following command:
** '''hg clone http://hg.mozilla.org/webtools/telemetry-experiment-server/'''
* Once cloned, a directory named '''telemetry-experiment-server''' should have been created
* Switch into the '''telemetry-experiment-server''' directory
* Checkout the latest branch using the following command:
** '''hg checkout <branch #>'''
*** Example: '''hg checkout 42b785b60c60'''
* Once you've checked out the latest branch, will need to install '''genshi''' as it's a prerequisite for building our local server
* To install '''genshi''' simply type '''pip install Genshi''' in the terminal and follow the onscreen directions
Confirmed users
924

edits