INSTALLATION INSTRUCTIONS

Installation is difficult, and this document is badly written, so keep confident ;)

VERSIONS

I personally use this version of PApp with the following other software packages (other perl modules are listed in the requirements section of the Makefile.PL).

• apache-1.3.25
• mod_perl-1.25 (1.24 well-tested)
• perl 5.8.x (5.8.0 is buggy, but might work with small apps).
• mysql-3.23.31 (higher versions usually pose no problem);

REQUIREMENTS

• mysql (version 3.23+ recommended), other databases might work, but probably require small changes (I'd be interested to hear about problems, though!).
• mod_perl -OR- speedycgi mod_perl is the recommended and fastest way. if you can't get mod_perl, try the CGI::SpeedyCGI module. If even that fails, you could still use PApp, but it will not be funny for you (read: dog-slow).
• XML::Sablotron (from http://www.gingerall.com/charlie-bin/get/webGA/act/sablotron.act) This is optional but HIGHLY recommended (also, it is required for many applications and demos)

INSTALLATION STEP-BY-STEP

1. compile and install this module, as usual: perl Makefile.PL make make test make install

2a. mod_perl:

Configure apache, see the included eg/httpd.conf. Due to bugs in apache you must be sure to NOT build with expat-lite. A rm -rf lib/expat-lite on the right place should help. ;-) no component of apache uses expat statically and using it dynamically (i.e. from XML::Parser) causes a segmentation fault. And do not forget to enable PERL_SECTIONS when configuring modperl (perl Makefile.PL PERL_SECTIONS=1)

2b. speedycgi:

Much easier than mod_perl, only slightly slower: just copy eg/admin.cgi (for a single application) or eg/exec.cgi (for a whole appset) to your cgi directory and customize it (i.e. edit the bangpath and the app/appset name).

3. use papp-admin to configure papp for its first use

First create an appset (usually default) ./papp-admin --addset default
then add the first application
./papp-admin --app admin --appset default --path apps/admin.papp \

--mount /admin

P.S: When first entering the Admin menu the User is: admin and

     password is: public 
     !!! PLEASE CHANGE THAT BEFORE YOU DO SOMETHING ELSE !!!