README for pmwiki 2.1.x

REQUIREMENTS

Don't install pmwiki 2 over an existing pmwiki 1 installation !
A nice page how to upgrade can be found here: 
http://www.pmwiki.org/wiki/PmWiki/UpgradingFromPmWiki1


PRE-INSTALL

POST-INSTALL

1. Add the following directives to httpd.conf:
   
   LoadModule php5_module lib/apache/libphp5.so
   AddType application/x-httpd-php .php

   Alias /wiki/uploads /var/www/pmwiki/uploads/
   Alias /wiki/pub /var/www/pmwiki/pub/
   Alias /wiki /var/www/pmwiki/pmwiki.php

   <Directory /var/www/pmwiki/>
      Options None
      AllowOverride None
      Order deny,allow
      Deny from all
      <Files pmwiki.php>
         Allow from all
      </Files>
   </Directory>
   <DirectoryMatch /var/www/pmwiki/(uploads|pub)/>
      Allow from all
   </DirectoryMatch>

   The first alias can be omitted if file uploads
   are not enabled.

2. Create a local configuration file
   
   cp /var/www/local/{config.php.sample,config.php}

3. Edit /var/www/pmwiki/local/config.php:

   $ScriptUrl = 'http://<your_host_name>/wiki';
   $PubDirUrl = 'http://<your_host_name>/wiki/pub';

   and, if you want file uploads:

   $UploadDir = '/var/www/pmwiki/uploads';
   $UploadUrlFmt = 'http://<your_host_name>/wiki/uploads';

4. Point your browser to http://<your_host_name>/wiki
   and enjoy ;-)


PRECAUTION