34 lines
5.9 KiB
HTML
34 lines
5.9 KiB
HTML
|
|
<!DOCTYPE html
|
|
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml"><head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<title>ZeosDBO Installation Guide</title><link rel="stylesheet" href="ede.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.66.0"></head><body><div xmlns="" id="customheader"><a href="http://zeos.firmos.at/portal.php" style="color: #fff; font-weight: bold;">ZeosLib</a><b> - open source tools for your database solutions</b></div><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="d4e1"></a>ZeosDBO Installation Guide</h1></div><div><h3 class="corpauthor">ZeosLib Development Group</h3></div><div><p class="pubdate">28 May 2008 (Updated 29/5/2008)</p></div></div><hr></div><p>You can download the current (SVN) version from <a href="svn://www.firmos.at/zeos/trunk/" target="_top">svn://www.firmos.at/zeos/trunk/</a></p><p>The development/testing branch is at <a href="svn://www.firmos.at/zeos/branches/testing/" target="_top">svn://www.firmos.at/zeos/branches/testing/</a></p><p>Snapshots can be found at <a href="http://zeosdownloads.firmos.at/downloads/snapshots/" target="_top">http://zeosdownloads.firmos.at/downloads/snapshots/</a></p><p>Official reaseses are published at the <a href="http://zeos.firmos.at/portal.php" target="_top">Zeoslib forum</a> and the <a href="http://sourceforge.net/projects/zeoslib" target="_top">Zeoslib Sourceforge Project pages</a></p><div class="orderedlist"><ol type="1"><li><p>Unpack the archive to a folder (not for SVN versions, of course)</p></li><li><p>Copy the required dlls for your database client to the windows system directory (usually <tt class="filename">Windows\System</tt> or <tt class="filename">winnt\system32</tt>) or use the database client installer.</p><i><span class="remark">Attention : think about licence issues when working with the database client libraries. Not all software is freely distributable in all situations. These libraries are <span class="emphasis"><em>NOT</em></span> a part of the zeoslib packages.</span></i></li><li><p>Add the <tt class="filename">build</tt> Directory of the package you are about to install to Delphi's library path.</p></li><li><p>Locate the package directory associated with your compiler and open the <tt class="filename">ZeosDbo.bpg</tt> project group. Load the project and compile the following components in the order listed (or just choose <tt class="filename">compile all</tt> from <tt class="filename">Project</tt>-Menu):
|
|
|
|
<div class="itemizedlist"><ul type="disc"><li><tt class="filename">ZCore.bpl</tt></li><li><tt class="filename">ZParseSql.bpl</tt></li><li><tt class="filename">ZPlain.bpl</tt></li><li><tt class="filename">ZDbc.bpl</tt></li><li><tt class="filename">ZComponent.bpl</tt></li></ul></div></p></li><li><p>If all the packages, listed above are successfully compiled you have to install the <tt class="filename">ZComponentDesign.bpl</tt>. After that all ZEOS components are available in the IDE.</p><i><span class="remark">If the <tt class="filename">ZComponentDesign.bpl</tt> package isn't available for your compiler (eg. for fpc/lazarus), you should just install the <tt class="filename">ZComponent.bpl</tt></span></i></li><li><p>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.</p></li></ol></div><div class="orderedlist"><p class="title"><b>Observations:</b></p><ol type="1"><li><p>When installing the library under C++ Builder (any version) it is highly recommended to remove any previously installed version of ZEOSDBO.</p><p>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 <tt class="filename">$(BCB)\Projects\Lib</tt> and <tt class="filename">$(BCB)\Projects\Bpl</tt> (where $(BCB) is something like <tt class="filename">C:\Program Files\Borland\CBuilder[4-6]</tt>).</p></li><li><p>When compiling the library from <tt class="filename">ZeosDbo.bpg</tt> under C++ Builder you may receive some warnings like 'Unable to find package import <tt class="filename">XXX.bpi</tt>' and you may have to press Cancel multiple times to continue.</p><p>We're trying to get rid of this annoying behaviour, but until then here are some possible ways to avoid it, if needed:
|
|
|
|
<div class="orderedlist"><ol type="a"><li>Open, compile and install the packages (*.bpk) in the appropriate order (see Installation step #3) - i.e without using <tt class="filename">ZeosDbo.bpg</tt>.</li><li><p>Open a command line in \packages\CBuilder[4-6] and do a manual make - like this: <span><b class="command">make -f ZeosDbo.bpg</b></span>. This requires the <tt class="literal">PATH</tt> and <tt class="literal">LIB</tt> environment variables to be set properly, like this:
|
|
|
|
|
|
|
|
<pre class="programlisting">SET BCB=d:\borland\cbuilder6
|
|
|
|
SET PATH=%BCB%\bin
|
|
|
|
SET LIB=%BCB%\lib</pre>
|
|
|
|
|
|
|
|
Then open <tt class="filename">ZeosDbo.bpg</tt> in the IDE and install the packages the usual way.</p></li></ol></div></p></li><li><p>While installing ZEOSDBO under C++ Builder version 4 from the IDE, you may get this error when compiling the ZDbc package :
|
|
|
|
|
|
|
|
<pre class="programlisting">[Pascal Fatal Error] ZDbcMetadata.pas(3076): Internal error: SY876.</pre>
|
|
|
|
|
|
|
|
Currently, there is no known solution to this problem. Therefore,it is recommended to compile Zeoslib from the command line (issuing a <span><b class="command">make -f ZeosDBO.bpg</b></span> from the directory <tt class="filename">/packages/cbuilder4</tt> should accomplish this)
|
|
|
|
and then to install the packages through menu Component->Install Packages.</p></li></ol></div></div><div xmlns="" id="customfooter">
|
|
(c) 1999 - 2006 The Zeos Development Group
|
|
</div></body></html> |