source: archive/soprano.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 6.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY soprano-download-http "&sourceforge-repo;/soprano/soprano-&soprano-version;.tar.bz2">
8 <!ENTITY soprano-download-ftp " ">
9 <!ENTITY soprano-md5sum "91413e5783efeee0beb747ea4c5c9ef0">
10 <!ENTITY soprano-size "1.9 MB">
11 <!ENTITY soprano-buildsize "22 MB">
12 <!ENTITY soprano-time "0.6 SBU">
13]>
14
15<sect1 id="soprano" xreflabel="Soprano-&soprano-version;">
16 <?dbhtml filename="soprano.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Soprano-&soprano-version;</title>
23
24 <indexterm zone="soprano">
25 <primary sortas="a-Soprano">Soprano</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to Soprano</title>
30
31 <para>
32 <application>Soprano</application> (formally known as QRDF) is a
33 library which provides a nice Qt interface to RDF storage solutions.
34 It has a modular structure which allows to replace the actual RDF
35 storage implementation used.
36 </para>
37
38 &lfs75_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&soprano-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&soprano-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &soprano-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &soprano-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &soprano-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &soprano-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing='compact'>
76 <listitem>
77 <para>Required patch: <ulink
78 url="&patch-root;/soprano-&soprano-version;-dbus-1.patch"/></para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">Soprano Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="cmake"/>,
87 <xref linkend="qt4"/>, and
88 <xref linkend="redland"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <xref linkend="clucene"/>,
94 <xref linkend="dbus"/>,
95 <xref linkend="libiodbc"/> (required for the Virtuoso backend. Additionally,
96 <xref linkend="virtuoso"/> is required as a runtime dependency for this
97 backend.)
98 </para>
99
100 <bridgehead renderas="sect4">Optional</bridgehead>
101 <para role="optional">
102 <xref linkend="doxygen"/> (to build the documentation) and
103 <ulink url="http://www.openrdf.org/">Sesame2</ulink>
104 </para>
105
106 <para condition="html" role="usernotes">User Notes:
107 <ulink url="&blfs-wiki;/soprano"/>
108 </para>
109 </sect2>
110
111 <sect2 role="installation">
112 <title>Installation of Soprano</title>
113
114 <para>Install <application>soprano</application> by running the following
115 commands:</para>
116
117<screen><userinput>patch -Np1 -i ../soprano-&soprano-version;-dbus-1.patch &amp;&amp;
118
119mkdir build &amp;&amp;
120cd build &amp;&amp;
121
122cmake -DCMAKE_INSTALL_PREFIX=/usr \
123 -DCMAKE_BUILD_TYPE=Release \
124 .. &amp;&amp;
125make</userinput></screen>
126
127 <para>This package does not come with a working test suite.</para>
128
129 <para>
130 Now, as the <systemitem class="username">root</systemitem> user:
131 </para>
132
133<screen role="root"><userinput>make install</userinput></screen>
134
135</sect2>
136 <sect2 role="commands">
137 <title>Command Explanations</title>
138
139 <para>
140 <parameter>-DCMAKE_BUILD_TYPE=Release</parameter>: This switch is used
141 to apply higher level of the compiler optimizations.
142 </para>
143
144 <para>
145 <option>-DSOPRANO_DISABLE_CLUCENE_INDEX=ON</option>: This switch disables
146 compilation of Clucene-based full-text index.
147 </para>
148
149 </sect2>
150
151 <sect2 role="configuration">
152 <title>Configuration of Soprano</title>
153
154 <para>
155 Create a directory where <application>Soprano</application> places some
156 runtime data as the <systemitem class="username">root</systemitem> user:
157 </para>
158
159<screen role="root"><userinput>install -m755 -d /srv/soprano</userinput></screen>
160
161 <para>
162 The <command>sopranod</command> accepts some parameters. To configure
163 how the bootscript starts <command>sopranod</command>,
164 create a configuration file again as the
165 <systemitem class="username">root</systemitem> user:
166 </para>
167
168<screen role="root"><userinput>cat &gt; /etc/sysconfig/soprano &lt;&lt;EOF
169# Begin /etc/sysconfig/soprano
170
171SOPRANO_STORAGE="/srv/soprano"
172SOPRANO_BACKEND="virtuoso" # virtuoso, sesame2, redland
173#SOPRANO_OPTIONS="$SOPRANO_OPTIONS --port 4711" # Default port is 5000
174
175# End /etc/sysconfig/soprano
176EOF</userinput></screen>
177
178<sect3 id="soprano-init">
179 <title>Boot Script</title>
180
181 <note>
182 <para>
183 It is not required to start the <application>Soprano</application>
184 server at boottime for <application>KDE</application>.
185 <application>KDE</application> will start
186 <application>Soprano</application> as needed.
187 </para>
188 </note>
189
190 <para>
191 In order to get <application>Soprano</application> started
192 automatically when the system is booted, install the
193 <filename>/etc/rc.d/init.d/soprano</filename> init script included
194 in the <xref linkend="bootscripts"/> package as the
195 <systemitem class="username">root</systemitem> user:
196 </para>
197
198 <indexterm zone="soprano soprano-init">
199 <primary sortas="f-soprano">soprano</primary>
200 </indexterm>
201
202<screen role="root"><userinput>make install-soprano</userinput></screen>
203
204 </sect3>
205
206 </sect2>
207
208 <sect2 role="content">
209 <title>Contents</title>
210
211 <segmentedlist>
212 <segtitle>Installed Programs</segtitle>
213 <segtitle>Installed Libraries</segtitle>
214 <segtitle>Installed Directories</segtitle>
215
216 <seglistitem>
217 <seg>
218 onto2vocabularyclass, sopranocmd, and sopranod
219 </seg>
220 <seg>
221 libsopranoclient.so, libsopranoindex.so, libsopranoserver.so, and libsoprano.so
222 </seg>
223 <seg>
224 /usr/include/soprano,
225 /usr/include/Soprano,
226 /usr/lib/soprano, and
227 /usr/share/soprano
228 </seg>
229 </seglistitem>
230 </segmentedlist>
231
232 </sect2>
233
234</sect1>
Note: See TracBrowser for help on using the repository browser.