Changeset 34683

Timestamp:

2021-01-20T18:14:32+13:00 (3 years ago)

Author:

davidb

Message:

Updated readme file

File:

• gs2-extensions/apache-jena/trunk/src/README.txt (modified) (1 diff)

gs2-extensions/apache-jena/trunk/src/README.txt

@@ -4 +4 @@
   ./CASCADE-MAKE.sh
 
-Note: Jena is a pure Java code base, and the relevant compiled jar
-      files are bundled with this extension, so no actual compilation
-      is needed.  The main task CASCADE-MAKE.sh does is to untar the
-      'binary' files, and setup them up in appropriate top-level '
-      lib' folder (for jar files) etc so Greenstone can find them
+
+For interative experiments with the Triplestore, you can then visit
+the home page:
+
+  http://localhost:3030/
+
+Go to the control panel:
+
+  http://localhost:3030/control-panel.tpl
+
+The control panel lets you choose which dataset to work with through a
+drop-down menu.  For the Greenstone extension installation there
+should only be one:
+
+  /greenstone
+
+Pressing 'select' triggers a POST action to:
+
+  http://localhost:3030/$/dataset
+  
+which triggers a redirect (through setting 'Location:' in the respose header) to:
 
 
-      In case it is ever needed, the companion source code is in 'src'
-      directory (taken from the Apache Jena website, matched to the binary
-      version).  For source code, there was only a zip version of the file
-      to download.
+  http://localhost:3030/sparql.tpl
 
-      To run the command-line client programs, such as 's-put', this
-      requires Ruby to be installed.  The source code for this is provided
-      in the 'packages' directory, and compiled up and installed as part of
-      running ./CASCADE-MAKE.sh
+
+A generic query to try out is:
+
+  select * where { ?s ?p ?o } limit 100
+
+
+#----
+# ReverseProxying
+#----
+
+If serving your Greenstone3 through a public facing web server, such as Apache2,
+then the installed '.tpl' files and the Location redirects don't work.  Introducing
+a base tag into the header such as:
+
+<base href="/greenstone3-lod/" />
+
+and changing the control-panel.tpl form action to be:
+
+ <form action="/greenstone3-lod/${action}" method="post">
+ 
+helps a bit, but the Location redirect is still an issue.
+
+Bottom-line to run a SPARQL query directly, (for localhost) you would do:
+
+  http://localhost:3030/greenstone/query?query=select+*+where+%7B+%3Fs+%3Fo+%3Fp+%7D+limit+100&output=text&stylesheet=
+
+For a proxied install you would (continuing the example) do:
+
+  http://sowemustthink.space/greenstone3-lod/greenstone/query?query=select+*+where+%7B+%3Fs+%3Fo+%3Fp+%7D+limit+100&output=text&stylesheet=
+  
+
+#----
+# Note about Jena code:
+#----
+
+  Jena is a pure Java code base, and the relevant compiled jar files
+  are bundled with this extension, so no actual compilation is needed.
+  The main task CASCADE-MAKE.sh does is to untar the 'binary' files,
+  and setup them up in appropriate top-level ' lib' folder (for jar
+  files) etc so Greenstone can find them
+
+  In case it is ever needed, the companion source code is in 'src'
+  directory (taken from the Apache Jena website, matched to the binary
+  version).  For source code, there was only a zip version of the file
+  to download.
+
+   To run the command-line client programs, such as 's-put', this
+   requires Ruby to be installed.  The source code for this is
+   provided in the 'packages' directory, and compiled up and installed
+   as part of running ./CASCADE-MAKE.sh