Author: randy
Date: Tue Feb 12 18:41:32 2013
New Revision: 11023
Log:
Added instructions to libiodbc and Virtuoso so they play nice with unixODBC
Modified:
trunk/BOOK/general.ent
trunk/BOOK/general/genutils/libiodbc.xml
trunk/BOOK/introduction/welcome/changelog.xml
trunk/BOOK/server/other/virtuoso.xml
Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent Tue Feb 12 09:45:32 2013 (r11022)
+++ trunk/BOOK/general.ent Tue Feb 12 18:41:32 2013 (r11023)
@@ -3,13 +3,13 @@
$Date$
-->
-<!ENTITY day "12"> <!-- Always 2 digits -->
+<!ENTITY day "13"> <!-- Always 2 digits -->
<!ENTITY month "02"> <!-- Always 2 digits -->
<!ENTITY year "2013">
<!ENTITY copyrightdate "2001-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY version "&year;-&month;-&day;">
-<!ENTITY releasedate "February 12th, &year;">
+<!ENTITY releasedate "February 13th, &year;">
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
<!ENTITY lfs-version "development"> <!--
version|testing|unstable|development] -->
Modified: trunk/BOOK/general/genutils/libiodbc.xml
==============================================================================
--- trunk/BOOK/general/genutils/libiodbc.xml Tue Feb 12 09:45:32 2013
(r11022)
+++ trunk/BOOK/general/genutils/libiodbc.xml Tue Feb 12 18:41:32 2013
(r11023)
@@ -60,7 +60,7 @@
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
- <xref linkend="gtk2"/> (in order to get the admin tool created)
+ <xref linkend="gtk2"/> (to create the GUI admin tool)
</para>
<para condition="html" role="usernotes">User Notes:
@@ -71,13 +71,24 @@
<sect2 role="installation">
<title>Installation of libiodbc</title>
- <para>Install <application>libiodbc</application> by running the following
- commands:</para>
+ <para>
+ Install <application>libiodbc</application> by running the following
+ commands:
+ </para>
-<screen><userinput>./configure prefix=/usr --with-iodbc-inidir=/etc/iodbc
&&
+<screen><userinput>./configure --prefix=/usr \
+ --with-iodbc-inidir=/etc/iodbc \
+ --includedir=/usr/include/iodbc \
+ --disable-libodbc &&
make</userinput></screen>
- <para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
+ <para>
+ This package does not come with a test suite.
+ </para>
+
+ <para>
+ Now, as the <systemitem class="username">root</systemitem> user:
+ </para>
<screen role="root"><userinput>make install</userinput></screen>
@@ -86,8 +97,22 @@
<sect2 role="commands">
<title>Command Explanations</title>
- <para><option>--with-iodbc-inidir</option>:
<application>libiodbc</application> will
- install config files in this directory.</para>
+ <para>
+ <parameter>--with-iodbc-inidir</parameter>:
<application>libiodbc</application>
+ will install configuration files in this directory.
+ </para>
+
+ <para>
+ <parameter>--includedir=/usr/include/iodbc</parameter>: This installs the
+ interface headers to a private directory to avoid a conflict with headers
+ installed by <application>unixODBC</application>.
+ </para>
+
+ <para>
+ <parameter>--disable-libodbc</parameter>: This prevents the installation
+ of the <filename class="symlink">libodbc.so</filename> symbolic link to
+ avoid a conflict with <application>unixODBC</application>.
+ </para>
</sect2>
@@ -100,9 +125,10 @@
<segtitle>Installed Directory</segtitle>
<seglistitem>
- <seg>iodbc-config, iodbctest, iodbctestw, iodbcadm</seg>
- <seg>libodbc.{a,so}, libiodbc.{a,so}, libiodbcinst.{a,so},
libiodbcadm.{a,so}</seg>
- <seg>/usr/share/libiodbc, /etc/iodbc</seg>
+ <seg>iodbc-config, iodbctest, iodbctestw, and iodbcadm</seg>
+ <seg>libiodbc.{a,so}, libiodbcinst.{a,so}, and
+ libiodbcadm.{a,so}</seg>
+ <seg>/usr/include/iodbc, /usr/share/libiodbc, and /etc/iodbc</seg>
</seglistitem>
</segmentedlist>
@@ -114,7 +140,7 @@
<varlistentry id="iodbc-config">
<term><command>iodbc-config</command></term>
<listitem>
- <para>is a utility for retrieving the installation options of
libiodbc</para>
+ <para>is a utility for retrieving the installation options of
libiodbc.</para>
<indexterm zone="libiodbc iodbc-config">
<primary sortas="b-iodbc-config">iodbc-config</primary>
</indexterm>
@@ -124,7 +150,7 @@
<varlistentry id="iodbctest">
<term><command>iodbctest{,w}</command></term>
<listitem>
- <para>is an interactive SQL processor</para>
+ <para>are interactive SQL processors.</para>
<indexterm zone="libiodbc iodbctest">
<primary sortas="b-iodbctest">iodbctest</primary>
</indexterm>
@@ -134,7 +160,7 @@
<varlistentry id="iodbcadm">
<term><command>iodbcadm</command></term>
<listitem>
- <para>is a graphical administration utility</para>
+ <para>is a graphical administration utility.</para>
<indexterm zone="libiodbc iodbcadm">
<primary sortas="b-iodbcadm">iodbcadm</primary>
</indexterm>
Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml Tue Feb 12 09:45:32
2013 (r11022)
+++ trunk/BOOK/introduction/welcome/changelog.xml Tue Feb 12 18:41:32
2013 (r11023)
@@ -45,6 +45,16 @@
-->
<listitem>
+ <para>February 13th, 2013</para>
+ <itemizedlist>
+ <listitem>
+ <para>[randy] - Added instructions to libiodbc and Virtuoso so
+ they play nice with unixODBC.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>February 11th, 2013</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/server/other/virtuoso.xml
==============================================================================
--- trunk/BOOK/server/other/virtuoso.xml Tue Feb 12 09:45:32 2013
(r11022)
+++ trunk/BOOK/server/other/virtuoso.xml Tue Feb 12 18:41:32 2013
(r11023)
@@ -8,8 +8,8 @@
<!ENTITY virtuoso-download-ftp " ">
<!ENTITY virtuoso-md5sum "3991149c570f3738c3e819ce603e487f">
<!ENTITY virtuoso-size "113 MB">
- <!ENTITY virtuoso-buildsize "530 MB">
- <!ENTITY virtuoso-time "4.2 SBU">
+ <!ENTITY virtuoso-buildsize "770 MB (additional 2 GB to run the test
suite)">
+ <!ENTITY virtuoso-time "5.0 SBU (additional 10 SBU to run the test
suite)">
]>
<sect1 id="virtuoso" xreflabel="Virtuoso-&virtuoso-version;">
@@ -81,15 +81,21 @@
<para role="recommended">
<xref linkend="libiodbc"/>,
<xref linkend="libxml2"/>,
- <xref linkend="openssl"/> and
- <xref linkend="openldap"/>.
+ <xref linkend="openssl"/>, and
+ <xref linkend="openldap"/>
<!--<xref linkend="jdk"/>-->
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
- <xref linkend="imagemagick"/> and
- <xref linkend="python2"/>
+ <xref linkend="imagemagick"/>,
+ <xref linkend="python2"/>, and
+ <xref linkend="mitkrb"/>
+ <!-- Currently broken
+ <xref linkend="php"/>
+ <xref linkend="ruby"/>
+ <ulink url="https://libwbxml.opensync.org/";>libwbxml</ulink
+ -->
</para>
<para condition="html" role="usernotes">User Notes:
@@ -103,55 +109,88 @@
<para>Install <application>virtuoso</application> by running the following
commands:</para>
-<screen><userinput>./configure --prefix=/usr \
- --sysconfdir=/etc \
- --localstatedir=/var \
- --without-internal-zlib \
+<screen><userinput>sed -i "s|virt_iodbc_dir/include|&/iodbc|" configure
&&
+./configure --prefix=/usr \
+ --sysconfdir=/etc \
+ --localstatedir=/var \
+ --with-iodbc=/usr \
+ --with-readline \
+ --without-internal-zlib \
--program-transform-name="s/isql/isql-v/" \
- --disable-all-vads \
- --disable-static &&
+ --disable-all-vads \
+ --disable-static &&
make</userinput></screen>
- <para><application>Virtuoso</application> does not come with a callable
test
- suite. An intensive check routine is part of the build process.</para>
+ <para>To test the results, issue <command>make -k check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
-<screen role="root"><userinput>make install</userinput></screen>
+<screen role="root"><userinput>make install &&
+install -v -m755 -d /usr/share/doc/virtuoso-&virtuoso-version; &&
+ln -s -v ../../virtuoso/doc \
+
/usr/share/doc/virtuoso-&virtuoso-version;</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
- <para><option>--without-internal-zlib</option>: This option is set to use
- the installed <application>zlib</application> and not the bundled
- one.</para>
+ <para><command>sed -i ...</command>: This command is used to modify the
+ <envar>CPPFLAGS</envar> variable so that the
<application>libiodbc</application>
+ interface headers are found by the <command>configure</command>
script.</para>
+
+ <para><parameter>--with-iodbc=/usr</parameter>: This parameter is used so
+ that the build will use the system <application>libiodbc</application>
interface
+ headers and not the headers in the source tree.</para>
+
+ <para><parameter>--with-readline</parameter>: This parameter is used so
that
+ the system <application>Readline</application> library is used.</para>
+
+ <para><parameter>--without-internal-zlib</parameter>: This parameter is set
+ so that the installed <application>zlib</application> library is used and
+ not the bundled one.</para>
- <para><option>--program-transform-name</option>: Both
+ <para><parameter>--program-transform-name</parameter>: Both
<application>Virtuoso</application> and <application>unixODBC</application>
- install a program named <command>isql</command>. Use this option to rename
- <application>virtuoso</application>s program to
<command>isql-v</command></para>
+ install a program named <command>isql</command>. Use this parameter to
rename
+ <application>virtuoso</application>s program to
<command>isql-v</command>.</para>
- <para><option>--disable-all-vads</option>: This option disables the
building of
- all the VAD packages (tutorials, demos, etc.).</para>
+ <para><parameter>--disable-all-vads</parameter>: This parameter disables
+ building all the VAD packages (tutorials, demos, etc.).</para>
- <para><option>--disable-static</option>: This option disables the building
of static
- libraries. However, the main virtuoso library, libvirtuoso-t, is still
built as a
- static library.</para>
-
- <para><option>--enable-python</option>: Add this option if
- <application>Python</application> is installed. It enables the
- use of <application>Python</application> by
- <application>Virtuoso</application>.</para>
-<!--
+ <para><parameter>--disable-static</parameter>: This option disables
building
+ static libraries. However, the main <application>Virtuoso</application>
+ libraries, <filename class="libraryfile">libvirtuoso-t</filename> and
+ <filename class="libraryfile">libvirtuoso-iodbc-t</filename> are still
+ built as static libraries.</para>
+
+ <para><option>--enable-python</option>: Add this option if
+ <application>Python</application> is installed to enable building
+ <application>Python</application> bindings.</para>
+
+<!-- broken with JDK-version7
<para><option>--with-jdk4</option>: Add this option to specify the path
to the <xref linkend="jdk"/> and to enable making use of Java.</para>
-->
+
<para><option>--with-port</option>: Add this if you want the
- <application>virtuoso</application> server to listen on another port than
+ <application>Virtuoso</application> server to listen on a port other than
1111.</para>
+ <para><option>--enable-aio</option>: Add this if you want
+ <application>Virtuoso</application> to perform asynchronous file I/O
+ operations instead of synchronous file I/O.</para>
+
+ <para><option>--enable-perl</option>: Do not use this option if you built
+ Perl according to the LFS instructions. The build will fail with a note
+ similar to <computeroutput>Your perl should be compiled w
-Dusemultiplicity.
+ Check the output of perl -V:usemultiplicity</computeroutput>.</para>
+
+ <para>Note that passing the <option>with-jdk4=${JAVA_HOME}</option>,
+ <option>--enable-php5=/usr</option>, <option>--enable-ruby</option>, and
+ <option>--enable-wbxml2=/usr</option> options all will fail during the
+ <command>configure</command> phase of the build. They will not break
+ the build, but the desired support will not be included in the
build.</para>
</sect2>
<sect2 role="configuration">
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
