D3web: D3web-KnowWE Quickstart

This page (revision-33) was last changed on 29-Oct-2026 09:42 by Albrecht Striffler

This page was created on 03-Feb-2017 22:26 by Albrecht Striffler

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Pagination: Previous 12all (Total items: 33 )

Version	Date Modified	Size	Author	Changes ...	Change note
33	29-Oct-2026 09:42	4 KB	Albrecht Striffler	to previous	Name Tomcat 9 for the releases up to 2026.7
32	29-Oct-2026 09:42	4 KB	Albrecht Striffler	to previous \| to last	Name JDK 25 for release 2026.7
31	29-Oct-2026 08:56	4 KB	Albrecht Striffler	to previous \| to last	Add upgrade note for the nightly build: wiki names in ACLs and groups, Tomcat 11
30	29-Oct-2026 08:55	4 KB	Albrecht Striffler	to previous \| to last	Name the bundled Tomcat version per release
29	16-Oct-2026 11:09	4 KB	Albrecht Striffler	to previous \| to last	Explain the open default policy, stricter shipped policies and the sample accounts to remove
28	16-Oct-2026 11:08	3 KB	Albrecht Striffler	to previous \| to last	Name JAVA_HOME and that the server is started from the bin folder, which locates wikicontent
27	16-Oct-2026 11:08	3 KB	Albrecht Striffler	to previous \| to last	Replace chmod 777 advice: the start scripts only lack the execute permission
26	16-Oct-2026 11:08	3 KB	Albrecht Striffler	to previous \| to last	Update system requirements: JDK per Downloads, current browsers
25	03-Feb-2017 22:26	3 KB	Albrecht Striffler	to previous \| to last
24	03-Feb-2017 22:26	3 KB	Albrecht Striffler	to previous \| to last
23	03-Feb-2017 22:23	3 KB	Albrecht Striffler	to previous \| to last
22	03-Feb-2017 22:23	3 KB	Albrecht Striffler	to previous \| to last
21	03-Feb-2017 22:22	3 KB	Albrecht Striffler	to previous \| to last

Pagination: Previous 12all (Total items: 33 )

Page References

Incoming links	Outgoing links
D3web-KnowWE Quickstart D3web-KnowWE - change wikicontent location Downloads KnowWE Tutorial	D3web-KnowWE Quickstart Downloads User FAQ Watney - Release Notes

Annotate

Version management

Difference between version and


1	1		KnowWE is a Semantic Wiki for the development of knowledge-based applications.
2	2
3	3
4	4		!!! System Requirements
5	5
6	6		Installation of KnowWE requires the __Java SE Development Kit (JDK)__ in the version given on the [Downloads] page (JDK 25 for the nightly build and the release 2026.7, JDK 17 for the releases 2026.3.1 and 2026.4.1). A JRE is not sufficient since the release [Watney\|Watney - Release Notes]. The distribution runs on Windows, macOS and Linux.
7	7		Use a current web browser, e.g. Chrome, Firefox, Edge or Safari.
8	8
9	9
10	10		!!! Installation
11	11
12	12		There are different distribution packages available for KnowWE. Older releases just provided the semantic wiki part of the d3web-KnowWE project (the folder {{KnowWE-Tomcat}} also referenced below). Since the release [Watney\|Watney - Release Notes], we switched to a more comprehensive distribution package, which also contains the core libraries of d3web (to embed and run d3web knowledge bases in your own software or app) and documentation and sources for both. So the downloadable zip file now contains the following folders:
13	13
14	14		* __d3web__ (Java libraries to embed and run d3web knowledge bases in your own software or app, also sources and documentation)
15	15		* __KnowWE__ (The wiki to create and test d3web knowledge bases, also sources and documentation)
16	16		* Licenses
17	17
18		−	To install KnowWE, just extract the downloaded distribution zip file to any location and then navigate to the folder KnowWE inside it. There, extract the file {{KnowWE-Tomcat.zip}} to the destination you want to run KnowWE from (like your program or application directory). Basically it is an Apache Tomcat ([http://tomcat.apache.org/]) web server (Tomcat 11 for the nightly build, Tomcat 9 for the releases 2026.3.1 and 2026.4.1), pre-configured with the KnowWE webapp.
	18	+	To install KnowWE, just extract the downloaded distribution zip file to any location and then navigate to the folder KnowWE inside it. There, extract the file {{KnowWE-Tomcat.zip}} to the destination you want to run KnowWE from (like your program or application directory). Basically it is an Apache Tomcat ([http://tomcat.apache.org/]) web server (Tomcat 11 for the nightly build, Tomcat 9 for the releases up to 2026.7), pre-configured with the KnowWE webapp.
19	19
20	20		\\Additional Notes:
21	21

22	22		* __Backup:__ If you are already using a previous version of KnowWE, move your old KnowWE folder to a different location first. Make sure that you are able to reuse the wiki articles you have created before.
23	23		* __wikicontent (optional):__ If you have used KnowWE before, you may copy your {{wikicontent}} directory to the unpacked {{KnowWE-Tomcat/wikicontent}} directory of the new installation.
24	24		* __Linux/Mac users:__ The zip file does not keep the execute permission of the start scripts. Set it once in the extracted folder with "{{chmod +x bin/*.sh}}".
25	25		* __Upgrading to the nightly build (JSPWiki 3):__ Users are now identified by their login name and their wiki name only (the full name without spaces, e.g. {{MaxMustermann}}). Page ACL entries and group members that name a user by the full name ({{Max Mustermann}}) no longer grant any permission; replace them by the wiki name. KnowWE shows editors a warning at ACL entries that do not take effect. To run the nightly build in your own Tomcat instead of the bundled one, you need Tomcat 11; Tomcat 9 and 10 do not work.
26	26
27	27
28	28		!!! Running
29	29
30	30		# __Java:__ Make sure the environment variable {{JAVA_HOME}} points to the JDK in the required version.
31	31		# __Start Tomcat server:__ In the extracted directory, navigate to the directory {{bin}} and start the server from there by calling the script {{startup.bat}} (MS-Windows) or {{./startup.sh}} (macOS/Linux). The wiki content folder is configured relative to the directory the server is started from ({{var.basedir = ../wikicontent}}), so start it from {{bin}}.
32	32		# __Surf:__ Open your web browser and enter the link {{http://localhost:8080/KnowWE/}}
33	33
34	34
35	35		!!! Configuration
36	36
37	37		JSPWiki (on which KnowWE is build) provides the configuration file {{jspwiki-custom.properties}}, which can be used to configure stuff like the folder of the wiki files, templates, application name, and more. See [https://jspwiki-wiki.apache.org/Wiki.jsp?page=Configuration] for more information.\\
38	38		\\
39	39		%%quote
40	40		{{KnowWE-Tomcat/webapps/KnowWE/WEB-INF/classes/jspwiki-custom.properties}}
41	41		/%
42	42
43	43
44	44		!!! Security
45	45
46	46		To manage wiki user and group rights, edit the file {{jspwiki.policy}}. See [https://jspwiki-wiki.apache.org/Wiki.jsp?page=Wiki.Admin.Security] for more information.\\
47	47		\\
48	48
49	49		%%quote
50	50		{{KnowWE-Tomcat/webapps/KnowWE/WEB-INF/jspwiki.policy}}
51	51		/%
52	52
53	53		The default policy is meant for a local installation: everyone may view, edit, rename and delete pages. Before others can reach the wiki:
54	54		* Select a stricter policy shipped in the same folder by setting {{jspwiki.policy.file}} in {{jspwiki-custom.properties}}: {{jspwiki-readonly.policy}} (everyone may read, logged-in users edit), {{jspwiki-authonly.policy}} (only logged-in users read and edit) or {{jspwiki-authonly-roles.policy}} (logged-in users read, members of the group ''Editor'' edit).
55	55		* Let an admin approve new accounts, since everyone can register: {{jspwiki.approver.workflow.createUserProfile = Admin}} in {{jspwiki-custom.properties}}.
56	56		* Remove the sample accounts of the distribution: delete their entries from {{wikicontent/userdatabase.xml}} and from the group ''Admin'' in {{wikicontent/groupdatabase.xml}}, then set up your own admin as described in the [User FAQ].
57	57