Skip to content

Commit f63b115

Browse files
committed
Documentation update for WapBasePath
1 parent bf3399c commit f63b115

File tree

2 files changed

+7
-1
lines changed

2 files changed

+7
-1
lines changed

howtos/configuration.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,5 @@ absorb: true
3030
| MultipleAnnotationPost | Is posting multiple annotations in one request possible. | true |
3131
| WapPort | The port under which the WAP service is reachable. This port is used for HTTP and HTTPS service. When 80 is set and a http service is used, the port is omitted. The same applies to HTTPS and port 443. This setting has influence on the root IRI and cannot be changed after a database has been created. For details refer to the Root Container section. | 80 |
3232
| RdfBackendImplementation | The qualifier of the used RDF backend implementation. The default backend is 'jena'. | jena |
33+
| WapBasePath | An override for the base URL. Only use to run behind proxy or in a container. | |
34+

howtos/root_container.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,10 @@ Example 4: Hostname=host1.example.org, EnableHttps=true, WapPort=443
2929
When using the installer (via --install or by starting the jar in an empty folder) it asks for this base configuration
3030
and shows its consequences on the root container IRI.
3131

32+
All of the above can be overwritten by using the `WapBasePath` property.
33+
This property is intended to be used only in scenarios where the server is reachable from a different URL
34+
and if this should or must be reflected in the database (reverse proxy, docker container).
35+
3236
If changing any of those parameters with an already running server is necessary, a deletion of the database is needed.
3337
It gets recreated on first startup after the configuration has been changed.
3438

@@ -38,6 +42,6 @@ It gets recreated on first startup after the configuration has been changed.
3842
Using manual database manipulation, a conversion of the database to fit the new root container IRI can be achieved,
3943
but this is not implemented in the application. The easiest way to achieve this would be to have the database
4044
been backed up to NQUADS (which retains the named graphs) and then run a simple text replacement of old IRI ==> new IRI.
41-
This has never been tested and should be regarded as a good starting point at best.
45+
Also see [data migration guide](https://github.com/kit-data-manager/wap-server/wiki/Migrating-a-Server-Instance-and-its-Data) for details.
4246

4347
---

0 commit comments

Comments
 (0)