rev |
line source |
charnik@211
|
1 Strabon
|
charnik@211
|
2 -----------
|
charnik@211
|
3
|
charnik@211
|
4 Introduction
|
charnik@211
|
5 ============
|
charnik@211
|
6 Strabon is a fully implemented semantic geospatial database system that can be
|
charnik@211
|
7 used to store linked geospatial data expressed in RDF and query them using an
|
charnik@211
|
8 extension of SPARQL. Strabon supports spatial selections, spatial joins, a rich
|
charnik@211
|
9 set of spatial functions similar to those offered by geospatial relational
|
charnik@211
|
10 database systems, support for multiple Coordinate Reference Systems and widely
|
charnik@211
|
11 used serializations for geometric objects such as WKT and GML. Strabon is built
|
charnik@211
|
12 on top of the well-known RDF store Sesame and extends Sesame’s components to be
|
charnik@211
|
13 able to manage thematic and spatial data that are stored in PostGIS.
|
charnik@211
|
14
|
charnik@211
|
15 The development of Strabon started in the context of European FP7 project
|
charnik@211
|
16 SemsorGrid4Env (Semantic Sensor Grids for Rapid Application Development for
|
charnik@211
|
17 Environmental Management) [http://www.semsorgrid4env.eu/]. Starting September
|
charnik@211
|
18 2011, Strabon is being utilized and extended with new functionalities in the
|
charnik@211
|
19 FP7 project TELEIOS (Virtual Observatory Infrastructure for Earth Observation
|
charnik@211
|
20 Data) [http://www.earthobservatory.eu/] which our group leads.
|
charnik@211
|
21
|
charnik@211
|
22 The query language of Strabon is called stSPARQL. stSPARQL can be used to query
|
charnik@211
|
23 data represented in an extension of RDF called stRDF. stRDF and stSPARQL have
|
charnik@211
|
24 been designed for representing and querying geospatial data that changes over
|
charnik@211
|
25 time (e.g., the growth of a city over the years due to new developments).
|
charnik@211
|
26
|
charnik@211
|
27 Currently, only the geospatial features of stSPARQL have been implemented fully.
|
charnik@211
|
28 The temporal features are the subject of current work.
|
charnik@211
|
29
|
kkyzir@639
|
30 Given the very close relationship between stSPARQL and GeoSPARQL which is a
|
kkyzir@639
|
31 recent OGC standard for an extension of SPARQL for querying geospatial metadata,
|
kkyzir@639
|
32 we recently provided support for the Core, Geometry and Geometry Topology
|
kkyzir@639
|
33 extension of GeoSPARQL.
|
kkyzir@639
|
34
|
charnik@211
|
35
|
charnik@212
|
36 Strabon Homepage
|
charnik@212
|
37 ================
|
charnik@212
|
38 The homepage of Strabon is at http://www.strabon.di.uoa.gr/.
|
charnik@212
|
39
|
charnik@212
|
40
|
charnik@211
|
41 Demo
|
charnik@211
|
42 ====
|
charnik@211
|
43 You can find a demo of the system Strabon at http://test.strabon.di.uoa.gr/NOA/.
|
charnik@211
|
44
|
charnik@212
|
45
|
charnik@211
|
46 Getting Started
|
charnik@211
|
47 ===============
|
charnik@211
|
48 To get started with Strabon please have a look at the tutorial for the stRDF
|
charnik@211
|
49 data model and stSPARQL query language, the User Guide, and the Developer Guide.
|
charnik@211
|
50
|
charnik@211
|
51 stRDF and stSPARQL tutorial
|
charnik@211
|
52 http://www.strabon.di.uoa.gr/files/stSPARQL_tutorial.pdf
|
charnik@211
|
53
|
kkyzir@800
|
54
|
kkyzir@800
|
55 stSPARQL Reference
|
kkyzir@800
|
56 ~~~~~~~~~~~~~~~~~~
|
kkyzir@800
|
57 The reference for the spatial and temporal extension functions defined in
|
kkyzir@800
|
58 stSPARQL can be found at http://www.strabon.di.uoa.gr/stSPARQL#spatial and
|
kkyzir@800
|
59 http://www.strabon.di.uoa.gr/stSPARQL#temporals respectively.
|
kkyzir@800
|
60
|
kkyzir@800
|
61
|
charnik@211
|
62 User Guide
|
charnik@211
|
63 ~~~~~~~~~~
|
charnik@211
|
64 Assuming that you are familiar with Maven, the following steps need to be
|
charnik@211
|
65 followed in order to use Strabon using Eclipse:
|
charnik@211
|
66
|
charnik@211
|
67 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
|
charnik@211
|
68 this writing the latest PostgreSQL version is 9.1.
|
charnik@211
|
69 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
|
charnik@211
|
70 this writing we have tested Strabon with PostGIS 1.5.3.
|
charnik@211
|
71 3. Install Maven from http://maven.apache.org/download.html. At the time of this
|
charnik@211
|
72 writing the latest Maven version is 3.0.4.
|
charnik@211
|
73 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
|
charnik@211
|
74 writing the latest Eclipse version is 3.7.2.
|
charnik@211
|
75 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
|
charnik@211
|
76 6. Install the MercurialEclipse plugin for Eclipse from
|
charnik@211
|
77 http://javaforge.com/project/HGE .
|
charnik@211
|
78 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
|
charnik@211
|
79 Mercurial Repository --> Next. In the URL textarea paste the following
|
charnik@211
|
80 URL: http://hg.strabon.di.uoa.gr/StrabonUser and then press Next --> Next -->
|
charnik@211
|
81 Finish. If you used the default settings, you should have a new project named
|
charnik@211
|
82 StrabonMain. Right click on the project and select Configure --> Convert to
|
charnik@211
|
83 Maven project. Eclipse will enable Maven dependency management for the
|
charnik@211
|
84 project, download any dependencies and build the project.
|
charnik@211
|
85
|
charnik@211
|
86
|
charnik@211
|
87 Storing stRDF graphs and evaluating stSPARQL queries
|
charnik@211
|
88 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
charnik@211
|
89 You can see some examples in the classes gr.uoa.di.strabon.example.PostgisExample
|
charnik@211
|
90 and gr.uoa.di.strabon.example.PostgisExample2.
|
charnik@211
|
91
|
kkyzir@954
|
92 Tuning PostgreSQL
|
kkyzir@954
|
93 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
kkyzir@954
|
94 The default settings of Postgres are rather conservative. As a result, parameter
|
kkyzir@954
|
95 tuning is neccessary for speeding up Postgres, therefore Strabon. If you are
|
kkyzir@954
|
96 using Strabon to compare its performance against your implementation of
|
kkyzir@954
|
97 stSPARQL/GeoSPARQL, you are *strongly* encouraged to contact us using the Strabon
|
kkyzir@954
|
98 Users mailing list for assistance on tuning Postgres.
|
kkyzir@954
|
99
|
kkyzir@954
|
100 You can follow the instructions below for tuning a Postgres server running on an
|
kkyzir@954
|
101 Ubuntu machine that is dedicated to PostgreSQL and Strabon.
|
kkyzir@954
|
102
|
kkyzir@954
|
103 1. Append the following text at the end of postgresql.conf.
|
kkyzir@954
|
104 *Uncomment* the appropriate lines.
|
kkyzir@954
|
105
|
kkyzir@954
|
106 ### RAM
|
kkyzir@954
|
107 ## 4 GB of RAM
|
kkyzir@954
|
108 #shared_buffers = 3GB
|
kkyzir@954
|
109 #effective_cache_size = 3GB
|
kkyzir@954
|
110 #maintenance_work_mem = 1GB
|
kkyzir@954
|
111 #work_mem = 2GB
|
kkyzir@954
|
112 ## 8 GB of RAM
|
kkyzir@954
|
113 #shared_buffers = 5GB
|
kkyzir@954
|
114 #effective_cache_size = 6GB
|
kkyzir@954
|
115 #maintenance_work_mem = 2GB
|
kkyzir@954
|
116 #work_mem = 5GB
|
kkyzir@954
|
117 ## 16 GB of RAM
|
kkyzir@954
|
118 #shared_buffers = 10GB
|
kkyzir@954
|
119 #effective_cache_size = 14GB
|
kkyzir@954
|
120 #maintenance_work_mem = 4GB
|
kkyzir@954
|
121 #work_mem = 10GB
|
kkyzir@954
|
122 ## 24 GB of RAM
|
kkyzir@954
|
123 #shared_buffers = 16GB
|
kkyzir@954
|
124 #effective_cache_size = 22GB
|
kkyzir@954
|
125 #maintenance_work_mem = 6GB
|
kkyzir@954
|
126 #work_mem = 15GB
|
kkyzir@954
|
127 ## 48 GB of RAM
|
kkyzir@954
|
128 #shared_buffers = 32GB
|
kkyzir@954
|
129 #effective_cache_size = 46GB
|
kkyzir@954
|
130 #maintenance_work_mem = 8GB
|
kkyzir@954
|
131 #work_mem = 30GB
|
kkyzir@954
|
132 ## 64 GB of RAM
|
kkyzir@954
|
133 # contact us to find out!
|
kkyzir@954
|
134 ### HD
|
kkyzir@954
|
135 ## RAID with ordinary 7.200 disks
|
kkyzir@954
|
136 #random_page_cost = 3.5 #3.0-3.5
|
kkyzir@954
|
137 ## High-End NAS/SAN
|
kkyzir@954
|
138 #random_page_cost = 2 #1.5-2.5
|
kkyzir@954
|
139 ## Amazon EBS/Heroku
|
kkyzir@954
|
140 #random_page_cost = 1.3 #1.1-2.0
|
kkyzir@954
|
141 ## SSD array
|
kkyzir@954
|
142 #random_page_cost = 2.0 #1.5-2.5
|
kkyzir@954
|
143 ### Misc
|
kkyzir@954
|
144 default_statistics_target = 10000
|
kkyzir@954
|
145 constraint_exclusion = on
|
kkyzir@954
|
146 checkpoint_completion_target = 0.9
|
kkyzir@954
|
147 wal_buffers = 32MB
|
kkyzir@954
|
148 checkpoint_segments = 64
|
kkyzir@954
|
149 ### Connections
|
kkyzir@954
|
150 max_connections = 10
|
kkyzir@954
|
151
|
kkyzir@954
|
152 2. Append the following lines at the end of /etc/sysctl.conf
|
kkyzir@954
|
153 *Uncomment* the appropriate lines.
|
kkyzir@954
|
154
|
kkyzir@954
|
155 ## 4 GB of RAM
|
kkyzir@954
|
156 #kernel.shmmax = 3758096384
|
kkyzir@954
|
157 #kernel.shmall = 3758096384
|
kkyzir@954
|
158 #kernel.shmmni = 4096
|
kkyzir@954
|
159 ## 8 GB of RAM
|
kkyzir@954
|
160 #kernel.shmmax = 5905580032
|
kkyzir@954
|
161 #kernel.shmall = 5905580032
|
kkyzir@954
|
162 #kernel.shmmni = 4096
|
kkyzir@954
|
163 ## 16 GB of RAM
|
kkyzir@954
|
164 #kernel.shmmax = 11274289152
|
kkyzir@954
|
165 #kernel.shmall = 11274289152
|
kkyzir@954
|
166 #kernel.shmmni = 4096
|
kkyzir@954
|
167 ## 24 GB of RAM
|
kkyzir@954
|
168 #kernel.shmmax = 17716740096
|
kkyzir@954
|
169 #kernel.shmall = 17716740096
|
kkyzir@954
|
170 #kernel.shmmni = 4096
|
kkyzir@954
|
171 ## 48 GB of RAM
|
kkyzir@954
|
172 #kernel.shmmax = 35433480192
|
kkyzir@954
|
173 #kernel.shmall = 35433480192
|
kkyzir@954
|
174 #kernel.shmmni = 4224
|
kkyzir@954
|
175 ## 64 GB of RAM
|
kkyzir@954
|
176 # contact us to find out!
|
kkyzir@954
|
177
|
charnik@969
|
178 3. Apply all changes by executing
|
kkyzir@954
|
179
|
kkyzir@954
|
180 $ sudo sysctl -p
|
kkyzir@954
|
181 $ sudo /etc/init.d/postgresql restart
|
kkyzir@954
|
182
|
kkyzir@954
|
183 4. Prepare for the next run by issuing the command
|
kkyzir@954
|
184
|
kkyzir@954
|
185 $ sudo -u postgres psql -c 'VACUUM ANALYZE;' db
|
kkyzir@954
|
186
|
kkyzir@954
|
187 or
|
kkyzir@954
|
188
|
kkyzir@954
|
189 $ psql -c 'VACUUM ANALYZE;' db
|
kkyzir@954
|
190
|
kkyzir@954
|
191 where db is the name of the Postgres database that Strabon will use.
|
kkyzir@954
|
192
|
charnik@211
|
193
|
charnik@211
|
194 Developer Guide
|
charnik@211
|
195 ~~~~~~~~~~~~~~~
|
charnik@211
|
196 Assuming that you are familiar with Maven, the following steps need to be
|
charnik@211
|
197 followed in order to use Strabon using Eclipse:
|
charnik@211
|
198
|
charnik@211
|
199 1. Install PostgreSQL from http://www.postgresql.org/download/. At the time of
|
charnik@211
|
200 this writing the latest PostgreSQL version is 9.1.
|
charnik@211
|
201 2. Install PostGIS from http://postgis.refractions.net/download/. At the time of
|
charnik@211
|
202 this writing we have tested Strabon with PostGIS 1.5.3.
|
charnik@211
|
203 3. Install Maven from http://maven.apache.org/download.html. At the time of this
|
charnik@211
|
204 writing the latest Maven version is 3.0.4.
|
charnik@211
|
205 4. Install Eclipse from http://www.eclipse.org/downloads/. At the time of this
|
charnik@211
|
206 writing the latest Eclipse version is 3.7.2.
|
charnik@211
|
207 5. Install the m2e plugin for Eclipse from http://www.eclipse.org/m2e/.
|
charnik@211
|
208 6. Install the MercurialEclipse plugin for Eclipse from
|
charnik@211
|
209 http://javaforge.com/project/HGE.
|
charnik@211
|
210 7. From Eclipse, go to File --> Import --> Mercurial --> Clone Existing
|
charnik@211
|
211 Mercurial Repository --> Next. In the URL textarea paste the following
|
charnik@211
|
212 URL: http://hg.strabon.di.uoa.gr/Strabon and then press Next --> Next -->
|
charnik@211
|
213 Finish. If you used the default settings, you should have a new project named
|
charnik@211
|
214 StrabonMain. Right click on the project and select Configure --> Convert to
|
charnik@211
|
215 Maven project. Eclipse will enable Maven dependency management for the
|
charnik@211
|
216 project, download any dependencies and build the project.
|
charnik@211
|
217
|
charnik@211
|
218
|
charnik@211
|
219 Storing stRDF graphs and evaluating stSPARQL queries
|
charnik@211
|
220 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
charnik@211
|
221 You can see some examples in the classes
|
charnik@211
|
222 eu.earthobservatory.runtime.postgis.StoreOp and
|
charnik@211
|
223 eu.earthobservatory.runtime.postgis.QueryOp.
|
charnik@211
|
224
|
charnik@211
|
225
|
charnik@211
|
226 Download
|
charnik@211
|
227 ========
|
charnik@211
|
228 You can download the source code of the latest version of Strabon by accessing
|
charnik@211
|
229 our public mercurial repository located at http://hg.strabon.di.uoa.gr/Strabon.
|
charnik@211
|
230 You can find more information on how to use and extend Strabon at the Getting
|
charnik@211
|
231 Started section.
|
charnik@211
|
232
|
charnik@211
|
233
|
charnik@211
|
234 Publications
|
charnik@211
|
235 ============
|
charnik@211
|
236 You can learn about stRDF data model and stSPARQL query language employed in
|
charnik@211
|
237 Strabon by reading our tutorial under the Getting Started section and/or the
|
charnik@211
|
238 publications given on this page.
|
charnik@211
|
239
|
charnik@211
|
240 The current versions of stRDF and stSPARQL which are based on OGC standards are
|
charnik@211
|
241 presented in the following document:
|
charnik@554
|
242 * K. Kyzirakos, M. Karpathiotakis, and M. Koubarakis. Strabon: A Semantic
|
charnik@554
|
243 Geospatial DBMS. In Internatioanl Semantic Web Conference (ISWC'12). Boston,
|
charnik@554
|
244 USA, November 11-15, 2012.
|
charnik@554
|
245 [pdf: http://strabon.di.uoa.gr/files/strabon-iswc.pdf]
|
charnik@554
|
246
|
charnik@211
|
247 * Manolis Koubarakis, Kostis Kyzirakos, Babis Nikolaou, Michael Sioutis, and
|
charnik@211
|
248 Stavros Vassos. A data model and query language for an extension of RDF with
|
charnik@211
|
249 time and space. Deliverable D2.1, European ICT project TELEIOS, 2011.
|
charnik@211
|
250 [pdf: http://strabon.di.uoa.gr/files/deliv2-1-re-revised.pdf]
|
charnik@211
|
251
|
charnik@211
|
252 The initial versions of stRDF and stSPARQL that are based on constraint
|
charnik@211
|
253 databases are presented in the following publications:
|
charnik@211
|
254 * Manolis Koubarakis and Kostis Kyzirakos. Modeling and Querying Metadata in
|
charnik@211
|
255 the Semantic Sensor Web: the Model stRDF and the Query Language stSPARQL.
|
charnik@211
|
256 In 7th Extended Semantic Web Conference (ESWC 2010). Heraklion, Crete,
|
charnik@211
|
257 30 May - 03 June, 2010.
|
charnik@211
|
258 [pdf: http://strabon.di.uoa.gr/files/stSPARQL.pdf]
|
charnik@211
|
259
|
charnik@211
|
260 * Kostis Kyzirakos, Manos Karpathiotakis and Manolis Koubarakis. Developing
|
charnik@211
|
261 Registries for the Semantic Sensor Web using stRDF and stSPARQL (short
|
charnik@211
|
262 paper).
|
charnik@211
|
263 In Proceedings of 3rd International workshop on Semantic Sensor Networks
|
charnik@211
|
264 2010, in conjunction with ISWC 2010, November 2010, Shanghai, China.
|
charnik@211
|
265 [pdf: http://strabon.di.uoa.gr/files/strabon.pdf]
|
charnik@211
|
266
|
charnik@211
|
267 Applications of stRDF, stSPARQL, and the system Strabon are described here:
|
charnik@211
|
268 * Alasdair J. G. Gray, Raúl García-Castro, Kostis Kyzirakos, Manos
|
charnik@211
|
269 Karpathiotakis, Jean-Paul Calbimonte, Kevin Page, Jason Sadler, Alex
|
charnik@211
|
270 Frazer, Ixent Galpin, Alvaro A. A. Fernandes, Norman W. Paton, Oscar
|
charnik@211
|
271 Corcho, Manolis Koubarakis, David De Roure, Kirk Martinez and Asunción
|
charnik@211
|
272 Gómez-Pérez. A Semantically Enabled Service Architecture for Mashups over
|
charnik@211
|
273 Streaming and Stored Data. In 8th Extended Semantic Web Conference (ESWC
|
charnik@211
|
274 2011). Heraklion, Crete, May 20 - June 2, 2011.
|
charnik@211
|
275 [pdf: http://strabon.di.uoa.gr/files/Gray2011Architecture.pdf]
|
charnik@211
|
276
|
charnik@211
|
277 * A.J.G. Gray, J. Sadler, O. Kit, K. Kyzirakos, M. Karpathiotakis, J.-P.
|
charnik@211
|
278 Calbimonte, K. Page, R. García-Castro, A. Frazer, I. Galpin, A.A.A.
|
charnik@211
|
279 Fernandes, N.W. Paton, O. Corcho, M. Koubarakis, D.D. Roure, K. Martinez,
|
charnik@211
|
280 A. Gómez-Pérez. A Semantic Sensor Web for Environmental Decision Support
|
charnik@211
|
281 Applications. Sensors. 11, 8855-8887.
|
charnik@211
|
282 [pdf: http://strabon.di.uoa.gr/files/sensors-11-08855.pdf]
|
charnik@211
|
283
|
charnik@211
|
284 Coming up soon:
|
charnik@211
|
285 Strabon will soon support an extension of RDF for incomplete geospatial
|
charnik@211
|
286 information. The following publication gives a preview of the relevant research
|
charnik@211
|
287 problems:
|
charnik@211
|
288 * M. Koubarakis, K. Kyzirakos, M. Karpathiotakis, C. Nikolaou, M. Sioutis,
|
charnik@211
|
289 S. Vassos, D. Michail, T. Herekakis, C. Kontoes and I. Papoutsis. Challenges
|
charnik@211
|
290 for Qualitative Spatial Reasoning in Linked Geospatial Data. In Proceedings
|
charnik@211
|
291 of IJCAI 2011 Workshop on Benchmarks and Applications of Spatial Reasoning,
|
charnik@211
|
292 Barcelona, Spain.
|
charnik@212
|
293 [pdf: http://www.earthobservatory.eu/publications/SciQL_ADASS2011.pdf]
|
charnik@211
|
294
|
charnik@812
|
295 * C. Nikolaou and M. Koubarakis: "Querying Linked Geospatial Data with
|
charnik@812
|
296 Incomplete Information". In 5th International Terra Cognita Workshop -
|
charnik@812
|
297 Foundations, Technologies and Applications of the Geospatial Web. In
|
charnik@812
|
298 conjunction with the 11th International Semantic Web Conference, Boston,
|
charnik@812
|
299 USA, November, 2012.
|
charnik@812
|
300 [http://www.earthobservatory.eu/publications/iswc-workshop.pdf]
|
charnik@812
|
301
|
charnik@211
|
302
|
charnik@211
|
303 Contributors
|
charnik@211
|
304 ============
|
charnik@211
|
305 The system Strabon has been developed by the following members of our team:
|
charnik@211
|
306
|
charnik@211
|
307 * Manos Karpathiotakis <mk@di.uoa.gr>
|
charnik@211
|
308 * Kostis Kyzirakos <kkyzir@di.uoa.gr>
|
charnik@211
|
309 * Manolis Koubarakis <koubarak@di.uoa.gr>
|
charnik@211
|
310 * Giorgos Garbis <ggarbis@di.uoa.gr>
|
charnik@211
|
311 * Konstantina Bereta <konstantina.bereta@di.uoa.gr>
|
kkyzir@639
|
312 * Charalampos Nikolaou <charnik@di.uoa.gr>
|
kkyzir@639
|
313 * Stella Gianakopoulou <sgian@di.uoa.gr>
|
kkyzir@639
|
314 * Panagiotis Smeros <psmeros@di.uoa.gr>
|
kallirroi@902
|
315 * Kallirroi Dogani <kallirroi@di.uoa.gr>
|
charnik@211
|
316
|
charnik@211
|
317
|
charnik@211
|
318 Mailing-list
|
charnik@211
|
319 ============
|
kkyzir@954
|
320 Currently, we maintain the following mailing lists:
|
kkyzir@954
|
321
|
kkyzir@954
|
322 * Strabon-users, is used as a communication channel for Strabon users.
|
kkyzir@954
|
323 To subscribe to the mailing-list, please visit page
|
kkyzir@954
|
324 http://cgi.di.uoa.gr/~mailman/listinfo/strabon-users. To post e-mails
|
kkyzir@954
|
325 to Strabon-users mailing-list, write to strabon-users@di.uoa.gr.
|
kkyzir@954
|
326
|
kkyzir@954
|
327 * Strabon-devel, is used as a communication channel with the developers
|
kkyzir@954
|
328 of Strabon. To subscribe to the mailing-list, please visit page
|
kkyzir@954
|
329 http://cgi.di.uoa.gr/~mailman/listinfo/strabon-devel. To post e-mails
|
kkyzir@954
|
330 to Strabon-devel mailing-list, write to strabon-devel@di.uoa.gr.
|
charnik@211
|
331
|
charnik@211
|
332
|
charnik@211
|
333 Bugs
|
charnik@211
|
334 ====
|
charnik@211
|
335 Please report bugs to http://bug.strabon.di.uoa.gr/report or
|
charnik@211
|
336 the Strabon-devel mailing-list Strabon-devel@di.uoa.gr.
|
charnik@212
|
337
|
charnik@212
|
338
|
sgian@627
|
339 Known Issues
|
sgian@627
|
340 ============
|
charnik@846
|
341 * By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs received
|
charnik@846
|
342 from a browser. This can cause problems when encoding is UTF-8, and you are using
|
charnik@846
|
343 international characters. In order to fix this, edit conf/server.xml and find the
|
charnik@846
|
344 line where the Connector is defined. Add the parameter URIEncoding and set it to
|
charnik@846
|
345 UTF-8. For example:
|
sgian@627
|
346
|
charnik@846
|
347 <Connector port="8080" protocol="HTTP/1.1"
|
charnik@846
|
348 connectionTimeout="20000"
|
charnik@846
|
349 URIEncoding="UTF-8"
|
charnik@846
|
350 redirectPort="8443" />
|
charnik@846
|
351
|
charnik@846
|
352 * Building and executing any maven goals fails for maven versions <3.0 due to a
|
charnik@846
|
353 dependency to the `shade' plugin that is available only for maven version 3.0
|
charnik@846
|
354 (http://maven.apache.org/plugins/maven-shade-plugin/). In such systems, you may
|
charnik@846
|
355 disable execution of this plugin by setting the environmental variable
|
charnik@846
|
356 `shade.skip'. For example, to build Strabon using maven version 2.0 you may
|
charnik@846
|
357 execute the following command:
|
charnik@846
|
358
|
charnik@846
|
359 $ mvn clean package -Dshade.skip
|
sgian@627
|
360
|
sgian@967
|
361 * When using MonetDB as a backend, the following source code of MonetDB must be
|
sgian@967
|
362 used:
|
sgian@967
|
363 https://hg.strabon.di.uoa.gr/MonetDB/
|
sgian@967
|
364
|
sgian@627
|
365
|
charnik@212
|
366 License
|
charnik@212
|
367 =======
|
charnik@553
|
368 This Source Code Form is subject to the terms of the Mozilla Public
|
charnik@553
|
369 License, v. 2.0. If a copy of the MPL was not distributed with this
|
charnik@553
|
370 file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
charnik@553
|
371
|
charnik@553
|
372 Copyright (C) 2010, 2011, 2012, Pyravlos Team
|
charnik@553
|
373
|
charnik@553
|
374 http://www.strabon.di.uoa.gr/
|
charnik@553
|
375
|
charnik@553
|
376
|
charnik@553
|
377 How to apply the license
|
charnik@553
|
378 ========================
|
charnik@866
|
379 * In the beginning of script files (after the shell directive) paste the
|
charnik@866
|
380 following statement:
|
charnik@553
|
381 #
|
charnik@553
|
382 # This Source Code Form is subject to the terms of the Mozilla Public
|
charnik@553
|
383 # License, v. 2.0. If a copy of the MPL was not distributed with this
|
charnik@553
|
384 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
charnik@553
|
385 #
|
charnik@553
|
386 # Copyright (C) 2010, 2011, 2012, Pyravlos Team
|
charnik@553
|
387 #
|
charnik@553
|
388 # http://www.strabon.di.uoa.gr/
|
charnik@553
|
389 #
|
charnik@553
|
390
|
charnik@866
|
391 * In the beginning of Java source code files paste the following statement:
|
charnik@553
|
392 /**
|
charnik@553
|
393 * This Source Code Form is subject to the terms of the Mozilla Public
|
charnik@553
|
394 * License, v. 2.0. If a copy of the MPL was not distributed with this
|
charnik@553
|
395 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
charnik@553
|
396 *
|
charnik@553
|
397 * Copyright (C) 2010, 2011, 2012, Pyravlos Team
|
charnik@553
|
398 *
|
charnik@553
|
399 * http://www.strabon.di.uoa.gr/
|
charnik@553
|
400 */
|
charnik@553
|
401
|
charnik@866
|
402 * In the beginning of HTML/XML files paste the following statement:
|
charnik@553
|
403 <!-- This Source Code Form is subject to the terms of the Mozilla Public
|
charnik@553
|
404 - License, v. 2.0. If a copy of the MPL was not distributed with this
|
charnik@553
|
405 - file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
charnik@553
|
406 -
|
charnik@553
|
407 - Copyright (C) 2010, 2011, 2012, Pyravlos Team
|
charnik@553
|
408 -
|
charnik@553
|
409 - http://www.strabon.di.uoa.gr/
|
charnik@553
|
410 -->
|