Projects/kde.org/Staging Setup: Difference between revisions

    From KDE TechBase
    Line 9: Line 9:


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



    Revision as of 17:04, 20 July 2010

    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). PHP5 is recommended.

    Getting the needed module from SVN

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

    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.

     # listen on this port, too (mostly in file "listen.conf")
     Listen 8080
     
     # staging vhost in a conf file
     <VirtualHost 127.0.0.1:8080>
         # set documentroot + 404 handler
         DocumentRoot <path_to_www>
         ErrorDocument 404 /media/404.php
    
         # depending on the default you might need to allow
         # access to the dir, so disable the following:
         #<Directory "<path_to_www>">
         #    Order allow,deny
         #    Allow from all
         #</Directory>
    
         # you might want to catch the logs in separate files:
         #ErrorLog /var/log/apache2/kde.org-error_log
         #CustomLog /var/log/apache2/kde.org-access_log combined
    
         # php part
         php_value short_open_tag Off
         php_value register_globals No
         php_value allow_url_fopen Off
         php_value disable_functions system,exec,passthru,proc_open,shell_exec,popen,symlink
     
         php_value safe_mode On
         php_value include_path ".:<path_to_www>/media/includes"
         
         # enable .php, add .html here, for developer.kde.org
         AddType application/x-httpd-php .php
     </VirtualHost>
    

    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.

    www.kde.org is now available under:

     http://127.0.0.1:8080/sites/www
    

    pim.kde.org is now available under:

     http://127.0.0.1:8080/areas/pim