Skip to content
This repository was archived by the owner on Apr 22, 2022. It is now read-only.

Commit 4fec952

Browse files
committed
update readme and some log removed
1 parent f519dfa commit 4fec952

File tree

4 files changed

+40
-29
lines changed

4 files changed

+40
-29
lines changed

README.md

Lines changed: 29 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,57 +2,67 @@
22

33
The GeoKnow Generator provides workbench that integrates of tools developed within [GeoKnow project](http://geoknow.eu/), and are part of the [Linked Data Stack](http://stack.linkeddata.org/). These workbench aim to provide the required methods and tools to easly integrate and process geospatial data across a wide range of data sources on the web of data.
44

5+
### Requirements
6+
7+
* [Virtuoso 7.1](https://github.com/openlink/virtuoso-opensource) triple store is required for most of the GeoKnow software tools integrated in this Workbench.
8+
* [Spring-batch-admin-generatror](https://github.com/GeoKnow/spring-batch-admin). For the moment this is required only for LIMES-Service in order to perform batch jobs, but it is planned to migrate some other coponents to be executed using this tool.
9+
10+
511
## Install
612

713
* __From Debian package__: The GeoKnow Generator UI is available as a debuian package, to install follow [these](http://stack.linkeddata.org/documentation/installation-of-a-local-generator-demonstrator/) instructions. This is a preconfigured application that assumes that a triple store is installed in the localhost.
8-
* __Form source__: Follow the configuration instructiobs below, and use `maven pacakge` to package the souces in a war file and deploy it on a servlet container.
14+
* __Form source__: Follow the configuration instructions below, and use `maven pacakge` to package the souces in a war file and deploy it on a servlet container.
915

10-
These option will not install any integrated component from the stack and you require to install each one. You can choose to use again Debian packages following [these](http://stack.linkeddata.org/documentation/installation-of-a-local-generator-demonstrator/) instructions, or manually visiting each developer's component installation guides.
16+
The Generator Workbencg will not install any integrated component from the stack and you require to install each one. You can choose to use again Debian packages following [these](http://stack.linkeddata.org/documentation/installation-of-a-local-generator-demonstrator/) instructions, or following instructions from each developer's component installation guides.
1117

1218
## Configuration
1319

14-
### Requirements
15-
16-
* Virtuoso 7.1 triple store and make sure to have a superuser created.
17-
1820
### Application configuration
1921

20-
1. Open the `src/main/resources/framework-configuration.ttl` and provide endpoints, users and password information in the lds:StorageService element. The lds:SecuredSPARQLEndPointService user will be automatically created in the setup.
22+
1. Open the `src/main/resources/framework-configuration-template.ttl` and provide for:
23+
24+
* GeoKnowGenerator foaf:homepage URL if the application is going to be accessed from a different place than the localhost,
25+
* VirtuosoConductor lds:serviceUrl, lds:user, lds:password and lds:connectionString,
26+
* VirtuosoAuthSPARQLEndpoint void:sparqlEndpoint, lds:serviceUrl, and desired user/password for the workbench user, wich will be created at setup.
27+
* VirtuosoEndpoint : void:sparqlEndpoint and lds:serviceUrl,
28+
* Admin foaf:mbox, which will belong to tha initial administrator user account. By default a admin user with password is created, and an email has to be provided in the configuration.
2129

2230
2. Open the `src/main/resources/framework-components.ttl` and make sure URLs for alll stack components are accurate.
2331

24-
2. Edit `src/main/webapp/WEB-INF/web.xml` and provide the ***REMOVED*** data.
32+
3. In order to let other users to register into the system, you need to edit `src/main/webapp/WEB-INF/web.xml` and provide the ***REMOVED*** data that is required for email notifications.
33+
34+
### Application Setup and Reset
2535

36+
To initalize the application the user is only required to navigate to the URL where the application has being deployed and a setup page will be shown.
2637

27-
Note that the endpoint has to support [UPDATE](http://www.w3.org/TR/2013/REC-sparql11-update-20130321/) service and [Graph Store HTTP Protocol](http://www.w3.org/TR/2013/REC-sparql11-http-rdf-update-20130321/)
28-
29-
### Application setup
38+
The application requires a system file at `/etc/generator/` (configured in the web.xml file), with write privileges for creating a init file that will be used as a flag for setting the system up.
39+
40+
The Setup process will create a system user in Virtuoso and the admininstrator user proviced in the configuration file. It will also create and add required information on the system graphs.
3041

31-
To initalize the application the user is only required to navigate to the URL where the application has being deployed and a setup page will be shown. The application requires a system file (e.g. `/etc/generator/`) with write privileges for creating a init file that will be used as a flag for setting the system up.
42+
To reset the application for taking into account a new configuration, you need to delete the file created in `/etc/generator/init.txt`, and navigate to the workbench url where the setup page will be shown. Make sure to select the reset checkbox in order to delete previous data.
3243

3344
### Virtuoso Endpoint
3445

3546
Currently ontly Virtuoso store is supported and it has being tested in version 7.1. The Generator makes use of Virtuoso users management to allow the creation of private graphs and allow them to grant access to to specific users.
3647

37-
## Optional Extra Configutation
48+
## Extra Configutation
3849

3950
Depending on the components you use in the Generator some extra configurations may be required.
4051

41-
42-
### Using OntoWiki-Virtuoso
43-
44-
In order that [OntoWiki](https://github.com/AKSW/OntoWiki) is able to access Virtuoso store, besides the installation of the OntoWiki-Virtuoso component you need to follow the instructions of OntoWiku using [Virtuoso Backend](https://github.com/AKSW/OntoWiki/wiki/VirtuosoBackend).
45-
46-
4752
## Issues
4853

54+
### Tomcat
4955
If some components are installed on the same tomcat server as the Generator, it is better to increase the Java Heap space. Edit the file /etc/default/tomcat7 and perform the following change.
5056

5157
# The original options look something like this:
5258
# JAVA_OPTS="-Djava.awt.headless=true -Xmx128m -XX:+UseConcMarkSweepGC"
5359

5460
JAVA_OPTS="-Djava.awt.headless=true -Xmx1g -XX:+UseConcMarkSweepGC"
5561

62+
### Using OntoWiki-Virtuoso
63+
64+
In order that [OntoWiki](https://github.com/AKSW/OntoWiki) is able to access Virtuoso store, besides the installation of the OntoWiki-Virtuoso component you need to follow the instructions of OntoWiku using [Virtuoso Backend](https://github.com/AKSW/OntoWiki/wiki/VirtuosoBackend).
65+
5666
## Licence
5767

5868
The source code of this repo is published under the Apache License Version 2.0

src/main/resources/framework-configuration-template.ttl

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
gkg:publicEndpoint :VirtuosoEndpoint ;
3030
gkg:authEndpoint :VirtuosoAuthSPARQLEndpoint ;
3131
lds:integrates :Virtuoso ;
32-
foaf:homepage <http://localhost:8080/generator> .
32+
foaf:homepage <http://** GENERATOR ***:8080/generator> .
3333

3434
:Virtuoso
3535
a lds:StackComponent ;
@@ -40,24 +40,24 @@
4040

4141
:VirtuosoConductor
4242
a lds:StorageService ;
43-
lds:password "***REMOVED***"^^xsd:string ;
44-
lds:serviceUrl <http://***REMOVED***:8890/conductor> ;
45-
lds:connectionString "jdbc:virtuoso://***REMOVED***:1111/"^^xsd:string;
46-
lds:user "***REMOVED***"^^xsd:string .
43+
lds:password "***Virtuoso Endpoint***"^^xsd:string ;
44+
lds:serviceUrl <http://***Virtuoso Endpoint***:8890/conductor> ;
45+
lds:connectionString "jdbc:virtuoso://***Virtuoso Endpoint***:1111/"^^xsd:string;
46+
lds:user "***Virtuoso Endpoint***"^^xsd:string .
4747

4848
:VirtuosoAuthSPARQLEndpoint
4949
a lds:SecuredSPARQLEndPointService, void:Dataset , gkg:SPARQLEndpoint , gkg:DataSource ;
5050
rdfs:label "Workbench Authenticated Endpoint" ;
5151
lds:password "***REMOVED***"^^xsd:string ;
52-
void:sparqlEndpoint <http://***REMOVED***:8890/sparql-auth> ;
53-
lds:serviceUrl <http://***REMOVED***:8890/sparql-auth> ;
52+
void:sparqlEndpoint <http://***Virtuoso Endpoint***:8890/sparql-auth> ;
53+
lds:serviceUrl <http://***Virtuoso Endpoint***:8890/sparql-auth> ;
5454
lds:user "***REMOVED***"^^xsd:string .
5555

5656
:VirtuosoEndpoint
5757
a lds:SPARQLEndPointService, void:Dataset , gkg:SPARQLEndpoint , gkg:DataSource ;
5858
rdfs:label "Workbench public Endpoint" ;
59-
lds:serviceUrl <http://***REMOVED***:8890/sparql> ;
60-
void:sparqlEndpoint <http://***REMOVED***:8890/sparql> .
59+
lds:serviceUrl <http://***Virtuoso Endpoint***:8890/sparql> ;
60+
void:sparqlEndpoint <http://***Virtuoso Endpoint***:8890/sparql> .
6161

6262

6363
# #######################################################################################

src/main/webapp/js/services/config.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -245,6 +245,7 @@ angular.module("app.configuration", [])
245245
+ "ORDER BY ?s ?p ?o",
246246
mode: "settings"
247247
};
248+
console.log(SETTINGS_GRAPH);
248249

249250
return $http.post("RdfStoreProxy", $.param(requestData)).then(function (response) {
250251
settings = parseSparqlResults(response.data);

src/main/webapp/js/workbench/linking-and-fusing/fagi-gis-controller.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ app.controller('FagiGisCtrl', function($q, $scope, ConfigurationService, GraphSe
6363
'&postgis-port='+ encodeURIComponent($scope.fagi.database.dbPort) +
6464
'&target-endpoint='+ encodeURIComponent(authEndpoint) +
6565
'&target-dataset='+ encodeURIComponent($scope.fagi.targetGraph.replace(':',ConfigurationService.getUriBase())) ;
66-
alert($scope.url);
66+
console.log($scope.url);
6767
});
6868
};
6969

0 commit comments

Comments
 (0)