INSTALL

   1 Setup on Arch Linux:
   2 ====================
   3 1) Install Apache, MySQL, PHP, git and php-pear
   4   # pacman -Syu apache mysql php git php-pear
   5
   6 2) Set a local 'hostname' of 'aur'
   7  - Edit /etc/hosts and append 'aur' to loopback address
   8    127.0.0.1    localhost aur
   9
  10 3) Configure Apache
  11
  12  - Edit /etc/httpd/conf/httpd.conf and enable PHP support
  13    by adding the following lines.
  14
  15    LoadModule php5_module modules/libphp5.so
  16    Include conf/extra/php5_module.conf
  17
  18  - Also append the following snippet to enable the aur
  19    Virtual Host in /etc/httpd/conf/extra/httpd-vhosts.conf.
  20          Comment out the example vhosts and replace MYUSER with your username.
  21          (You could put aur in /srv/http/aur and then create a symlink in ~ )
  22
  23    <VirtualHost aur:80>
  24    Servername    aur
  25    DocumentRoot  /home/MYUSER/aur/web/html
  26    ErrorLog    /var/log/httpd/aur-error.log
  27    CustomLog   /var/log/httpd/aur-access.log combined
  28      <Directory /home/MYUSER/aur/web/html>
  29        Options Indexes FollowSymLinks
  30        AllowOverride All
  31        Order allow,deny
  32        Allow from all
  33      </Directory>
  34    </VirtualHost>
  35
  36  - In httpd.conf, uncomment this line:
  37
  38    Include conf/extra/httpd-vhosts.conf
  39
  40 4) Clone the AUR project (using the MYUSER from above)
  41    $ cd
  42    $ git clone git://projects.archlinux.org/aur.git
  43
  44 5) Configure PHP
  45    Make sure you have mysql and json enabled in PHP.
  46
  47  - Edit php.ini and uncomment/add this line:
  48    extension=pdo_mysql.so
  49
  50    If this PHP extension is a separate package on your system, install it.
  51
  52 6) Configure MySQL
  53  - Start the MySQL service. Example:
  54    # systemctl start mysqld
  55
  56  - Create database
  57    # mysqladmin -p create AUR
  58
  59  - Connect to the mysql client
  60    $ mysql -uroot -p AUR
  61
  62  - Issue the following commands to the mysql client
  63    mysql> GRANT ALL PRIVILEGES ON AUR.* to aur@localhost
  64        -> identified by 'aur';
  65    mysql> FLUSH PRIVILEGES;
  66    mysql> quit
  67
  68  - Load the schema file
  69    $ mysql -uaur -p AUR < ~/aur/schema/aur-schema.sql
  70    (give password 'aur' at the prompt)
  71
  72  - Optionally load some test data for development purposes.
  73    # pacman -S words fortune-mod
  74    $ cd ~/aur/schema/
  75    $ python gendummydata.py dummy-data.sql
  76    $ bzip2 dummy-data.sql
  77    $ bzcat dummy-data.sql.bz2 | mysql -uaur -p AUR
  78    (give password 'aur' at the prompt)
  79
  80    If your test data consists of real people and real email addresses consider
  81    inserting bogus addressess to avoid sending unwanted spam from testing. You
  82    can insert garbage addresses with:
  83    mysql> UPDATE Users SET Email = RAND() * RAND();
  84
  85 7) Copy the config.inc.php.proto file to config.inc.php. Modify as needed.
  86    $ cd ~/aur/web/lib/
  87    $ cp config.inc.php.proto config.inc.php
  88
  89    In case you set $USE_VIRTUAL_URLS to true (default nowadays) you should add
  90    a rewrite rule. For Apache, add this ~/aur/web/html/.htaccess:
  91
  92    RewriteEngine on
  93    RewriteCond %{REQUEST_URI} !^/index.php
  94    RewriteRule ^(.*)$ /index.php/$1
  95
  96 8) Point your browser to http://aur