forked from CUBRID/cubrid-perl
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL.html
165 lines (156 loc) · 5.78 KB
/
INSTALL.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
<?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:[email protected]">[email protected]</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>