            PROJECT BASED CALENDARING SYSTEM
             19 january 2001 - version 0.4

        Created and copyright by Roalt Zijlstra
       Reachable by email on roalt@kwenie.org

INSTALLATION NOTES

I presume you have the following installed:

o apache 1.3.x extended with PHP4 (I used 1.3.12)
o MySQL 3.22.x ( I used 3.22.32 and later on 3.23.27 )

Next to that I use phpMyAdmin to have easy access to the MySQL database, but
you don't need it to get it working. The 'mysql' command should be a good
friend of your then.

INSTALLER SCRIPT

As of version 0.4 I wrote an Installer script, which resides in the script/
directory. It is called 'PBCS-Installer' and can be run from within the
script/ directory or in the same directory as the pbcs-v0.4.tar.gz file.

The script unpacks the tar-ball for you and asks you where to put. It also
asks you some usernames and passwords to access the MySQL database. Be aware
that this is the PBCS-Installer v0.1 so it might not cover all cases. It
certainly won't cover upgrades from 0.3.1 or lower.

You can skip the MANUAL INSTALL method if it all works for you with this
script.

MANUAL INSTALL - WEB DOCUMENTS

First of all the obvious thing (and you probably already did so, when you are
reading this :-) ). UN-tar the pbcs-v0.4.tar.gz somewhere in your htdocs tree of
Apache.

On Red Hat you have to 'cd' to /home/httpd/html . If you UN-tar it there with

  tar -xzf pbcs-v0.4/tar.gz

a directory pbcs will be created with all php files it that are needed for the
PbCs system.

Then go into the 'pbcs' directory and edit the db.php3 file. In there you can
edit settings about the database which must be accessed. Especially the following
lines must be edited to your own purposes. The database name could stay 'pbcs'
but you certainly want a different user name and password combo.

// The database name to select before doing queries
define("PBCS_DB_DB_NAME","pbcs");
// The user name of the user that has privs to the pbcs database
define("PBCS_DB_USERNAME","pbcs");
// And the corresponding password
define("PBCS_DB_PASSWORD","your-password");

When your done with this you need to prepare MySQL.


MYSQL CONFIGURATION

As MySQL admin create a database with the name you specified in the above
db.php file. You can do that with 'mysqladmin create <database name>'

Then make sure you have a user/password combo that has access to the database.
This can be done in the 'user' table of the 'mysql' database. Be sure the user
can select, insert, update and delete in the PbCs-database.

In the pbcs directory you find a file called 'Create-Table.mysql'. This is a
dump file of the tables which the pbcs needs. Create the tables using:

  mysql -u<user name> -p <database name> < Create-Tables.mysql

You must do this if you have not installed PbCs before. However if you
installed v0.1 or v0.2 before, you should run the mysql diffs to suit your
needs.

If you upgrade from v0.1 then you can run a mysql-diff to v0.2

  mysql -u<user name> -p <database name> < v0.1-v0.2-mysql-diffs.mysql

And then:

  mysql -u<user name> -p <database name> < v0.2-v0.2.1-mysql-diffs.mysql

This will make the mysql stuff up to date. If you upgrade from v0.2 then
you should only do the latter one! There will be MySql diffs between all releases
so in order to get the database up to date you should do them all until the
latest release.

Now you can enter your fresh calendaring system!


FIRST USAGE

You can enter the calendar with a 'admin' user name and a 'admin' password. Be
sure to create a new user for yourself with Status set to 127 and then delete
the admin user.

If you come across errors in these instructions please notify me by email on

   roalt@kwenie.org

and please do add PBCS: in the subject so I can see quickly what the mail is
about.

Roalt Zijlstra

