<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>INSTALL - How to install and configure DBD::cubrid</title>
    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
</head>

<body style="background-color: white">

<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
    <li><a href="#name">NAME</a></li>
    <li><a href="#synopsis">SYNOPSIS</a></li>
    <li><a href="#description">DESCRIPTION</a></li>
    <li><a href="#prerequisites">PREREQUISITES</a></li>
    <li><a href="#source_installation">SOURCE INSTALLATION</a></li>
    <ul>
        <li><a href="#cpan_installation">CPAN installation</a></li>
        <li><a href="#manual_installation">Manual installation</a></li>
    </ul>
    <li><a href="#support">SUPPORT</a></li>
</ul>
<!-- INDEX END -->

<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>INSTALL - How to install and configure DBD::cubrid</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
  perl Makefile.PL [options]
  make
  make install
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This document describes the installation and configuration of DBD::cubrid, 
the Perl DBI driver for the CUBRID database. Before reading on, make sure that
you have the prerequisites available: Perl, CUBRID and DBI. For details see 
the separate section. <a href="#prerequisites">PREREQUISITES</a>.</p>
<p>Depending on your version of Perl, it might be possible to use a binary 
distribution of DBD::CUBRID. If possible, this is recommended. Otherwise you 
need to install from the sources. If so, you will definitely need a C compiler.
Installation from sources is described in separate section.
<a href="#source_installation">SOURCE INSTALLATION</a>.</p>
<p>
</p>
<hr />
<h1><a name="prerequisites">PREREQUISITES</a></h1>
<dl>
<dt><strong><a name="item_perl">Perl</a></strong>

<dd>
<p>Preferrably a version of Perl, that comes preconfigured with your system.
For example, all Linux and FreeBSD distributions come with Perl. For Windows,
ActivePerl is recommended, see 
<a href="http://www.activestate.com">http://www.activestate.com</a>
for details.</p>
</dd>
</li>
<dt><strong><a name="item_cubrid">CUBRID</a></strong>

<dd>
<p>You need not install the actual CUBRID database management system.
You can download <a href="http://www.cubrid.org/downloads">CUBRID</a>
here. If you want to install from source code an build it, see
<a href="http://www.cubrid.org/download_source_and_build">How to Download
CUBRID Source Code and Build it</a> for details.</p>
</dd>
</li>
<dt><strong><a name="item_dbi">DBI</a></strong>

<dd>
<p>DBD::cubrid is a DBI driver, hence you need DBI. It is available from the
same source where you got the DBD::mysql distribution from.</p>
</dd>
</li>
<dt><strong><a name="item_c_compiler">C compiler</a></strong>

<dd>
<p>A C compiler is only required, if you install from source. In most cases
there are binary distributions of DBD::cubrid available. However, if you need
a C compiler, make sure, that it is the same C compiler that was used for 
compiling Perl and CUBRID. Otherwise you will almost definitely encounter 
problems because of differences in the underlying C runtime libraries.</p>
</dd>
<dd>
<p>In the worst case, this might mean to compile Perl and CUBRID yourself.
But believe me, experience shows that a lot of problems are fixed this way</p>
</dd>
</li>
</dl>
<p>
</p>
<hr />
<h1><a name="source_installation">SOURCE INSTALLATION</a></h1>
<p>So you need to install from sources. If you are lucky, the Perl module
CPAN will do all for you. Otherwise you will need to do a manual installation.
Some of you, in particular system administrators of multiple sites, will
choose automatic installation. All of these installation types have an own
section. <a href="#cpan_installation">CPAN installation</a>.
<a href="#manual_installation">Manual installation</a>.</p>
<p>
</p>
<h2><a name="cpan_installation">CPAN installation</a></h2>
<p>Installation of DBD::cubrid can be incredibly easy:</p>
<pre>
  cpan
  install DBD::cubrid</pre>
<p>If you are using the CPAN module for the first time, just answer the
questions by accepting the defaults which are fine in most cases. If you
are using an older version of Perl, you might instead need a</p>
<pre>
  perl -MCPAN -e shell
  install DBD::cubrid</pre>
<p>If you cannot get the CPAN module working, you might try manual 
installation.</p>
<p>
</p>
<h2><a name="manual_installation">Manual installation</a></h2>
<p>For a manual installation you need to fetch the DBD::cubrid source
distribution. The latest version is always available from</p>
<pre>
  <a href="https://sourceforge.net/projects/cubridinterface/files/Perl/">
https://sourceforge.net/projects/cubridinterface/files/Perl/</a></pre>
<p>The name is typically something like</p>
<pre>
  DBD-cubrid-X.X.X.tar.gz</pre>
<p>The archive needs to be extracted. On Windows you may use a tool
like WinZip, on Unix you type</p>
<pre>
  tar zxvf DBD-cubrid-X.X.X.tar.gz</pre>
<p>This will create a subdirectory DBD-cubrid-X.X.X. Enter this subdirectory
and type</p>
<pre>
  perl Makefile.PL
  make
  make test</pre>
<p>(On Windows you may need to replace ``make'' with ``nmake'' or ``dmake''.)
If the tests seem to look fine, you may continue with</p>
<pre>
  make install</pre>
<p>
</p>
<hr />
<h1><a name="support">SUPPORT</a></h1>
<p>Finally, if everything else fails, you are not alone. First of all, for an
immediate answer, you should look into the archives of the mailing list
<strong><a href="mailto:zhanghui@nhn.com">zhanghui@nhn.com</a></strong>.
for archive locations.</p>
<p>If you don't find an appropriate posting and reply in the mailing list, 
please post a question. Typically a reply will be seen within one or two days.
</p>

</body>

</html>