This commit is contained in:
Hannes Verschore 2017-03-27 03:16:36 -07:00
Родитель 69deadfd4b c9037c4a07
Коммит 93fb899a8d
1 изменённых файлов: 3 добавлений и 62 удалений

Просмотреть файл

@ -9,69 +9,10 @@ over time.
A public instance is hosted by Mozilla and running at
[https://arewefastyet.com](https://arewefastyet.com).
Components
==========
Full Documentation
==================
Slave:
1. Builder: A python driver (build.py) that can create shell builds of
spidermonkey/jsc/v8.
2. Downloader: A python driver (download.py) that can download browser builds
of Firefox.
3. Executor: (execute.py) is a python script that executes one or multiple
benchmarks on one or more builds.
Site:
1. Database: MySQL database that stores statistics.
2. Collector: Hidden PHP script on the webserver, where stats get sent.
(UPDATE.php in below diagram)
3. Processor: Python aggregator that builds JSON data from the DB. (update.py
in below diagram)
4. Website: Static HTML as the frontpage, that queries JSON via XHR.
5. Command center: Sends commands to the slaves on what to execute. (In
construction.)
Components (2) and (4) must be on the same webserver, otherwise timestamps
might not be computed correctly.
Keep in mind, most of this documentation is for posterity. AWFY was never
intended to be a drag-and-drop all-in-one released product, so the procedures
and scripts may be pretty rough.
System Diagram
==============
<!--
Image source at
https://docs.google.com/drawings/d/1TlzFOMz4oxKYSD_hHqe-fL2wpAA5WwhEq62KJp0TytI/edit?usp=sharing
To edit it, 'make a copy' (from file menu) and edit that.
-->
![Alt text](/docs/awfy_system_diagram.png "System Diagram")
Benchmark locally
=================
1. Fetch the repo
2. Create a (shell) or retrieve a (browser) build to benchmark
* Creating a build:
```
cd slave
python build.py -s mozilla
```
* Pull a build:
```
cd slave
python download.py http://archive.mozilla.org/pub/mozilla.org/firefox/tinderbox-builds/mozilla-inbound-linux/latest/
```
3. Benchmark
```
python execute.p -b remote.octane -b remote.kraken
```
See the [Wiki](https://github.com/h4writer/arewefastyet/wiki/) for full documentation, examples, operational details and other information.
Installation
============