Booby - Installation guide

I am very interested in your experiences with Booby.

You can send comments directly to me but preferable you can add them to the PHorum where other can respond to your questions/remarks as well.

Table of contents

Install script.

This installation guide is provided for those who have problems with the provided installation script or simply would like to perform the installation by hand.
If you reached this page in search for information on the installation: there is an installation script (install.php) in the root directory of Booby. Execute this script and booby will install/upgrade.

Prerequisits

Third party packages

ADOdb is embedded in the source of the application and does not need to be downloaded seperately

phpSavant by Paul M. Jones is embedded in the source of the application and does not need to be downloaded seperately This is the default rendering engine for Booby.

overLIB by Erik Bosrup is embedded in the source of the application and does not need to be downloaded seperately

Contact vCard parse by Paul M Jones is embedded in the source of the application and does not need to be downloaded seperately

MagpieRSS by kellan@protest.net is embedded in the source of the application and does not need to be downloaded seperately

Visual editor by ngo_canh@yahoo.com is embedded in the source of the application and does not need to be downloaded seperately

Database installation

Read the database specific documentation. A MySQL setup (post-installation) example is provided

Example: Setup a MySQL environment

a. Startup mysql server/daemon
b. Set an admin password

			mysqladmin booby -u root password 'your-password'
		

Create a database called 'booby'

The database name can be something else.

		$ mysql [-u user] [-p]
		mysql> create database booby;
		mysql> quit
	
or
		$ mysqladmin [-u user] [-p] create booby
	

Create the table structure for the application

This step must be repeated for the framework and each of its plugins!!!!

		$ mysql booby [-u user] [-p] < 'path.to'/create.tables.sql
	

Example

If you are in the root directory of the booby application, you will have to specify the following:

		$ mysql booby [-u user] [-p] < base/sql/create.tables.sql
		$ mysql booby [-u user] [-p] < plugins/bookmarks/sql/create.table.sql
		$ mysql booby [-u user] [-p] < plugins/contacts/sql/create.table.sql
		$ mysql booby [-u user] [-p] < plugins/news/sql/create.table.sql
		$ mysql booby [-u user] [-p] < plugins/notes/sql/create.table.sql
		$ mysql booby [-u user] [-p] < plugins/todos/sql/create.table.sql
	

Setup permissions

		grant all rights to user
		$ mysql -u root -p

		mysql> GRANT ALL PRIVILEGES ON *.* TO 'admin' IDENTIFIED BY 'admin'  WITH GRANT OPTION;
	

Edit the configs/databaseConfiguration.php file for the correct settings.

Your application will not work otherwise :-)

Check the installation

You should now be able to login using username/password 'admin'. Change the password via the preferences. If you encounter problems you can always contacts me at: contact me at: barry@nauta.be, or leave a message in the phorum:

Please mention

Finishing up

The admin section allows the addition of more users.

Delete the install.php script once installation is succesful!!! You might also want to delete the phpinfo.php file...

Do not forget to change the admin password!!!

Have fun :-)

Trouble shooting

If you have followed the steps and there are still problems, here are some more tips that might help or produce additional output which you can send me for evalutaion :-)