Public | Automated Build

Last pushed: 13 days ago
Short Description
AutoPush Load Tester
Full Description

Autopush Load-Tester

The Autopush Load-Tester is an integrated API and load-tester for the Mozilla
Services autopush project. It's intented to verify proper functioning of
autopush deployments under various load conditions.

Supported Platforms

ap-loadtester should run on most Linux distro(s). Though we provide some
notes for OSX users (see below), please note that we only support usage
of this tool on Linux.

Getting Started

ap-loadtester uses PyPy 5.3.1 which can be downloaded here:
http://pypy.org/download.html

You will also need virtualenv installed on your system to setup a virtualenv for
ap-loadtester. Assuming you have virtualenv and have downloaded pypy, you
could then setup the loadtester for use with the following commands:

Linux:

$ tar xjvf pypy2-v5.3.1-linux64.tar.bz2
$ virtualenv -p pypy2-v5.3.1-linux64/bin/pypy apenv

OSX:

$ tar xjvf pypy2-v5.3.1-osx64.tar.bz2
$ virtualenv -p pypy2-v5.3.1-osx64/bin/pypy apenv

Activate Virtualenv:

$ source apenv/bin/activate
$ pip install --upgrade pip

The last two commands activate the virtualenv so that running python or pip on
the shell will run the virtualenv pypy, and upgrade the installed pip to the
latest version.

You can now either install ap-loadtester as a program to run
test scenarios you create, or if adding scenarios/code to ap-loadtester
continue to Developing.

Program Use

Install the ap-loadtester package:

$ pip install ap-loadtester

Run the basic scenario against the dev server:

$ aplt_scenario wss://autopush.dev.mozaws.net/ aplt.scenarios:basic

Run 5 instances of the basic scenario, starting one every second, against the
dev server:

$ aplt_testplan wss://autopush.dev.mozaws.net/ "aplt.scenarios:basic,5,1,0"

Either of these scripts can be run with -h for full help documentation.

See SCENARIOS for guidance on writing a scenario function for
use with ap-loadtester.

Developing

Checkout the code from this repository and run the package setup after the
virtualenv is active:

$ pip install -r requirements.txt -e .

See Contributing for contribution guidelines.

Notes on Installation

'openssl/aes.h' file not found

If you get the following error:

$ fatal error: 'openssl/aes.h' file not found

Linux: You'll need to install OpenSSL:

$ sudo apt-get install libssl-dev

OSX: Apple has deprecated OpenSSL in favor of its own TLS and crypto libraries.
If you get this error on OSX (El Capitan), install OpenSSL with brew, then
link brew libraries and install cryptography.
NOTE: /usr/local/opt/openssl is symlinked to brew Cellar:

$ brew install openssl
$ ARCHFLAGS="-arch x86_64" LDFLAGS="-L/usr/local/opt/openssl/lib" \
  CFLAGS="-I/usr/local/opt/openssl/include" pip install cryptography

missing required distribution pyasn1

If you get the following error:

$ error: Could not find required distribution pyasn1

re-run:

$ python setup.py develop
Docker Pull Command
Owner
bbangert
Source Repository

Comments (0)