source: gs2-extensions/apache-jena/trunk/src/README.txt@ 34683

Last change on this file since 34683 was 34683, checked in by davidb, 3 years ago

Updated readme file

File size: 2.3 KB
Line 
1
2Installation of this extension follows the usual pattern:
3
4 ./CASCADE-MAKE.sh
5
6
7For interative experiments with the Triplestore, you can then visit
8the home page:
9
10 http://localhost:3030/
11
12Go to the control panel:
13
14 http://localhost:3030/control-panel.tpl
15
16The control panel lets you choose which dataset to work with through a
17drop-down menu. For the Greenstone extension installation there
18should only be one:
19
20 /greenstone
21
22Pressing 'select' triggers a POST action to:
23
24 http://localhost:3030/$/dataset
25
26which triggers a redirect (through setting 'Location:' in the respose header) to:
27
28
29 http://localhost:3030/sparql.tpl
30
31
32A generic query to try out is:
33
34 select * where { ?s ?p ?o } limit 100
35
36
37#----
38# ReverseProxying
39#----
40
41If serving your Greenstone3 through a public facing web server, such as Apache2,
42then the installed '.tpl' files and the Location redirects don't work. Introducing
43a base tag into the header such as:
44
45<base href="/greenstone3-lod/" />
46
47and changing the control-panel.tpl form action to be:
48
49 <form action="/greenstone3-lod/${action}" method="post">
50
51helps a bit, but the Location redirect is still an issue.
52
53Bottom-line to run a SPARQL query directly, (for localhost) you would do:
54
55 http://localhost:3030/greenstone/query?query=select+*+where+%7B+%3Fs+%3Fo+%3Fp+%7D+limit+100&output=text&stylesheet=
56
57For a proxied install you would (continuing the example) do:
58
59 http://sowemustthink.space/greenstone3-lod/greenstone/query?query=select+*+where+%7B+%3Fs+%3Fo+%3Fp+%7D+limit+100&output=text&stylesheet=
60
61
62#----
63# Note about Jena code:
64#----
65
66 Jena is a pure Java code base, and the relevant compiled jar files
67 are bundled with this extension, so no actual compilation is needed.
68 The main task CASCADE-MAKE.sh does is to untar the 'binary' files,
69 and setup them up in appropriate top-level ' lib' folder (for jar
70 files) etc so Greenstone can find them
71
72 In case it is ever needed, the companion source code is in 'src'
73 directory (taken from the Apache Jena website, matched to the binary
74 version). For source code, there was only a zip version of the file
75 to download.
76
77 To run the command-line client programs, such as 's-put', this
78 requires Ruby to be installed. The source code for this is
79 provided in the 'packages' directory, and compiled up and installed
80 as part of running ./CASCADE-MAKE.sh
81
82
83
84
85
Note: See TracBrowser for help on using the repository browser.