D3web: How-To Create Your Own Workspace

This page (revision-111) was last changed on 29-Oct-2026 08:56 by Albrecht Striffler

This page was created on 14-Mar-2022 11:21 by Johanna Latt

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Pagination: Previous 1 2 3 4 56all (Total items: 111 )

Version	Date Modified	Size	Author	Changes ...	Change note
111	29-Oct-2026 08:56	5 KB	Albrecht Striffler	to previous	Note current JDK, Tomcat and Maven versions for the Eclipse guide
110	29-Oct-2026 08:56	5 KB	Albrecht Striffler	to previous \| to last	Require JDK 25 and Tomcat 11 for the current sources
109	14-Mar-2022 11:21	5 KB	Albrecht Striffler	to previous \| to last
108	14-Mar-2022 11:21	5 KB	Albrecht Striffler	to previous \| to last
107	14-Mar-2022 11:20	5 KB	Albrecht Striffler	to previous \| to last
106	14-Mar-2022 11:20	5 KB	Albrecht Striffler	to previous \| to last
105	14-Mar-2022 11:18	5 KB	Albrecht Striffler	to previous \| to last
104	14-Mar-2022 11:18	5 KB	Albrecht Striffler	to previous \| to last
103	14-Mar-2022 11:15	5 KB	Albrecht Striffler	to previous \| to last
102	14-Mar-2022 11:14	5 KB	Albrecht Striffler	to previous \| to last
101	14-Mar-2022 11:14	5 KB	Albrecht Striffler	to previous \| to last

Pagination: Previous 1 2 3 4 56all (Total items: 111 )

Page References

Incoming links	Outgoing links
How-To Create Your Own Workspace Getting Started How-To Create Your Own Workspace How-Tos	How-To Create Your Own Workspace Downloads Tutorial

Annotate

Version management

Difference between version and


1	1		[{TableOfContents}]
2	2
3	3
4	4
5	5
6	6
7	7		!!!IntelliJ IDEA
8	8
9	9		Please do also take a look at the [screencasts\|Tutorial] that show the set up of an IntelliJ workspace.
10	10
11	11		!!Prerequisites
12		−	* [Java Development Kit (JDK)\|https://adoptopenjdk.net/], we recommend the latest version of JDK 14, newer JDKs should work though.
13		−	* [Apache Tomcat 9\|https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.44/bin/apache-tomcat-9.0.44.zip]\\ Other version might work, but are not officially supported. We recommend to use the linked version 9.0.44. We are dependent on the compatibility with JSPWiki here.
	12	+	* [JDK 25\|https://adoptium.net/temurin/releases/?version=25], the version given on the [Downloads] page for the nightly build.
	13	+	* [Apache Tomcat 11\|https://tomcat.apache.org/download-11.cgi]\\ Since the migration to JSPWiki 3, KnowWE uses Jakarta EE ({{jakarta.servlet}}), so Tomcat 9 and 10 do not work with the current sources.
14	14		* [IntelliJ IDEA\|http://www.jetbrains.com/idea/download/index.html] \\ You might get a community key for the Ultimate Edition. Please ask via dev list.
15	15
16	16		!!First time starting IDEA

17	17
18	18		When you first start IDEA you can choose which plugins to enable/disable. Just leave everything enabled to be on the safe side.\\
19	19		After that choose "New Project" and then "Empty Project". Give it a name and hit "Ok".
20	20
21	21
22	22		!!Import Repositories
23	23
24		−	Clone the following git repositories into your Project folder
	24	+	Clone the following git repositories into your project folder
25	25
26		−	%%quote
27		−	{{https://github.com/denkbares/Commons.git}} \\
28		−	{{https://github.com/denkbares/d3web-Runtime.git}} \\
29		−	{{https://github.com/denkbares/d3web-KnowWE.git}} \\
30		−	/%
31	26
	27	+	* {{https://github.com/denkbares/Commons.git}} \\
	28	+	* {{https://github.com/denkbares/d3web-Runtime.git}} \\
	29	+	* {{https://github.com/denkbares/d3web-KnowWE.git}} \\
	30	+
32	31		In your IntelliJ project, for each repository, select "File -> New/Module from Existing Sources..." and select the path folder of the repository. When you get asked which module to import, choose "Import Module from external Model/Maven" and hit "Next". Other screens can also be confirmed with the default/next.
33	32
34	33		!! Create copy of jspwiki-custom.properties

35	34
36	35		KnowWE is based on JSPWiki and therefore needs an jspwiki-custom.properties to configure some basics. Copy the file {{KnowWE-App/src/resources/local/WEB-INF/classes/jspwiki-custom.properties.default}} into the same folder with the same name, but remove the suffix '.default'. For starters, you only need to set a the {{var.basedir}} to point to a wikicontent (folder with the wiki pages). If you don't have a wikicontent yet, you can start out with the one provided in the distribution from [Downloads#Latest Releases and Builds]. In the zip, extract {{/KnowWE/KnowWE-Tomcat.zip/wikicontent}} to the path you specified as the var.basedir in your jspwiki-custom.properties.
37	36
38	37		!!Building and starting KnowWE
39	38
40	39		Select Run -> 'Edit Configurations' and add 'Tomcat Server' -> local. Hit configure and choose your tomcat path. In den bottom pane click + and choose 'Build Artifacts'. Select 'KnowWE-App:war exploded'. Click on the 'Deployment' tab and add 'KnowWE-App:war exploded'. Select as Application Context /KnowWE and click on Ok. Build KnowWE by clicking on the green arrow right next to our new tomcat configuration.
41	40
42	41
43	42		!!!Eclipse
44	43
45	44		At denkbares, we currently don't use eclipse for the development of d3web-KnowWE, but it should work anyway and some users are successfully using it. Here a short guide from Alberto (aarmijo on github):
46	45
47		−	!! Set-up:
	46	+	__Note:__ This guide was written for JDK 14 and Tomcat 9. For the current sources use JDK 25, Tomcat 11 and Maven 3.9 or newer, and replace the versions in the steps below accordingly.
48	47
	48	+	!! Set-up
	49	+
49	50		* [Adoptium Temurin 17 JDK\|https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.2%2B8/OpenJDK17U-jdk_x64_windows_hotspot_17.0.2_8.msi]
50	51		* [Tomcat 9.0.26\|https://tomcat.apache.org/download-90.cgi]
51	52		* [Eclipse 2022-03\|https://www.eclipse.org/downloads/packages/release/2022-03/m2}
52	53		* [Maven 3.6.1. \|https://archive.apache.org/dist/maven/maven-3/] (The embedded maven in eclipse seems to have some issues when constraining the compilation to JDK14)
53	54
54		−	!! Instructions:
	55	+	!! Instructions
55	56
56	57		* Import d3web-KnowWE project as a Maven project. File -> Import -> Existing Maven Projects
57	58		* Window -> Preferences -> Java -> Installed JREs. Add Adoptium JDK and select it

58	59		* Make sure that the ‘JRE System Library’ of each maven project is set to ‘JavaSE-14’ compliance level. Also make sure that in maven project properties, the JDK compliance is limited to 14 in the ‘Java Compiler’ section
59	60		* In KnowWE-App project, under Maven Dependencies properties -> Use Maven Project settings -> Active Maven Profiles, set ‘core-plugins’ as active profile. This will copy the core dependencies to the KnowWE-App application when deploying it into Tomcat
60	61		* Under KnowWE-App project properties -> Java Build Path -> Source, add the next Folder: src/resources/local/WEB-INF/classes. This will copy the jspwiki.properties to the KnowWE-App application when deploying it into Tomcat. Also follow the ste [Create copy of jspwiki-custom.properties\|How-To Create Your Own Workspace#Create copy of jspwiki-custom.properties] of the IntelliJ-part of the guide.
61	62		* Add the run configuration to build the project: Run -> Run Configurations -> Double click on Maven Build to create a new configuration. Set the Base directory: ${workspace_loc:/KnowWE}; Goals: install; Profiles: core-plugins; Skip Tests. Under JRE -> Execution environment, select JavaSE-14. Select Maven Runtime -> External (It seems that EMBEDDED flavour is not well managed by Eclipse and the compilation is not constrained to version 14)
62	63		* Click Run to build the project
63	64		* Under the tab Servers, add a Tomcat9 web application server and select the location where you downloaded it. Add KnowWE-App as resource to the right ‘Configured’ section. Under Edit Server Runtime select as JRE the installed JDK 1.7.
64	65		* Click Start to launch the server. Open the application in http://localhost:8080/KnowWE-App
65	66
66	67		%%tags
67	68		howto create Workspace
68	69		%
69	70