initCommon(); $template->displayHeader(); ?>

7.2. Setting Up a Web Sandbox

To test document publishing, first set up a web sandbox on a local Fedora system.

  1. Install the "Web Server" package group:

    su -c 'yum groupinstall "Web Server"'
  2. Create a folder for the web server to access the site files.

    su -c 'mkdir /var/www/fedora'
  3. Change the permissions on this directory to make it easier to access for your normal user account.

    su -c 'chown username /var/www/fedora'
  4. Link to the new directory from your home directory.

    ln -s /var/www/fedora ~/fedora
  5. Retrieve the web module from CVS.

    cd ~/fedora
    cvs -d :ext:username@cvs.fedoraproject.org:/cvs/fedora co web
    [Note] Web CVS Access

    You must have access to the cvsweb module through the Fedora Account System to check in changes. If you do not have access, you can use :pserver:anonymous in place of :ext:username above. Visit the Fedora Account System at http://admin.fedoraproject.org/accounts/ for more information.

  6. Edit the /etc/hosts file and add the following line after all other lines:

    127.0.0.1  docs.localhost.localdomain
  7. Create a file /etc/httpd/conf.d/fpo.conf with the following content:

    NameVirtualHost *:80
    <VirtualHost *:80>
        ServerName docs.localhost.localdomain
        DocumentRoot /var/www/fedora/web/html/docs
        Alias /images /var/www/fedora/web/html/images
        Alias /css /var/www/fedora/web/html/css
        Alias /include /var/www/fedora/web/include
        Options Indexes FollowSymLinks
    </Virtualhost>
  8. Create a file /etc/php.d/fpo.ini with the following content:

    include_path = ".:/var/www/fedora/web/include"
  9. Start the web server using the following command:

    su -c '/sbin/service httpd start'

    To have the web server start at every boot, use the following command:

    su -c '/sbin/chkconfig httpd on'

To test the new sandbox site, open a Web browser and point it at the URL http://docs.localhost.localdomain.

displayFooter('$Date: 2008/04/10 02:37:06 $'); ?>