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.

Please note, that this application is not installable via PIP or any other python installation application or process.

This application 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.

This application 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 this application. 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 run this program as a program to run test scenarios you create, or if adding scenarios/code to this application continue to Developing.

Run the basic scenario against the dev server:

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

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

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

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 this application.

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.

'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