~ubuntu-branches/debian/lenny/freetds/lenny

« back to all changes in this revision

Viewing changes to doc/doc/freetds-0.63/userguide/osissues.htm

  • Committer: Bazaar Package Importer
  • Author(s): Steve Langasek
  • Date: 2008-08-02 11:49:53 UTC
  • mfrom: (2.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20080802114953-0qdeowgl63k42n2c
Tags: 0.82-4
* Fix a typo in the freetds-common description, ugh
* Versioned replaces of libct4 by freetds-common, since the current one
  obviously doesn't have overlapping files.
* tdsodbc: check for /var/lib/odbc existence before removing it in the
  postinst, since there are cases where it won't exist on upgrade (i.e.,
  if the driver was never enabled in the first place).  Closes: #493303.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<HTML
2
 
><HEAD
3
 
><TITLE
4
 
>OS-specific Issues</TITLE
5
 
><META
6
 
NAME="GENERATOR"
7
 
CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
8
 
REL="HOME"
9
 
TITLE="FreeTDS User Guide"
10
 
HREF="index.htm"><LINK
11
 
REL="UP"
12
 
TITLE="Build FreeTDS"
13
 
HREF="build.htm"><LINK
14
 
REL="PREVIOUS"
15
 
TITLE="How to build: Configure and make"
16
 
HREF="config.htm"><LINK
17
 
REL="NEXT"
18
 
TITLE="Install FreeTDS"
19
 
HREF="install.htm"></HEAD
20
 
><BODY
21
 
CLASS="SECT1"
22
 
BGCOLOR="#FFFFFF"
23
 
TEXT="#000000"
24
 
LINK="#0000FF"
25
 
VLINK="#840084"
26
 
ALINK="#0000FF"
27
 
><DIV
28
 
CLASS="NAVHEADER"
29
 
><TABLE
30
 
WIDTH="100%"
31
 
BORDER="0"
32
 
CELLPADDING="0"
33
 
CELLSPACING="0"
34
 
><TR
35
 
><TH
36
 
COLSPAN="3"
37
 
ALIGN="center"
38
 
><SPAN
39
 
CLASS="PRODUCTNAME"
40
 
>FreeTDS</SPAN
41
 
> User Guide: A Guide to Installing, Configuring, and Running <SPAN
42
 
CLASS="PRODUCTNAME"
43
 
>FreeTDS</SPAN
44
 
></TH
45
 
></TR
46
 
><TR
47
 
><TD
48
 
WIDTH="10%"
49
 
ALIGN="left"
50
 
VALIGN="bottom"
51
 
><A
52
 
HREF="config.htm"
53
 
>Prev</A
54
 
></TD
55
 
><TD
56
 
WIDTH="80%"
57
 
ALIGN="center"
58
 
VALIGN="bottom"
59
 
>Chapter 2. Build <SPAN
60
 
CLASS="PRODUCTNAME"
61
 
>FreeTDS</SPAN
62
 
></TD
63
 
><TD
64
 
WIDTH="10%"
65
 
ALIGN="right"
66
 
VALIGN="bottom"
67
 
><A
68
 
HREF="install.htm"
69
 
>Next</A
70
 
></TD
71
 
></TR
72
 
></TABLE
73
 
><HR
74
 
ALIGN="LEFT"
75
 
WIDTH="100%"></DIV
76
 
><DIV
77
 
CLASS="SECT1"
78
 
><H1
79
 
CLASS="SECT1"
80
 
><A
81
 
NAME="OSISSUES"
82
 
>OS-specific Issues</A
83
 
></H1
84
 
><TABLE
85
 
CLASS="SIDEBAR"
86
 
BORDER="1"
87
 
CELLPADDING="5"
88
 
><TR
89
 
><TD
90
 
><DIV
91
 
CLASS="SIDEBAR"
92
 
><A
93
 
NAME="AEN584"
94
 
></A
95
 
><P
96
 
></P
97
 
><P
98
 
>If you've recently built and installed <SPAN
99
 
CLASS="PRODUCTNAME"
100
 
>FreeTDS</SPAN
101
 
> and noticed steps peculiar to your OS, we'll happily include your comments here. </P
102
 
><P
103
 
>One thing that can be said, if it's not too obvious:  check with your vendor or favorite download site.  <SPAN
104
 
CLASS="PRODUCTNAME"
105
 
>FreeTDS</SPAN
106
 
> is routinely rolled up into OS install packages.  We know of packages for <SPAN
107
 
CLASS="PRODUCTNAME"
108
 
>Debian</SPAN
109
 
>, <SPAN
110
 
CLASS="PRODUCTNAME"
111
 
>Red Hat</SPAN
112
 
>, <SPAN
113
 
CLASS="PRODUCTNAME"
114
 
>FreeBSD</SPAN
115
 
>, and <SPAN
116
 
CLASS="PRODUCTNAME"
117
 
>NetBSD</SPAN
118
 
>.  The installation through the package management systems in these environments may well reduce your work to simply <B
119
 
CLASS="COMMAND"
120
 
>make install</B
121
 
>.  </P
122
 
><P
123
 
></P
124
 
></DIV
125
 
></TD
126
 
></TR
127
 
></TABLE
128
 
><DIV
129
 
CLASS="SECT2"
130
 
><H2
131
 
CLASS="SECT2"
132
 
><A
133
 
NAME="WINDOWS"
134
 
></A
135
 
></H2
136
 
><P
137
 
>The <SPAN
138
 
CLASS="PRODUCTNAME"
139
 
>FreeTDS</SPAN
140
 
> ODBC driver compiles under
141
 
                        
142
 
                        <P
143
 
></P
144
 
><UL
145
 
><LI
146
 
><P
147
 
>VC++; <TT
148
 
CLASS="FILENAME"
149
 
>.dsw</TT
150
 
> and <TT
151
 
CLASS="FILENAME"
152
 
>.dsp</TT
153
 
> files are included in the <TT
154
 
CLASS="FILENAME"
155
 
>win32</TT
156
 
> directory.  </P
157
 
></LI
158
 
><LI
159
 
><P
160
 
>Dev-C++</P
161
 
></LI
162
 
><LI
163
 
><P
164
 
>MingW</P
165
 
></LI
166
 
><LI
167
 
><P
168
 
><SPAN
169
 
CLASS="APPLICATION"
170
 
>gcc</SPAN
171
 
> under <SPAN
172
 
CLASS="APPLICATION"
173
 
>cygwin</SPAN
174
 
>. </P
175
 
></LI
176
 
><LI
177
 
><P
178
 
>The Borland Builder 6.0 compiler is also reported to work, but requires some tweaking of the <TT
179
 
CLASS="LITERAL"
180
 
>#include</TT
181
 
> statements.  We would apply any patches that make this work cleanly.</P
182
 
></LI
183
 
></UL
184
 
>       
185
 
 
186
 
Threadsafe operation will not be enabled.  </P
187
 
><P
188
 
>From the Department of Double Emulation: <SPAN
189
 
CLASS="PRODUCTNAME"
190
 
>FreeTDS</SPAN
191
 
> builds as a <TT
192
 
CLASS="FILENAME"
193
 
>.dll</TT
194
 
> under <SPAN
195
 
CLASS="PRODUCTNAME"
196
 
>WINE</SPAN
197
 
> and as a <TT
198
 
CLASS="FILENAME"
199
 
>.a</TT
200
 
> under <SPAN
201
 
CLASS="PRODUCTNAME"
202
 
>Interix</SPAN
203
 
>.  See the mailing list archives (second half of 2003) for details.  </P
204
 
></DIV
205
 
><DIV
206
 
CLASS="SECT2"
207
 
><H2
208
 
CLASS="SECT2"
209
 
><A
210
 
NAME="VMS"
211
 
>VMS&reg;</A
212
 
></H2
213
 
><P
214
 
><SPAN
215
 
CLASS="PRODUCTNAME"
216
 
>FreeTDS</SPAN
217
 
> will probably build and run on most versions of OpenVMS Alpha 7.0 and later with DEC/Compaq C 6.0 or later.  Other prerequisites:
218
 
 
219
 
                        <P
220
 
></P
221
 
><TABLE
222
 
BORDER="0"
223
 
><TBODY
224
 
><TR
225
 
><TD
226
 
><SPAN
227
 
CLASS="APPLICATION"
228
 
>gunzip</SPAN
229
 
></TD
230
 
></TR
231
 
><TR
232
 
><TD
233
 
><SPAN
234
 
CLASS="APPLICATION"
235
 
>vmstar</SPAN
236
 
></TD
237
 
></TR
238
 
><TR
239
 
><TD
240
 
><SPAN
241
 
CLASS="APPLICATION"
242
 
>MMS</SPAN
243
 
> or <SPAN
244
 
CLASS="APPLICATION"
245
 
>MMK</SPAN
246
 
></TD
247
 
></TR
248
 
></TBODY
249
 
></TABLE
250
 
><P
251
 
></P
252
 
>
253
 
                        </P
254
 
><DIV
255
 
CLASS="SECT3"
256
 
><H3
257
 
CLASS="SECT3"
258
 
><A
259
 
NAME="AEN633"
260
 
>Build Instructions</A
261
 
></H3
262
 
><P
263
 
>Decompress and unpack the source archive using gunzip and vmstar.  If
264
 
you are untarring on an ODS-5 disk, you should use the <TT
265
 
CLASS="PARAMETER"
266
 
><I
267
 
>/ODS2</I
268
 
></TT
269
 
> or <TT
270
 
CLASS="PARAMETER"
271
 
><I
272
 
>-o</I
273
 
></TT
274
 
>
275
 
option to create universally VMS-friendly filenames; otherwise the build will fail to locate some files.</P
276
 
><P
277
 
>Set default to the top-level source directory and run the configuration
278
 
script:</P
279
 
><PRE
280
 
CLASS="SCREEN"
281
 
>    <TT
282
 
CLASS="PROMPT"
283
 
>$</TT
284
 
> <TT
285
 
CLASS="USERINPUT"
286
 
><B
287
 
>@[.vms]configure</B
288
 
></TT
289
 
></PRE
290
 
><P
291
 
> This creates a <TT
292
 
CLASS="FILENAME"
293
 
>descrip.mms</TT
294
 
> in the top-level source
295
 
directory which you may execute by simply running MMS (if you have the Module Management System that
296
 
is part of DECset) or MMK (a freeware MMS alternative available from <A
297
 
HREF="http://www.madgoat.com"
298
 
TARGET="_top"
299
 
>www.madgoat.com</A
300
 
>).</P
301
 
><P
302
 
>Further information can be found in the <TT
303
 
CLASS="FILENAME"
304
 
></TT
305
 
> in the source distribution.  
306
 
                        </P
307
 
></DIV
308
 
></DIV
309
 
><DIV
310
 
CLASS="SECT2"
311
 
><H2
312
 
CLASS="SECT2"
313
 
><A
314
 
NAME="OSX"
315
 
>OS X&reg;</A
316
 
></H2
317
 
><P
318
 
>As of this writing ($Date: 2004/11/30 01:22:52 $), the regular distribution compiles on OS X.  Releases prior to 0.63 either did not compile or required patching.  </P
319
 
><DIV
320
 
CLASS="SECT3"
321
 
><H3
322
 
CLASS="SECT3"
323
 
><A
324
 
NAME="OSX.BUILD.UPDATE"
325
 
>Alternative build procedure</A
326
 
></H3
327
 
><P
328
 
>On  11 March 2004, <TT
329
 
CLASS="EMAIL"
330
 
>&#60;<A
331
 
HREF="mailto:Dmitri Fedortchenko"
332
 
><A
333
 
HREF="mailto:dimo@angelhill.net"
334
 
TARGET="_top"
335
 
>Dmitri Fedortchenko</A
336
 
></A
337
 
>&#62;</TT
338
 
> offered the following approach, using a local <B
339
 
CLASS="COMMAND"
340
 
>libtool</B
341
 
>.  It is included here as a source of clues, in case you encounter trouble.  </P
342
 
><DIV
343
 
CLASS="PROCEDURE"
344
 
><P
345
 
><B
346
 
>Installing with libtool 1.5.2</B
347
 
></P
348
 
><OL
349
 
TYPE="1"
350
 
><LI
351
 
><P
352
 
>Install the latest <B
353
 
CLASS="COMMAND"
354
 
>libtool</B
355
 
> from GNU into <TT
356
 
CLASS="FILENAME"
357
 
>/usr/local</TT
358
 
>, so as not to interfere with the Apple-original.  </P
359
 
></LI
360
 
><LI
361
 
><P
362
 
>Make sure <TT
363
 
CLASS="FILENAME"
364
 
>/usr/local/bin</TT
365
 
> is in your <TT
366
 
CLASS="ENVAR"
367
 
>PATH</TT
368
 
> and <TT
369
 
CLASS="FILENAME"
370
 
>/usr/local/lib</TT
371
 
> is in your <TT
372
 
CLASS="ENVAR"
373
 
>LIBRARY_PATH</TT
374
 
>.  </P
375
 
></LI
376
 
><LI
377
 
><P
378
 
>Go to the <SPAN
379
 
CLASS="PRODUCTNAME"
380
 
>FreeTDS</SPAN
381
 
> source directory and generate the <TT
382
 
CLASS="FILENAME"
383
 
>Makefile</TT
384
 
>s
385
 
                <PRE
386
 
CLASS="SCREEN"
387
 
>               <TT
388
 
CLASS="PROMPT"
389
 
>$ </TT
390
 
><TT
391
 
CLASS="USERINPUT"
392
 
><B
393
 
>./configure --disable-libiconv --disable-odbc</B
394
 
></TT
395
 
>
396
 
                </PRE
397
 
>
398
 
                </P
399
 
></LI
400
 
><LI
401
 
><P
402
 
>Overwrite FreeTDS's <TT
403
 
CLASS="FILENAME"
404
 
>libtool</TT
405
 
> with a symbolic link to your (better) one
406
 
                <PRE
407
 
CLASS="SCREEN"
408
 
>               <A
409
 
NAME="AEN679"
410
 
HREF="#FTN.AEN679"
411
 
>[1]</A
412
 
>
413
 
                <TT
414
 
CLASS="PROMPT"
415
 
>$ </TT
416
 
><TT
417
 
CLASS="USERINPUT"
418
 
><B
419
 
>ln -sf /usr/local/bin/libtool</B
420
 
></TT
421
 
>
422
 
                </PRE
423
 
></P
424
 
></LI
425
 
><LI
426
 
><P
427
 
>To check that you've done everything correctly up to this 
428
 
point, 
429
 
                <PRE
430
 
CLASS="SCREEN"
431
 
>               <TT
432
 
CLASS="PROMPT"
433
 
>$ </TT
434
 
><TT
435
 
CLASS="USERINPUT"
436
 
><B
437
 
>./libtool --version</B
438
 
></TT
439
 
>
440
 
                </PRE
441
 
>
442
 
                <B
443
 
CLASS="COMMAND"
444
 
>libtool</B
445
 
> should report version 1.5.2 (or whatever version you downloaded, and <I
446
 
CLASS="EMPHASIS"
447
 
>not</I
448
 
> 1.4).  </P
449
 
></LI
450
 
><LI
451
 
><P
452
 
>And finally, of course
453
 
                <PRE
454
 
CLASS="SCREEN"
455
 
>               <TT
456
 
CLASS="PROMPT"
457
 
>$ </TT
458
 
><TT
459
 
CLASS="USERINPUT"
460
 
><B
461
 
>make &#38;&#38; make install</B
462
 
></TT
463
 
>
464
 
                </PRE
465
 
>
466
 
                </P
467
 
></LI
468
 
></OL
469
 
></DIV
470
 
></DIV
471
 
></DIV
472
 
></DIV
473
 
><H3
474
 
CLASS="FOOTNOTES"
475
 
>Notes</H3
476
 
><TABLE
477
 
BORDER="0"
478
 
CLASS="FOOTNOTES"
479
 
WIDTH="100%"
480
 
><TR
481
 
><TD
482
 
ALIGN="LEFT"
483
 
VALIGN="TOP"
484
 
WIDTH="5%"
485
 
><A
486
 
NAME="FTN.AEN679"
487
 
HREF="osissues.htm#AEN679"
488
 
>[1]</A
489
 
></TD
490
 
><TD
491
 
ALIGN="LEFT"
492
 
VALIGN="TOP"
493
 
WIDTH="95%"
494
 
><P
495
 
> If you run <B
496
 
CLASS="COMMAND"
497
 
>configure</B
498
 
> again, you'll need to perform this step
499
 
again, because <B
500
 
CLASS="COMMAND"
501
 
>libtool</B
502
 
> will have been regenerated in its fossilized state.   </P
503
 
></TD
504
 
></TR
505
 
></TABLE
506
 
><DIV
507
 
CLASS="NAVFOOTER"
508
 
><HR
509
 
ALIGN="LEFT"
510
 
WIDTH="100%"><TABLE
511
 
WIDTH="100%"
512
 
BORDER="0"
513
 
CELLPADDING="0"
514
 
CELLSPACING="0"
515
 
><TR
516
 
><TD
517
 
WIDTH="33%"
518
 
ALIGN="left"
519
 
VALIGN="top"
520
 
><A
521
 
HREF="config.htm"
522
 
>Prev</A
523
 
></TD
524
 
><TD
525
 
WIDTH="34%"
526
 
ALIGN="center"
527
 
VALIGN="top"
528
 
><A
529
 
HREF="index.htm"
530
 
>Home</A
531
 
></TD
532
 
><TD
533
 
WIDTH="33%"
534
 
ALIGN="right"
535
 
VALIGN="top"
536
 
><A
537
 
HREF="install.htm"
538
 
>Next</A
539
 
></TD
540
 
></TR
541
 
><TR
542
 
><TD
543
 
WIDTH="33%"
544
 
ALIGN="left"
545
 
VALIGN="top"
546
 
>How to build: Configure and make</TD
547
 
><TD
548
 
WIDTH="34%"
549
 
ALIGN="center"
550
 
VALIGN="top"
551
 
><A
552
 
HREF="build.htm"
553
 
>Up</A
554
 
></TD
555
 
><TD
556
 
WIDTH="33%"
557
 
ALIGN="right"
558
 
VALIGN="top"
559
 
>Install <SPAN
560
 
CLASS="PRODUCTNAME"
561
 
>FreeTDS</SPAN
562
 
></TD
563
 
></TR
564
 
></TABLE
565
 
></DIV
566
 
></BODY
567
 
></HTML
568
 
>
 
 
b'\\ No newline at end of file'