1 <?xml version="1.0" standalone="no"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"
5 <!ENTITY % local SYSTEM "local.ent">
7 <!ENTITY manref SYSTEM "manref.xml">
8 <!ENTITY gpl2 SYSTEM "gpl-2.0.xml">
9 <!ENTITY % idcommon SYSTEM "common/common.ent">
14 <title>MP-SPARQL - User's Guide and Reference</title>
17 <firstname>Adam</firstname><surname>Dickmeiss</surname>
20 <firstname>Heikki</firstname><surname>Levanto</surname>
23 <firstname>Jakub</firstname><surname>Skoczen</surname>
26 <releaseinfo>&version;</releaseinfo>
28 <year>2014-2015</year>
29 <holder>Index Data</holder>
33 This manual is part of MP-SPARQL version &version;.
36 MP-XQuery is a Metaproxy module that converts Type-1/RPN Queries
40 MP-SPARQL is covered by the GNU General Public License version 2.
45 <imagedata fileref="common/id.png" format="PNG"/>
48 <imagedata fileref="common/id.eps" format="EPS"/>
54 <chapter id="introduction">
55 <title>Introduction</title>
57 MP-SPARQL is a <ulink url="&url.metaproxy;">Metaproxy</ulink> module
58 that converts Type-1/RPN queries to <ulink url="http://www.w3.org/TR/rdf-sparql-query/">SPARQL</ulink>.
61 <chapter id="installation">
62 <title>Installation</title>
64 MP-SPARQL is available as packages for CentOS/RHEL 5+6 and most
65 recent Ubuntu/Debian versions. For other systems, the module must be build
68 <sect1 id="installation.packages">
69 <title>Installing packages</title>
71 You need to enable the relevant software repositories.
72 For setting up refer to one of:
74 url="http://ftp.indexdata.dk/pub/mp-sparql/redhat/centos/5.5/README">CentOS 5</ulink>,
76 url="http://ftp.indexdata.dk/pub/mp-sparql/redhat/centos/6/README">CentOS 6</ulink>
79 url="http://ftp.indexdata.dk/pub/mp-sparql/ubuntu/README">Ubuntu</ulink>
82 url="http://ftp.indexdata.dk/pub/mp-sparql/debian/README">Debian</ulink>
85 The package is called <literal>mp-sparql</literal> on RHEL/Debian systems.
86 Install that package and you are ready to use filter "sparql" in your
90 <sect1 id="installation.source">
91 <title>Installing from source</title>
93 To build from source, you need metaproxy development
94 packages. Metaproxy can be installed as follows:
100 But consult the Metaproxy documentation for requirements and
104 We are now ready to build the MP-SPARQL module with:
107 make MP_CONFIG=/usr/local/bin/mp-config
109 Adjust <literal>MP_CONFIG</literal> value
110 above for the correct location of installed
111 Metaproxy's mp-config. <literal>MP_CONFIG</literal> can be omitted
112 if Metaproxy was installed in the system <filename>PATH</filename>.
115 You can now install the <filename>metaproxy_filter_sparql.so</filename>
116 in a directory searched by Metaproxy daemon.
117 Specifically, that's the directories
118 given by the <literal>dlpath</literal> configuration.
121 If dlpath includes <filename>/usr/lib/metaproxy6/modules</filename>,
122 the module can be installed with:
124 cp src/metaproxy_filter_sparql.so /usr/lib/metaproxy6/modules
129 For RHEL/CentOS systems on 64-bit architectures, the correct paths is:
130 <filename>/usr/lib64/metaproxy6/modules</filename>.
135 <reference id="reference">
136 <title>Reference</title>
137 <partintro id="reference-introduction">
139 The material in this chapter is drawn directly from the individual
146 <appendix id="license">
147 <title>License</title>
149 Copyright (C) 2014-2015 Index Data
153 Metaproxy is free software; you can redistribute it and/or modify it under
154 the terms of the GNU General Public License as published by the Free
155 Software Foundation; either version 2, or (at your option) any later
160 Metaproxy is distributed in the hope that it will be useful, but WITHOUT ANY
161 WARRANTY; without even the implied warranty of MERCHANTABILITY or
162 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
167 You should have received a copy of the GNU General Public License
168 along with Metaproxy; see the file LICENSE. If not, write to the
169 Free Software Foundation,
170 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
178 <!-- Keep this comment at the end of the file