⚠ Archived content — this site is no longer maintained.   Current WebKit documentation is at docs.webkit.org.

Changeset 185676 in webkit


Ignore:
Timestamp:
Jun 17, 2015, 4:23:51 PM (11 years ago)
Author:
rniwa@webkit.org
Message:

Update ReadMe.md and Install.md per database changes
​https://bugs.webkit.org/show_bug.cgi?id=146076

Reviewed by Darin Adler.

Updated.

  • Install.md:
  • ReadMe.md:
Location:
trunk/Websites/perf.webkit.org
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/Websites/perf.webkit.org/ChangeLog

    r185667 r185676  
     12015-06-17  Ryosuke Niwa  <rniwa@webkit.org>
     2
     3        Update ReadMe.md and Install.md per database changes
     4        https://bugs.webkit.org/show_bug.cgi?id=146076
     5
     6        Reviewed by Darin Adler.
     7
     8        Updated.
     9
     10        * Install.md:
     11        * ReadMe.md:
     12
    1132015-06-17  Ryosuke Niwa  <rniwa@webkit.org>
    214

  • trunk/Websites/perf.webkit.org/Install.md

    r176277 r185676  
    3333     1. Change DocumentRoot to `/Volumes/Data/perf.webkit.org/public/`
    3434     2. Uncomment `"LoadModule php5_module libexec/apache2/libphp5.so"`
    35      3. Disable directives for CGI-Executables
    3635
    3736 - In Mavericks and later, copy php.ini to load pdo_pgsql.so pgsql.so.
    … …  
    6867We recommend protection via Digest Auth on https connection.
    6968
    70 Generate a password file via `htdigest -c <path> <realm> <username>`, and then create admin/.htaccess with:
     69Generate a password file via `htdigest -c <path> <realm> <username>`, and then create admin/.htaccess with the following directives
     70where `<Realm>` is replaced with the realm of your choice, which will be displayed on the username/password input box:
    7171
    72         AuthType Digest
    73         AuthName "<Realm>"
    74         AuthDigestProvider file
    75         AuthUserFile "<Realm>"
    76         Require valid-user
    77 
    78 where <Realm> is replaced with the realm of your choice, which will be displayed on the username/password input box.
    79 
     72```
     73AuthType Digest
     74AuthName "<Realm>"
     75AuthDigestProvider file
     76AuthUserFile "<Realm>"
     77Require valid-user
     78```
    8079
    8180# Configuring PostgreSQL
    8281
    83821. Create database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/initdb /Volumes/Data/perf.webkit.org/PostgresSQL`
    84 2. Start database:
    85    `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_ctl -D /Volumes/Data/perf.webkit.org/PostgresSQL
    86    -l logfile -o "-k /Volumes/Data/perf.webkit.org/PostgresSQL" start`
     832. Start database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_ctl -D /Volumes/Data/perf.webkit.org/PostgresSQL -l logfile -o "-k /Volumes/Data/perf.webkit.org/PostgresSQL" start`
    8784
    8885## Creating a Database and a User
    … …  
    9087The binaries located in PostgreSQL's directory, or if you're using Server.app in /Applications/Server.app/Contents/ServerRoot/usr/bin/
    9188
    92 1. Create a database: `createdb webkit-perf-db -h localhost`
    93 2. Create a user: `createuser -P -S -e webkit-perf-db-user -h localhost`
    94 3. Connect to database: `psql webkit-perf-db -h localhost`
     891. Create a database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/createdb webkit-perf-db -h localhost`
     902. Create a user: `/Applications/Server.app/Contents/ServerRoot/usr/bin/createuser -P -S -e webkit-perf-db-user -h localhost`
     913. Connect to database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/psql webkit-perf-db -h localhost`
    95924. Grant all permissions to the new user: `grant all privileges on database "webkit-perf-db" to "webkit-perf-db-user";`
    96935. Update database/config.json.
    … …  
    9996
    10097Run `database/init-database.sql` in psql as `webkit-perf-db-user`:
    101 `psql webkit-perf-db -h localhost --username webkit-perf-db-user -f init-database.sql`
     98`/Applications/Server.app/Contents/ServerRoot/usr/bin/psql webkit-perf-db -h localhost --username webkit-perf-db-user -f init-database.sql`
    10299
    103100## Making a Backup of the Database
    104101
    105 Run `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_dump -h localhost --no-owner -f <filepath> safari-perf-db`
     102Run `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_dump -h localhost --no-owner -f <filepath> webkit-perf-db | gzip > backup.gz`
     103
     104To restore, setup a new database and run `gunzip backup.gz | /Applications/Server.app/Contents/ServerRoot/usr/bin/psql webkit-perf-db -h localhost --username webkit-perf-db-user`

  • trunk/Websites/perf.webkit.org/ReadMe.md

    r165338 r185676  
    8585To submit the results of a new test to an instance of the app, you need the following:
    8686
    87  - A builder already added on `/admin/builders`
     87 - A slave on `/admin/slaves`
    8888 - A script that submits a JSON payload of the supported format via a HTTP/HTTPS request to `/api/report`
    8989
    … …  
    9494contain the following key-value pairs representing a single run of tests on a single build:
    9595
    96 - `builderName` - The name of a builder present on `/admin/builders`.
    97 - `builderPassword` - The password associated with the builder.
     96- `builderName` - The name of a builder. A single slave may submit to multiple builders.
     97- `slaveName` - The name of a slave present on `/admin/slaves`.
     98- `slavePassword` - The password associated with the slave.
    9899- `buildNumber` - The string that uniquely identifies a given build on the builder.
    99100- `buildTime` - The time at which this build started in **UTC** (Use ISO time format such as
    … …  
    114115    - `tests` - A dictionary of tests; the same format as this dictionary.
    115116
    116 A sample JSON:
     117In the example below, we have the top-level test named "PageLoadTime". It measures two metrics: `Time` and `FrameRate`.
     118`Time` metric is the arithmetic mean of each subtest's `Time` metric (webkit.org and www.w3.org).
     119The computed arithmetic means are `[965.6, 981.35, 947.15]` in this case.
     120The test also reports `FrameRate` but this metric is measured only for the entire suite not per each subtest.
    117121
     122```json
    118123[{
    119124    "buildNumber": "651",
    120125    "buildTime": "2013-01-31T22:22:12.121051",
    121     "builderName": "bot-111",
    122     "builderPassword": "********",
     126    "builderName": "Trunk Mountain Lion Performance Tests",
     127    "slaveName": "bot-111",
     128    "slavePassword": "somePassword",
    123129    "platform": "Mountain Lion",
    124130    "revisions": {
    … …  
    132138    },
    133139    "tests": {
    134         "PageLoadingTest": {
     140        "PageLoadTime": {
    135141            "metrics": {
    136                 "Time": [
    137                     "Arithmetic",
    138                     "Geometric"
    139                 ]
    140             },
     142                "Time": ["Arithmetic"],
     143                "FrameRate": {
     144                    "current": [31, 24, 29]
     145                }
     146            }
    141147            "tests": {
    142148                "webkit.org": {
    143149                    "metrics": {
    144150                        "Time": {
    145                             "current": [
    146                                 629.1,
    147                                 654.8,
    148                                 598.9
    149                             ]
     151                            "current": [629.1, 654.8, 598.9]
    150152                        }
    151                     }
     153                    },
     154                    "url": "https://webkit.org/"
    152155                },
    153                 "url": "http://www.webkit.org/"
    154             }
    155         }
     156                "www.w3.org": {
     157                    "metrics": {
     158                        "Time": {
     159                            "current": [1302.1, 1307.9, 1295.4]
     160                        }
     161                    },
     162                    "url": "https://www.w3.org/"
     163                },
     164            },
     165        },
    156166    }
    157167}]
     168```
    158169
    159170FIXME: Add a section describing how the application is structured.
Note: See TracChangeset for help on using the changeset viewer.