summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorcanyonknight <canyonknight@gmail.com>2012-05-23 13:16:17 -0400
committerLukas Fleischer <archlinux@cryptocrack.de>2012-07-06 11:25:32 +0200
commitf014d7f76390a79b09aebe7cd4bfe508fdbe1a6d (patch)
treebee1663b23e062464f45095e6c71444c4d5099ec
parent9e9820ff5877f6b0a9c3c2be5127517b9f05a327 (diff)
downloadaurweb-f014d7f76390a79b09aebe7cd4bfe508fdbe1a6d.tar.xz
Rearrange install documentation
Move documentation related to installation to a separate INSTALL file. Signed-off-by: canyonknight <canyonknight@gmail.com> Signed-off-by: Lukas Fleischer <archlinux@cryptocrack.de>
-rw-r--r--INSTALL102
-rw-r--r--web/README104
2 files changed, 102 insertions, 104 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000..ee4ed5a
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,102 @@
+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 these lines:
+ extension=mysql.so
+ extension=json.so
+
+ If those php extensions are separate packages on your system, install
+ them.
+
+ AUR requires PEAR and the Archive_Tar module.
+ Installing PEAR will vary depending on the system and may already
+ be included with PHP. You can also find it in the PHP source
+ distribution.
+
+ PHP sources: http://www.php.net/downloads.php
+ Archive_Tar PEAR module: http://pear.php.net/package/Archive_Tar
+
+ - Install the Archive_Tar PEAR package:
+ # pear install Archive_Tar
+
+6) Configure MySQL
+ - Start the MySQL service. Example:
+ # /etc/rc.d/mysqld start
+
+ - 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/support/schema/aur-schema.sql
+ (give password 'aur' at the prompt)
+
+ - Optionally load some test data for development purposes.
+ # pacman -S words mysql-python
+ # cd ~/aur/support/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
+
+8) Point your browser to http://aur
diff --git a/web/README b/web/README
index 266f39e..f65abb1 100644
--- a/web/README
+++ b/web/README
@@ -1,107 +1,3 @@
-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 these lines:
- extension=mysql.so
- extension=json.so
-
- If those php extensions are separate packages on your system, install
- them.
-
- AUR requires PEAR and the Archive_Tar module.
- Installing PEAR will vary depending on the system and may already
- be included with PHP. You can also find it in the PHP source
- distribution.
-
- PHP sources: http://www.php.net/downloads.php
- Archive_Tar PEAR module: http://pear.php.net/package/Archive_Tar
-
- - Install the Archive_Tar PEAR package:
- # pear install Archive_Tar
-
-6) Configure MySQL
- - Start the MySQL service. Example:
- # /etc/rc.d/mysqld start
-
- - 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/support/schema/aur-schema.sql
- (give password 'aur' at the prompt)
-
- - Optionally load some test data for development purposes.
- # pacman -S words mysql-python
- # cd ~/aur/support/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
-
-8) Point your browser to http://aur
-
-
Web Interface:
==============