Code Installation

These installation instructions are for use with the overweight distribution. This distribution includes all the libraries required to run PBooks in a single folder. I'm also thinking of including a sqlite database for even faster time to operation.

sudo mkdir /usr/share/pbooks
cd /usr/share/pbooks
sudo svn co http://www.pbooks.org/svn/pbooks/misc_projects/pbooks_portable/trunk/ .
sudo chmod 0777 /usr/share/pbooks/cache
sudo svn co http://www.nexista.org/svn/nexista/trunk/ ./nexista
cd apps
sudo svn co http://www.pbooks.org/svn/pbooks/misc_projects/pbooks/trunk/ ./pbooks
sudo svn co http://www.nexista.org/svn/nexista/apps/auth/ ./auth
cd /opt/lampp/htdocs
sudo ln -s /usr/share/pbooks/web/ pbooks

At this point, if you were to load http //localhost/pbooks/, you would get this message because there are a few steps left:

Uh-oh, we already ran into a problem. I can't find a config file! I'm looking for /usr/share/pbooks/config/config.xml

Database Installation

cd /usr/share/pbooks
cp config/my_db_admin_settings.php.dist config/my_db_admin_settings.php
vim config/my_db_admin_settings.php
/opt/lampp/bin/php install_db.php
sudo cp config/config.xml.dist config/config.xml
vim config/config.xml
sudo cp apps/pbooks/config/config.xml.dist apps/pbooks/config/config.xml
vim apps/pbooks/config/config.xml
sudo /opt/lampp/bin/pear install MDB2
sudo /opt/lampp/bin/pear install MDB2#mysqli

I had a tough time getting the pbooks user setup, but eventually figured out. For some reason the % wildcard wasn't working for me. I switched to 'localhost' and that worked.

Fire It Up!

After those steps have been successfully completed, you should be able to load up http //localhost/pbooks/index.php. It will refresh a few times as it builds itself, but then you'll be presented with a login page, of which the default user and password are "demo", "demo".

XAMPP Problems - [RESOLVED]

XAMPP version 1.6.6. cannot run PBooks due to a basic bug in their setup. I don't have the time to diagnose it properly, but I believe it has something to do with PHP, XSL, and threading.

[Tue Feb 26 11:03:01 2008] [notice] child pid 12174 exit signal Segmentation fault (11)

It's too bad because it fails on a very basic XSL transformation.

UPDATE - Looks like the bug was fixed the same day. Many thanks to Oswald and PHP-CODER for getting this taken care of. I'm downloading the beta XAMPP to try again. Yes, I've confirmed that the problem is resolved, and PBooks will now work with XAMPP. I have to say I'm really impressed with their responsiveness.

Installing Pbooks on Windows using XAMPP

These are the steps I followed in order to install Pbooks on windows using XAMPP.

  1. After installing XAMPP I clicked on my computer and then went to the C: drive. You should then see a folder titled XAMPP

  2. I then created a new folder called Pbooks inside of the XAMPP sub folder called htdocs. I used the turtle svn checkout to download the pbooks content to the pbooks folder. The URL is http://www.pbooks.org/svn/pbooks/misc_p … le/trunk/.

  3. Next I created a nexista folder inside of the pbooks folder I just created. I used the turtle SVN checkout. The URL is http://www.nexista.org/svn/nexista/trunk/

  4. The last step is to create two new folders in the apps sub folder of the pbooks folder you created in step 1. I used the SVN checkout and created a new folder named pbooks and another one named auth. The url for the pbooks folder is http://www.pbooks.org/svn/pbooks/misc_p … ks/trunk/, and the url for the Auth folder is http://www.nexista.org/svn/nexista/apps/auth/

External Links==

  • http://www.apachefriends.org/en/xampp.html