This document is available in several formats.

You may be reading this document right now at http://admc.com/blaine/howtos/hsqldb-ber, or in a distribution somewhere else. I hereby call the document distribution from which you are reading this, your current distro.

http://admc.com/blaine/howtos/hsqldb-ber hosts the latest versions of all available formats. If you want a different format of the same version of the document you are reading now, then you should try your current distro. If you want the latest version, you should try http://admc.com/blaine/howtos/hsqldb-ber.

Sometimes, distributions other than http://admc.com/blaine/howtos/hsqldb-ber do not host all available formats. So, if you can't access the format that you want in your current distro, you have no choice but to use the newest version at http://admc.com/blaine/howtos/hsqldb-ber.

This document is available in several formats.

You may be reading this document right now at http://admc.com/blaine/howtos/hsqldb-ber, or in a distribution somewhere else. I hereby call the document distribution from which you are reading this, your current distro.

http://admc.com/blaine/howtos/hsqldb-ber hosts the latest versions of all available formats. If you want a different format of the same version of the document you are reading now, then you should try your current distro. If you want the latest version, you should try http://admc.com/blaine/howtos/hsqldb-ber.

Sometimes, distributions other than http://admc.com/blaine/howtos/hsqldb-ber do not host all available formats. So, if you can't access the format that you want in your current distro, you have no choice but to use the newest version at http://admc.com/blaine/howtos/hsqldb-ber.

HSQLDB can be used with Perl via the DBI and DBD::JDBC modules, without this hsqldb-ber product. You don't need hsqldb-ber to access a fantastic database by coding perl to the DBI API. The purpose of hsqldb-ber is to add the following important features.

The HSQLDB "BerServer" that this product runs is administered exactly the same way as a traditional HSQLDB "Server", and the same HSQLDB JVM can serve the normal "hsql" protocol, the "ber" protocol for Perl clients, "hsqls", "http", "https", etc., all at the same time. This package comes with utilities which make it easy to run any of these combinations and to embed your own Java applications if you wish.

The auto-of-the-box configuration runs one Java JVM that serves both "hsql" JDBC requests, and "ber" perl requests. Client perl code just uses DBI with a connect string containing "ber:hsqldb:*". Java client code just uses JDBC with a JDBC URLs containing "jdbc:hsqldb:hsql:*".

This project may be distributed according to the terms of the GNU GPL or the Perl Artistic License, with some portions also being covered by the HSQLDB license. The text of both licenses reside in distributed with hsqldb-ber in the same directory as this file.

This project needs little documentation, since the primary installation and maintenance tasks are those for installing and maintaining the HSQLDB Server and the DBD::JDBC Perl Module, both of which have their own documentation. Most of the text in the document you are reading can be found in the README.txt in the doc subdirectory of the hsqldb-ber distribution.