JezK
Edit File: install.html
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <!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=UTF-8" /><title>Chapter 3. Install FreeTDS</title><link rel="stylesheet" type="text/css" href="userguide.css" /><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="home" href="index.html" title="FreeTDS User Guide" /><link rel="up" href="index.html" title="FreeTDS User Guide" /><link rel="prev" href="osissues.html" title="OS-specific Issues" /><link rel="next" href="ChoosingTdsProtocol.html" title="Choosing a TDS protocol version" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Install <span class="productname">FreeTDS</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="osissues.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ChoosingTdsProtocol.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="install"></a>Chapter 3. Install <span class="productname">FreeTDS</span></h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="install.html#LocalEnvironment">The local environment</a></span></dt><dt><span class="sect1"><a href="ChoosingTdsProtocol.html">Choosing a <acronym class="acronym">TDS</acronym> protocol version</a></span></dt><dd><dl><dt><span class="sect2"><a href="ChoosingTdsProtocol.html#idm896">Choosing protocol version since <span class="productname">FreeTDS</span> 1.1</a></span></dt><dt><span class="sect2"><a href="ChoosingTdsProtocol.html#idm902">Choosing protocol version before <span class="productname">FreeTDS</span> 1.1</a></span></dt><dt><span class="sect2"><a href="ChoosingTdsProtocol.html#idm970">Regarding obsolete versions</a></span></dt></dl></dd><dt><span class="sect1"><a href="name.lookup.html"><em class="replaceable"><code>servername</code></em> Lookup</a></span></dt><dt><span class="sect1"><a href="freetdsconf.html">The <code class="filename">freetds.conf</code> file</a></span></dt><dd><dl><dt><span class="sect2"><a href="freetdsconf.html#freetdsconfpurpose">What it does</a></span></dt><dt><span class="sect2"><a href="freetdsconf.html#freetdsconflocation">Where it goes</a></span></dt><dt><span class="sect2"><a href="freetdsconf.html#freetdsconfformat">What it looks like</a></span></dt></dl></dd><dt><span class="sect1"><a href="locales.html">The <code class="filename">locales.conf</code> file</a></span></dt><dd><dl><dt><span class="sect2"><a href="locales.html#localespurpose">What it does</a></span></dt><dt><span class="sect2"><a href="locales.html#localeslocation">Where it goes</a></span></dt><dt><span class="sect2"><a href="locales.html#localesformat">What it looks like</a></span></dt></dl></dd><dt><span class="sect1"><a href="envvar.html">Environment variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="envvar.html#Whatfor">What they're for</a></span></dt><dt><span class="sect2"><a href="envvar.html#Setting">Setting environment variables</a></span></dt><dt><span class="sect2"><a href="envvar.html#Checking">Checking your work</a></span></dt></dl></dd><dt><span class="sect1"><a href="PortOverride.html">Port/instance override syntax</a></span></dt><dt><span class="sect1"><a href="ConfirmInstall.html">Confirm the installation</a></span></dt><dd><dl><dt><span class="sect2"><a href="ConfirmInstall.html#tsql"><span class="application">tsql</span></a></span></dt><dt><span class="sect2"><a href="ConfirmInstall.html#Tests"><span class="application">Unit Tests</span></a></span></dt></dl></dd></dl></div><div class="epigraph"><p>If you install it they will stay?</p></div><p></p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note: Confusing terminology"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../images/note.gif" /></td><th align="left">Confusing terminology</th></tr><tr><td align="left" valign="top"><p><span class="quote">“<span class="quote">Configuring</span>”</span> and <span class="quote">“<span class="quote">installing</span>”</span> don't have absolute, context-free definitions. In some circles, we install a product and then configure it. In the <acronym class="acronym">GNU</acronym> world, we <span class="command"><strong>configure</strong></span> the package (generate the <code class="filename">Makefile</code>s), then we <span class="command"><strong>make install</strong></span> the package. In the case of a library package such as <span class="productname">FreeTDS</span> To <span class="emphasis"><em>install the package</em></span> is to copy the files the application developer will use to their canonical locations: header files to <code class="filename">include</code>, libraries to the <code class="filename">lib</code>, documentation and man pages <code class="filename">share</code>. Install targets were specified during the <span class="phrase">build process</span> as arguments to <span class="command"><strong>configure</strong></span>, covered in the last chapter.</p><p>For lack of a better term, this chapter describes installing the <span class="emphasis"><em>product</em></span>. Put more specifically, once we're done with the package manager, we still have to tell <span class="productname">FreeTDS</span> about your database servers, and we still have to tell your client programs about <span class="productname">FreeTDS</span>.</p></td></tr></table></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="LocalEnvironment"></a>The local environment</h2></div></div></div><p>After <span class="productname">FreeTDS</span> has been built and installed, it still doesn't know where your servers are or what particular version of Sybase or Microsoft software each one is using.</p><p>The purpose of this section is to explain how to describe your servernames to <span class="productname">FreeTDS</span>. <span class="productname">FreeTDS</span> looks up your server's attributes in <code class="filename">freetds.conf</code>. Some of the attributes can be overridden by environment variables.</p><p>One of the more important (and arcane) settings is the <acronym class="acronym">TDS</acronym> protocol version, described next.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="osissues.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ChoosingTdsProtocol.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">OS-specific Issues </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Choosing a <acronym class="acronym">TDS</acronym> protocol version</td></tr></table></div></body></html>