JAWmail :: Documentation :: Manual configuration

Configuration files

All of the configuration files for an application or a plugin are in the subdirectory conf/. You must copy files like config.php.dist into config.php and modify them as needed.

Common configuration files

There are some configuration files that exist for every application:

prefs.php. All the defaults of preferences are stored in here.
prefs_ui.php. The preferences user interface is built from this file. If you would like to lock (disallow a user to change it) a preference, then change the last parameter to $p->add_pref() to true - the preference is locked.

The most common backend driver for preferences, access control lists, sessions and authentication is probably the SQL driver. If you are going to use it for any of the avaiable purposes, read this documentation.

Creating SQL tables

You'll have to import SQL dumps for your SQL server. They can be found in the sql subdirectory.

MySQL

At first, you'll have to create a new database for JAW:

[root@blisk sql]# mysqladmin -u root -p -h localhost create jaw

Then, import the SQL dump:

[root@blisk sql]# mysql jaw -u root -p -h localhost < mysql.dump

Configuration parameters

JAW uses the PEAR::DB unified library for access to SQL servers. To connect to a database through PEAR::DB, you have to create a valid DSN - data source name. You can pass the DSN as an array:

$dsn = array('phptype' => 'mysql',
	             'hostspec' => 'localhost',
	             'database' => 'jaw',
	             'username' => 'root',
	             'password' => 'l33t'
	            );

or as a string:

$dsn = 'phptype://username:password@hostspec/database';

Check the documentation of PEAR::DB for more details.

Testing your setup

Load the test.php page in your browser. It is located in the root of your install. Check if there are any errors - if there are, re-read the documentation and fix them!

If everything works okay, then log into JAW. If you have an ACL backend that is capable of administration, then you should also see the Administration application. If you don't, then either you weren't the first one to login, or something is not quite okay.