<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <HTML ><HEAD ><TITLE >Install FreeTDS</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="FreeTDS User Guide" HREF="index.htm"><LINK REL="PREVIOUS" TITLE="OS-specific Issues" HREF="osissues.htm"><LINK REL="NEXT" TITLE="Choosing a TDS protocol version" HREF="choosingtdsprotocol.htm"><LINK REL="STYLESHEET" TYPE="text/css" HREF="userguide.css"><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8"></HEAD ><BODY CLASS="CHAPTER" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" ><SPAN CLASS="PRODUCTNAME" >FreeTDS</SPAN > User Guide: A Guide to Installing, Configuring, and Running <SPAN CLASS="PRODUCTNAME" >FreeTDS</SPAN ></TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="osissues.htm" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="choosingtdsprotocol.htm" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="CHAPTER" ><H1 ><A NAME="INSTALL" ></A >Chapter 3. Install <SPAN CLASS="PRODUCTNAME" >FreeTDS</SPAN ></H1 ><TABLE BORDER="0" WIDTH="100%" CELLSPACING="0" CELLPADDING="0" CLASS="EPIGRAPH" ><TR ><TD WIDTH="45%" > </TD ><TD WIDTH="45%" ALIGN="LEFT" VALIGN="TOP" ><I ><P ><I >If you install it they will stay?</I ></P ></I ></TD ></TR ></TABLE ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="install.htm#LOCALENVIRONMENT" >The local environment</A ></DT ><DT ><A HREF="choosingtdsprotocol.htm" >Choosing a <ACRONYM CLASS="ACRONYM" >TDS</ACRONYM > protocol version</A ></DT ><DT ><A HREF="name.lookup.htm" ><TT CLASS="REPLACEABLE" ><I >servername</I ></TT > Lookup</A ></DT ><DT ><A HREF="freetdsconf.htm" >The <TT CLASS="FILENAME" >freetds.conf</TT > file</A ></DT ><DT ><A HREF="locales.htm" >The <TT CLASS="FILENAME" >locales.conf</TT > file</A ></DT ><DT ><A HREF="envvar.htm" >Environment variables</A ></DT ><DT ><A HREF="portoverride.htm" >Port override syntax</A ></DT ><DT ><A HREF="confirminstall.htm" >Confirm the installation</A ></DT ></DL ></DIV ><P ></P ><DIV CLASS="NOTE" ><P ></P ><TABLE CLASS="NOTE" WIDTH="100%" BORDER="0" ><TR ><TD WIDTH="25" ALIGN="CENTER" VALIGN="TOP" ><IMG SRC="../images/note.gif" HSPACE="5" ALT="Note"></TD ><TH ALIGN="LEFT" VALIGN="MIDDLE" ><B >Confusing terminology</B ></TH ></TR ><TR ><TD > </TD ><TD ALIGN="LEFT" VALIGN="TOP" ><P ><SPAN CLASS="QUOTE" >"Configuring"</SPAN > and <SPAN CLASS="QUOTE" >"installing"</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 <B CLASS="COMMAND" >configure</B > the package (generate the <TT CLASS="FILENAME" >Makefile</TT >s), then we <B CLASS="COMMAND" >make install</B > the package. In the case of a library package such as <SPAN CLASS="PRODUCTNAME" >FreeTDS</SPAN > To <SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >install the package</I ></SPAN > is to copy the files the application developer will use to their canonical locations: header files to <TT CLASS="FILENAME" >include</TT >, libraries to the <TT CLASS="FILENAME" >lib</TT >, documentation and man pages <TT CLASS="FILENAME" >share</TT >. Install targets were specified during the <SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >build process</SPAN ></SPAN > as arguments to <B CLASS="COMMAND" >configure</B >, covered in the last chapter.</P ><P >For lack of a better term, this chapter describes installing the <SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >product</I ></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" ><H1 CLASS="SECT1" ><A NAME="LOCALENVIRONMENT" >The local environment</A ></H1 ><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 <TT CLASS="FILENAME" >freetds.conf</TT >. 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 ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="osissues.htm" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.htm" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="choosingtdsprotocol.htm" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >OS-specific Issues</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >Choosing a <ACRONYM CLASS="ACRONYM" >TDS</ACRONYM > protocol version</TD ></TR ></TABLE ></DIV ></BODY ></HTML >