Strabon

annotate README @ 1031:baf571343765

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