Changes between Version 4 and Version 5 of FATE/Fateserver


Ignore:
Timestamp:
Mar 5, 2014, 4:48:29 AM (5 years ago)
Author:
Timothy_Gu
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • FATE/Fateserver

    v4 v5  
    11= fateserver =
    22
    3 fateserver is the server software used to power [http://fate.ffmpeg.org]. It is
    4 written by FFmpeg in 2011, in Perl CGI. The main repo for fateserver is located
    5 at [git://git.ffmpeg.org/fateserver], with a
    6 [https://github.com/FFmpeg/fateserver GitHub mirror].
     3fateserver is the server software used to power [http://fate.ffmpeg.org]. It is written by the FFmpeg Project in 2011, using Perl CGI. The main repo for fateserver is located at [git://git.ffmpeg.org/fateserver], with a [https://github.com/FFmpeg/fateserver GitHub mirror].
    74
    8 == Instructions on Installing fateserver ==
     5== Getting Started on Developing fateserver ==
    96
    10 When you make a change in fateserver, it is always a good idea to test whether
    11 everything work on your own work PC.
     7When you make a change in fateserver, it is always a good idea to test whether everything work on your own work PC.
     8
     9In this guide, we assume that the source will be located under `/var/www/fateserver`, and the data gathered from clients under `/var/www/fateweb`.
    1210
    13111. Get Apache httpd. On Debian derivatives do
     
    1513   sudo apt-get install apache2
    1614   }}}
    17 2. Get fateserver (from now on I'll assume fateserver is located under
    18    `/var/www/fateserver`).
     152. Change ownership of `/var/www` to the yourself so you can edit it.
     16
     17   This is only required if the fateserver source is located under a root-only directory like /var/www.
     18   {{{#!sh
     19   sudo chown -hR (yourusername):(yourusername) /var/www
     20   }}}
     21
     223. Get fateserver and `mkdir` server data directory.
    1923   {{{#!sh
    2024   cd /var/www
    2125   git clone git://git.ffmpeg.org/fateserver
     26   mkdir /var/www/fateweb
    2227   }}}
    2328
    24 3. Make /var/www/fateserver the root of the server. This is OS-dependant, but
    25    on Ubuntu you have to modify
    26    `/etc/apache2/sites-available/000-default.conf`: From
     293. Make /var/www/fateserver the root of the server. This is OS-dependant, but on Ubuntu you have to modify `/etc/apache2/sites-available/000-default.conf`: From
    2730   {{{
    2831   DocumentRoot /var/www
     
    4245   }}}
    4346
    44 5. Create an user for people to report using ssh with.
     475. Create a new user for fateserver.
     48
     49   This is not required, and is only recommended if you want to really set up a FATE website. If you just want to test fateserver, you don't need to.
    4550   {{{
    4651   sudo adduser fate
     52   chown -hR fate:fate /var/www/fatweb
    4753   }}}
    4854
    49 6. In that user's .ssh/authorized_keys, add one entry for each submitter with
    50    the following:
     556. In that user's `.ssh/authorized_keys`, add one entry for each submitter with the following:
    5156   {{{
    5257   command="FATEDIR=/var/www/fateweb FATE_USER=<some identifier of your choice for that submitter> /var/www/fateweb/fate-recv.sh" <submitter's public key>
    5358   }}}
    5459
    55    This makes sure they get identified for fateweb and they can only run that
    56    one command, so they don't get a shell.
     60   This makes sure they get identified for fateweb and they can only run that one command, so they don't get a shell.
    5761
    58 7. Edit FATE.pm, set the `$fatedir` variable to the fateweb path
     62   This is only required if you created a fate user.
     63
     647. Edit FATE.pm, set the `$fatedir` variable to the fateweb path, if yours is different from the default (`/var/www/fateweb`):
    5965   {{{#!perl
    60    our $fatedir = "/var/www/fateweb";
     66   our $fatedir = "/your/path";
    6167   }}}
    6268
    63 Thanks to Ramiro Polla for writing this guide. Major updates made by Timothy Gu.
     698. Now if you go to [http://localhost], you will be able to see a FATE error page because you have not feed it data to display yet.
    6470
    6571{{{
     
    6773
    6874'''Notes:'''
    69 fateserver can't be on a sub-dir.
    70 So it must be something like fate.ffmpeg.org, but can't be ffmpeg.org/fate.
    71 Otherwise the links are wrong and it won't load the CSS.
     75fateserver can't be on a sub-dir, which means that it must be something like fate.ffmpeg.org, but can't be ffmpeg.org/fate; or the links are wrong and it won't load the CSS.
    7276Some tools are also needed on the server, like xz.
    7377}}}
     78
     79Thanks to Ramiro Polla for writing the initial version of this guide. Major updates made by Timothy Gu.