Changeset 165411 in webkit


Ignore:
Timestamp:
Mar 10, 2014 4:01:18 PM (10 years ago)
Author:
zoltan@webkit.org
Message:

Update the install guidelines for perf.webkit.org
​https://bugs.webkit.org/show_bug.cgi?id=129895

Reviewed by Ryosuke Niwa.

The current install guideline for perf.webkit.org discourages the use of the installed
Server application. I've actualized the documentation for Mavericks, and modified the
guideline to include the instructions for Server.app also.

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

Legend:

Unmodified
Added
Removed

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

    r165338 r165411  
     12014-03-10  Zoltan Horvath  <zoltan@webkit.org>
     2
     3        Update the install guidelines for perf.webkit.org
     4        https://bugs.webkit.org/show_bug.cgi?id=129895
     5
     6        Reviewed by Ryosuke Niwa.
     7
     8        The current install guideline for perf.webkit.org discourages the use of the installed
     9        Server application. I've actualized the documentation for Mavericks, and modified the
     10        guideline to include the instructions for Server.app also.
     11
     12        * Install.md:
     13
    1142014-03-08  Zoltan Horvath  <zoltan@webkit.org>
    215

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

    r163688 r165411  
    11# Checking Out the Code and Installing Required Applications
    22
    3 Note: These instructions assume you're using Mac OS X Mountain Lion as the host server, and assume that we're installing
    4 this application at `/Volumes/Data/WebKitPerfMonitor`.
     3The instructions assume you're using Mac OS X (Mavericks for Server.app case and Mountain Lion without Server.app) as the
     4host server, and assume that we're installing this application at `/Volumes/Data/WebKitPerfMonitor`.
    55
    6 1. Install Server (DO NOT launch the Server app)
     6You can choose between using Server.app or install the required tools separately
     7
     81. Install Server.app (if you don't want to use Server.app, install PostgreSQL: http://www.postgresql.org/download/macosx/)
    792. Install node.
    8103. Install Xcode with command line tools (only needed for svn)
    … …  
    1315# Configuring Apache
    1416
    15 Don't use the Server App to start or stop Apache. It does weird things to httpd configurations. Use apachectl instead:
    16  - Starting httpd: `sudo apachectl stop`
    17  - Stopping httpd: `sudo apachectl restart`
     17You can use apachectl to start/stop/restart apache server from the command line:
    1818
    19 ## Edit /private/etc/apache2/httpd.conf
     19 - Starting httpd: `sudo apachectl start`
     20 - Stopping httpd: `sudo apachectl stop`
     21 - Restarting httpd: `sudo apachectl restart`
    2022
    21 1. Update ServerAdmin to your email address
    22 2. Change DocumentRoot to `/Volumes/Data/WebKitPerfMonitor/public/`
    23 3. Uncomment `"LoadModule php5_module libexec/apache2/libphp5.so"`
    24 4. Modify the directives for the document root and / to allow overriding `"All"`
    25 5. Delete directives on CGI-Executables
    26 6. Add the following directives to enable gzip:
    27    
     23## Instructions if you're using Server.app
     24
     25 - Enable PHP web applications
     26 - Go to Server Website / Store Site Files In, change it to /Volumes/Data/WebKitPerfMonitor/public/`
     27 - Go to Server Website / Edit advanced settings, enable Allow overrides using .htaccess files
     28
     29## Instructions if you're not using Server.app
     30
     31 - Edit /private/etc/apache2/httpd.conf
     32
     33     1. Change DocumentRoot to `/Volumes/Data/WebKitPerfMonitor/public/`
     34     2. Uncomment `"LoadModule php5_module libexec/apache2/libphp5.so"`
     35     3. Modify the directives for the document root and / to allow overriding `"All"`
     36     4. Delete directives on CGI-Executables
     37
     38## Common directives for the related apache config file
     39
     40  httpd config file is located at:
     41
     42    - With Server.app: /Library/Server/Web/Config/apache2/sites/0000_any_80.conf (and/or 0000_any_`PORT#`.conf)
     43    - Without: /private/etc/apache2/httpd.conf
     44
     45 1. Update ServerAdmin to your email address
     46 2. Add the following directives to enable gzip:
     47
    2848        <IfModule mod_deflate.c>
    2949            AddOutputFilterByType DEFLATE text/html text/xml text/plain application/json application/xml application/xhtml+xml
    3050        </IfModule>
    3151
    32 7. Add the following directives to enable zlib compression and MultiViews on WebKitPerfMonitor/public:
     52 3. Add the following directives to enable zlib compression and MultiViews on WebKitPerfMonitor/public:
    3353
    3454        Options Indexes MultiViews
    3555        php_flag zlib.output_compression on
    3656
    37 Note: If you've accidentally turned on the Server app, httpd.conf is located at `/Library/Server/Web/Config/apache2/` instead.
    38 Delete the Web Sharing related stuff and include `/private/etc/apache2/httpd.conf` at the very end.
    39 
    40 The log is located at `/private/var/log/apache2`.
     57The apache logs are located at `/private/var/log/apache2`.
    4158
    4259
    … …  
    5673        Require valid-user
    5774
    58 where <Realm> is replaced with the realm of your choice.
     75where <Realm> is replaced with the realm of your choice, which will be displayed on the username/password input box.
    5976
    6077
    … …  
    6885## Creating a Database and a User
    6986
     87The binaries located in PostgreSQL's directory, or if you're using Server.app in /Applications/Server.app/Contents/ServerRoot/usr/bin/
     88
    70891. Create a database: `createdb webkit-perf-db -h localhost`
    71902. Create a user: `createuser -P -S -e webkit-perf-db-user -h localhost`
Note: See TracChangeset for help on using the changeset viewer.