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 166 167 168 169 170 171 172 173 174 175 176 177 178
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Installing</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GNOME Data Access manual">
<link rel="up" href="installation.html" title="Installation">
<link rel="prev" href="installation.html" title="Installation">
<link rel="next" href="compiling.html" title="Compiling with the library">
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="introduction.html" title="Introduction">
<link rel="chapter" href="architecture.html" title="libgda architecture">
<link rel="chapter" href="installation.html" title="Installation">
<link rel="chapter" href="connecting.html" title="Beginning">
<link rel="chapter" href="processing-queries.html" title="Processing queries">
<link rel="chapter" href="ch06.html" title="Transactions and batch processes">
<link rel="chapter" href="managing-errors.html" title="Managing errors">
<link rel="chapter" href="main_example.html" title="Full example">
<link rel="chapter" href="migration.html" title="Some formulae for migration from old version">
<link rel="chapter" href="libgda-api.html" title="Client API Reference">
<link rel="chapter" href="libgda-providers.html" title="GDA Providers">
<link rel="chapter" href="libgda-xql.html" title="XML Queries">
<link rel="chapter" href="libgda-reports.html" title="GDA Report Engine">
<link rel="appendix" href="fdl.html" title="Appendix A. GNU Free Documentation License">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="installation.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="installation.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME Data Access manual</th>
<td><a accesskey="n" href="compiling.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="installation-installing"></a>Installing</h2></div></div></div>
<p>
Installation depends on which format you choose to download. If
you've got a package such as <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=RPM"><span class="acronym">RPM</span></a> or <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=DEB"><span class="acronym">DEB</span></a>, check
your package manager documentation for how to install new packages.
</p>
<p>
If you downloaded the source code (in a tarball), you must
compile the software. To do so, once you have unpacked
the source tree, you must:
</p>
<pre class="programlisting">
<code class="prompt">$</code> <strong class="userinput"><code>./configure</code></strong>
<code class="prompt">$</code> <strong class="userinput"><code>make</code></strong>
<code class="prompt">$</code> <strong class="userinput"><code>make install</code></strong>
</pre>
<p>
</p>
<p>
This will generate the makefiles for your specific platform,
compile all the source tree, and install the binaries and
documentation in your system.
</p>
<p>
If you don't find a file named <code class="filename">configure</code>, there
should be one called <code class="filename">autogen.sh</code>. In this case,
run <code class="filename">autogen.sh</code>, which will create and run the
generated <code class="filename">configure</code> file.
</p>
<p>
You can specify several arguments to <code class="filename">configure</code> (or
<code class="filename">autogen.sh</code>). The most significant are (you can
check all the available arguments by running
<span class="command"><strong>configure --help</strong></span>):
</p>
<div class="itemizedlist"><ul type="bullet">
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--prefix=<directory></code></strong>: Prefix where
package will be installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-mysql=<directory></code></strong>: Specify
directory where <span class="application">MySQL</span> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-postgres=<directory></code></strong>:
Specify directory where <span class="application">PostgreSQL</span> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-sybase=<directory></code></strong>: Specify
directory where <span class="application">Sybase</span> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-ldap=<directory></code></strong>: Specify
directory where <a href="http://foldoc.doc.ic.ac.uk/foldoc/foldoc.cgi?query=LDAP"><span class="acronym">LDAP</span></a> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-oracle=<directory></code></strong>: Specify
directory where <span class="application">Oracle</span> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-interbase=<directory></code></strong>: Specify
directory where <span class="application">Interbase</span> libraries are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-mdb=<directory></code></strong>: Specify
directory where the MDB libraries (for accessing <span class="application">MS Access</span> files)
are installed
</p></li>
<li style="list-style-type: disc"><p>
<strong class="userinput"><code>--with-sqlite=<directory></code></strong>: Specify
directory where the SQLite libraries are installed
</p></li>
</ul></div>
<p>
Libraries needed by providers are searched by default, so, if found, providers are
compiled by default. Those libraries are searched in hard-coded directories, so
if the installation of these libraries is in an uncommon place, the above arguments
should be used to specify the directories where the libraries and header files
are installed.
</p>
<p>
If you find any problem during the configuration, compilation or
installation process, do not hesitate in contacting the
<span class="application">GNOME-DB</span> mailing list (<code class="email"><<a class="email" href="mailto:gnome-db-list@gnome.org">gnome-db-list@gnome.org</a>></code>, first
send an email to <code class="email"><<a class="email" href="mailto:gnome-db-list-request@gnome.org">gnome-db-list-request@gnome.org</a>></code> with
the subject SUBSCRIBE, if you are not already subscribed).
</p>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="installation-debian"></a>Debian installation</h3></div></div></div>
<p>
If you are using <a class="ulink" href="http://www.debian.org" target="_top">Debian</a> you
will need to install a few packages in the following way:
</p>
<pre class="programlisting">
<code class="systemitem">$</code> <strong class="userinput"><code> apt-get install <em class="replaceable"><code>package-names</code></em></code></strong>
</pre>
<p>
These are the packages you will need for this:
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>libgda2-1</p></li>
<li><p>libgda2-common</p></li>
<li><p>libgda2-dev</p></li>
<li><p>libgda2-doc</p></li>
<li><p>libgda2-dbg</p></li>
<li><p>libgda2-ruby (Ruby bindings)</p></li>
</ul></div>
<p>
Alternatively, you can install the different providers that allow access to the
different supported data sources. The packages you can choose from are:
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>gda2-postgres for PostgreSQL databases</p></li>
<li><p>gda2-mysql for MySQL databases</p></li>
<li><p>gda2-odbc for ODBC data sources</p></li>
<li><p>gda2-freetds for Sybase and MS SQL Server databases</p></li>
<li><p>gda2-sqlite for SQLite databases</p></li>
</ul></div>
<p>
You can obtain information about any packages with:
</p>
<pre class="programlisting">
<code class="systemitem">$</code> <strong class="userinput"><code> apt-cache show <em class="replaceable"><code>package-names</code></em></code></strong>
</pre>
<p>
If you cannot find this packages, you must include in
<code class="filename">/etc/apt/sources.list</code>
a line like this:
</p>
<pre class="programlisting">
deb http://gluck.debian.org/~kov/debian woody gnome2
</pre>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.10</div>
</body>
</html>
|