ZeosLib - open source tools for your database solutions

# ZeosDBO Installation Guide

### ZeosLib Development Group

28 May 2008 (Updated 29/5/2008)

You can download the current (SVN) version from svn://www.firmos.at/zeos/trunk/

The development/testing branch is at svn://www.firmos.at/zeos/branches/testing/

Snapshots can be found at http://zeosdownloads.firmos.at/downloads/snapshots/

Official reaseses are published at the Zeoslib forum and the Zeoslib Sourceforge Project pages

1. Unpack the archive to a folder (not for SVN versions, of course)

2. Copy the required dlls for your database client to the windows system directory (usually `Windows\System` or `winnt\system32`) or use the database client installer.

   Attention : think about licence issues when working with the database client libraries. Not all software is freely distributable in all situations. These libraries are NOT a part of the zeoslib packages.

3. Add the `build` Directory of the package you are about to install to Delphi's library path.

4. Locate the package directory associated with your compiler and open the `ZeosDbo.bpg` project group. Load the project and compile the following components in the order listed (or just choose `compile all` from `Project`-Menu):

   - `ZCore.bpl`
   - `ZParseSql.bpl`
   - `ZPlain.bpl`
   - `ZDbc.bpl`
   - `ZComponent.bpl`

5. If all the packages, listed above are successfully compiled you have to install the `ZComponentDesign.bpl`. After that all ZEOS components are available in the IDE.

   If the `ZComponentDesign.bpl` package isn't available for your compiler (eg. for fpc/lazarus), you should just install the `ZComponent.bpl`

6. Create your own project and start adding the compoents through the IDE and set connection properties. For a quick tutorial, use the example provided with the project or browse the resources on the web page.

Observations:

1. When installing the library under C++ Builder (any version) it is highly recommended to remove any previously installed version of ZEOSDBO.

   To do that you should first close C++ Builder (as some of these files may be locked) and remove the (ZCore|ZParseSql|ZPlain|Zdbc|ZComponent)(.bpl|.tds|.bpi|.lib) files from `$(BCB)\Projects\Lib` and `$(BCB)\Projects\Bpl` (where $(BCB) is something like `C:\Program Files\Borland\CBuilder[4-6]`).

2. When compiling the library from `ZeosDbo.bpg` under C++ Builder you may receive some warnings like 'Unable to find package import `XXX.bpi`' and you may have to press Cancel multiple times to continue.

   We're trying to get rid of this annoying behaviour, but until then here are some possible ways to avoid it, if needed:

   1. Open, compile and install the packages (*.bpk) in the appropriate order (see Installation step #3) - i.e without using `ZeosDbo.bpg`.

   2. Open a command line in \packages\CBuilder[4-6] and do a manual make - like this: make -f ZeosDbo.bpg. This requires the `PATH` and `LIB` environment variables to be set properly, like this:

          SET BCB=d:\borland\cbuilder6

          SET PATH=%BCB%\bin

          SET LIB=%BCB%\lib

      Then open `ZeosDbo.bpg` in the IDE and install the packages the usual way.

3. While installing ZEOSDBO under C++ Builder version 4 from the IDE, you may get this error when compiling the ZDbc package :

       [Pascal Fatal Error] ZDbcMetadata.pas(3076): Internal error: SY876.

   Currently, there is no known solution to this problem. Therefore,it is recommended to compile Zeoslib from the command line (issuing a make -f ZeosDBO.bpg from the directory `/packages/cbuilder4` should accomplish this) and then to install the packages through menu Component->Install Packages.

(c) 1999 - 2006 The Zeos Development Group