summaryrefslogtreecommitdiffstats
path: root/INSTALL
blob: cbb9f44ef66c2762beedd383e6fc42c25d8426de (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Setup on Arch Linux:
====================
1) Install Apache, MySQL, PHP, git and php-pear
  # pacman -Syu apache mysql php git php-pear

2) Set a local 'hostname' of 'aur'
 - Edit /etc/hosts and append 'aur' to loopback address
   127.0.0.1    localhost aur

3) Configure Apache

 - Edit /etc/httpd/conf/httpd.conf and enable PHP support
   by adding the following lines.

   LoadModule php5_module modules/libphp5.so
   Include conf/extra/php5_module.conf

 - Also append the following snippet to enable the aur
   Virtual Host in /etc/httpd/conf/extra/httpd-vhosts.conf.
	 Comment out the example vhosts and replace MYUSER with your username.
	 (You could put aur in /srv/http/aur and then create a symlink in ~ )

   <VirtualHost aur:80>
   Servername    aur
   DocumentRoot  /home/MYUSER/aur/web/html
   ErrorLog    /var/log/httpd/aur-error.log
   CustomLog   /var/log/httpd/aur-access.log combined
     <Directory /home/MYUSER/aur/web/html>
       Options Indexes FollowSymLinks
       AllowOverride All
       Order allow,deny
       Allow from all
     </Directory>
   </VirtualHost>

 - In httpd.conf, uncomment this line:

   Include conf/extra/httpd-vhosts.conf

4) Clone the AUR project (using the MYUSER from above)
   $ cd
   $ git clone git://projects.archlinux.org/aur.git

5) Configure PHP
   Make sure you have mysql and json enabled in PHP.

 - Edit php.ini and uncomment/add this line:
   extension=pdo_mysql.so

   If this PHP extension is a separate package on your system, install it.

6) Configure MySQL
 - Start the MySQL service. Example:
   # systemctl start mysqld

 - Create database
   # mysqladmin -p create AUR

 - Connect to the mysql client
   $ mysql -uroot -p AUR

 - Issue the following commands to the mysql client
   mysql> GRANT ALL PRIVILEGES ON AUR.* to aur@localhost
       -> identified by 'aur';
   mysql> FLUSH PRIVILEGES;
   mysql> quit

 - Load the schema file
   $ mysql -uaur -p AUR < ~/aur/schema/aur-schema.sql
   (give password 'aur' at the prompt)

 - Optionally load some test data for development purposes.
   # pacman -S words fortune-mod
   $ cd ~/aur/schema/
   $ python gendummydata.py dummy-data.sql
   $ bzip2 dummy-data.sql
   $ bzcat dummy-data.sql.bz2 | mysql -uaur -p AUR
   (give password 'aur' at the prompt)

   If your test data consists of real people and real email addresses consider
   inserting bogus addressess to avoid sending unwanted spam from testing. You
   can insert garbage addresses with:
   mysql> UPDATE Users SET Email = RAND() * RAND();

7) Copy the config.inc.php.proto file to config.inc.php. Modify as needed.
   $ cd ~/aur/web/lib/
   $ cp config.inc.php.proto config.inc.php

   In case you set $USE_VIRTUAL_URLS to true (default nowadays) you should add
   a rewrite rule. For Apache, add this ~/aur/web/html/.htaccess:

   RewriteEngine on
   RewriteCond %{REQUEST_URI} !^/index.php
   RewriteRule ^(.*)$ /index.php/$1

8) Point your browser to http://aur