
DBD::FB  --  a Frontbase interface for Perl 5.

DESCRIPTION:
------------

This is version 1.38 of DBD-FB. 

DBD-FB is a FrontBase interface for Perl5 using DBI.
It is based on the DBD-Pg PostgreSQL driver by Edmund Mergl.

O'Reilly hosts a great introduction to DBI at:
	http://www.perl.com/pub/a/1999/10/DBI.html

Perl.org hosts a DBI-users mailing list at:
	http://lists.perl.org/showlist.cgi?name=dbi-users
	
For information about FrontBase, visit:

	http://www.frontbase.com/

COPYRIGHT:
----------

	Copyright (c) 2000-2007 FrontBase, Inc
	Copyright (c) 1999 Anjo Krank (FB/PG-Wrappers)
	Portions Copyright (c) 1997,1998,1999 Edmund Mergl (the rest)
	Portions Copyright (c) 1994,1995,1996,1997 Tim Bunce

You may distribute under the terms of either the GNU General Public
License or the Artistic License, as specified in the Perl README file.

HOW TO GET THE LATEST VERSION:
------------------------------

Use the following URL to look for new versions of this module: 

Please check the Downloads section of the FrontBase website at 
http://www.frontbase.com/.

IF YOU HAVE PROBLEMS, COMMENTS OR BUGS:
---------------------------------------

Please send any problems, comments or bug reports to 
<support@frontbase.com>

Please include what OS you are using, and the version of Perl, 
DBI, and DBD::FB you are using. Also provide the version of 
FrontBase DBD::FB was compiled against, and which version you 
are connecting to. 

REQUIREMENTS:
-------------

  - build, test and install Perl 5	(at least 5.005)
  - build, test and install DBI     	(at least 1.10)
  - install FrontBase			(at least 3.6.x)
	
PLATFORMS:
----------

This release of DBD-FB has been developed using Mac OS X with 
dynamic loading for the perl extensions. It has also been built and tested on 
SUSE/RedHat Linux and Win32 with Frontbase installed.

INSTALLATION:
-------------

Visit http://www.perl.com/download.csp for the latest Perl distributions and 
instructions for installing and using Perl.

Visit http://dbi.perl.org/ to download the latest DBI distribution and for 
installation and usage docs.

Please visit the FrontBase website, www.frontbase.com, to obtain a free 
FrontBase server for the required platform.

Installing DBI:FB
-----------------

By default Makefile.PL will search the standard FrontBase installation locations 
for your FrontBase tree. If the installation location has been customized then 
you can define the environment variable FRONTBASE_HOME to point to the root of the 
installation path.

The built in tests will use the DBI_DSN, DBI_USER and DBI_PASS environment variables 
to determine the connection details. 

These can be overridden by the following environment variables. 

FB_HOST
FB_DBNAME 		 
FB_DBPASSWD
FB_USER	
FB_PASSWD

If no DBI_xxx or FB_xxx environment variables are specified then the following 
defaults are used.

hostname 	=> 'localhost'
dbname 		=> 'test'		 
dbpasswd 	=> ''
user 		=> '_SYSTEM'
passwd 		=> ''

To use the defaults you must have a database called 'test' running on the local machine.

You must have Perl and the DBI installed BEFORE you can proceed. Once these are 
installed then follow these steps from the root of the DBD-FB directory.

1. perl Makefile.PL

Mac OS X/Linux
--------------

2.   make
3.   make test
4.   (as root) make install

Win32
-----

2.   nmake
3.   nmake test
4.   nmake install

Tests
-----

If making the tests does not work properly, be sure you have set the FB_xxx environment 
variables correctly (see Installing DBI:FB). If you still have no success, please email 
FrontBase at support@frontbase.com explaining your problem.