OpenSILEX installation cheatsheet
Prerequisite
Required operating system : Linux. Suggested Linux distribution: Ubuntu 16.04 LTS.
Environment:
Web servers:
- Tomcat 9.0 Java Servlet Container
- Apache 2.4 HTTP Server
Database management systems:
- MongoDB 4.0 for noSQL databases
- PostgreSQL 9.5 for SQL databases
- PostGIS 2.2 (minimal PostGIS version)
- RDF4J 2.4.5 for triplestores
OpenSILEX Databases
PostgreSQL
CREATE DATABASE opensilex OWNER opensilex;
CREATE EXTENSION postgis;
select postgis_full_version();
\q
import dump:
psql -U opensilex opensilex < Documents/opensilex_st_dump.sql
Rdf4J
Create repository :
- Type : Native Java Store
- ID : opensilex
- Title : opensilex Import ontologies :
- OESO :
- Downloadable on Github : https://github.com/OpenSILEX/ontology-vocabularies (latest release)
- URI of the context : http://www.opensilex.org/vocabularies/oeso
- OEEV :
- Downloadable on Github : https://github.com/OpenSILEX/ontology-vocabularies (latest release)
- URI of the context : http://www.opensilex.org/vocabularies/oeev
- OA :
- Downloadable on : http://www.w3.org/ns/oa.rdf
- URI of the context : http://www.w3.org/ns/oa
MongoDB
Create an opensilex database (optionnal).
OpenSILEX web service configurations
The source code is available at https://github.com/OpenSILEX/phis-ws/releases. Use the following command line to download the latest release:
git clone --branch 3.2.4 https://github.com/OpenSILEX/phis-ws.git
MongoDB configuration
mongo.host=localhost
mongo.port=27017
mongo.db=opensilex
PostgreSQL configuration
pg.host=localhost
pg.port=5432
pg.db=opensilex
pg.user=username
pg.password=password
RDF4J Configuration
# Base of the generated URIs - can be personalized:
rdf.base.uri=http://www.opensilex.org/
# RDF4J localisation and repository ID:
rdf.host=localhost
rdf.port=8080
rdf.path=rdf4j-server
rdf.repo=opensilex
# Managed infrastructure - can be personalized:rdf.infra=opensilex
# 3 letters code for the infrastructure:
rdf.infra.code=OSX
# Context of the vocabulary. Oeso by default:
rdf.vocabulary.context=http://www.opensilex.org/vocabulary/oeso
Others configurations
# Logs repertory. You need to create this directory
# (do not forget the access rights!)
ws.log.dir=/home/training/opensilex/logs
# The web service url access will be:
# http://{ws.host}:{ws.port}/{ws.target}/{ws.baseUrl}
ws.host=localhost
ws.port=8080
# Name of the application - can be personalized in the pom.xml file
ws.target=opensilex
ws.baseUrl=rest
ws.doc.host=localhost
ws.doc.port=8080
ws.doc.name=opensilex
ws.pageSize.max=2097152
ws.updir.host=opensilex
ws.updir.user=username
ws.updir.password=password
# Files storage directory (do not forget the access rights)
ws.updir.doc=/home/training/opensilex/documents/{rdf.infra}
# Images storage directory (do not forget the access rights)
ws.images.dir=/var/www/html/images
ws.images.url=http://localhost/images
ws.layers.dir=/var/www/html/layers
ws.layers.url=http://localhost/layers
OpenSILEX webapp configurations
The source code is available at https://github.com/OpenSILEX/phis-webapp/releases
Use the following command line to download the latest release:
git clone --branch 3.2.4 https://github.com/OpenSILEX/phis-webapp.git
Change webapp files group to allow apache to read them:
chown -R training:www-data /home/training/opensilex/phis-webapp
config/web_services.php
// http://{ws.host}:{ws.port}/{ws.target}/{ws.baseUrl}/
define('WS_PHIS_PATH', 'http://localhost:8080/opensilex/rest/');
// http://{ws.host}:{ws.port}/{ws.name}
define('WS_PHIS_PATH_DOC', 'http://localhost:8080/opensilex');
config/config.php
# Application name, accessible at the URL http://$hostname/$appli
$appli = 'opensilex';
$hostname = 'localhost';
config/params.php
'platform' => 'Demo'
index.php
<meta http-equiv="refresh" content="0;URL=http://localhost/phis/web">