Contents

Needed Software

On the machine you use for this setup, you need to have installed a
Linux/*BSD with a working Apache (1 or 2) with mod_php4. You will need at least the PHP4 modules pcre (for Perl compatible regular expressions) and xml (for the UTF-8 encoding). You will need PHP to be built with mysqli support. PHP5 is recommended.

Getting the needed module from SVN

You need to checkout the appropriate www module from our SVN, it's located in /trunk/www, most of the sites using Capacity are in /trunk/www/sites.
The www module will be the documentroot of your apache, therefor keep
care that the apache process can read this dir.

To make use of Capacity you also need to checkout /trunk/www/media, which keeps its sources.

Setup of the Apache vHost for the Staging

You need to setup a vHost for the staging, here an example to have some
vHost for your localhost running on port 8080.

Capacity doesn't work fine in subdirs of your documentroot, so it is recommended to setup a vHost for every kde site you intent to checkout. Alternatively, you may wish to add a symlink if your Capacity's media folder is elsewhere.

Creating the database structure

KDE.org uses MySQL to store database info. You will be required to first create a new database, and create a db_auth.inc file in Capacity's media/includes. Use the db_auth.inc.default as an example.

To populate the database, you should run media/update_community_cronjob.php from Capacity.

Using the Staging

After restarting your Apache, you should have a running staging
area on http://127.0.0.1:8080. You can now simply access and test
all *.kde.org sites within this vhost. They all will behave like
they are on their own domain, in their own vhost.

If you checked out www.kde.org (/trunk/www/sites/www) it is now available under: