This page (revision-25) was last changed on 03-Feb-2017 22:26 by Albrecht Striffler

This page was created on 08-Nov-2013 10:12 by Albrecht Striffler

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
25 03-Feb-2017 22:26 3 KB Albrecht Striffler to previous
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

Page References

Incoming links Outgoing links

Version management

Difference between version and

At line 6 changed 2 lines
Installation of KnowWE requires the __Java SE Development Kit (JDK)__ in version 8 or newer. A JRE is not sufficient since the release [Watney|Watney - Release Notes]. For operating systems, the distribution runs with Windows, Mac OS, and Linux.
We officially support Firefox 3.6 or higher and Google Chrome. Currently, the Internet Explorer and Safari is not officially supported, although Internet Explorer 11/Edge and Safari should work fine.
Installation of KnowWE requires the Java Platform, JRE 8 or higher. KnowWE runs on Windows, Mac OSX, and Linux.
We support Firefox (3.6 or higher) and Google Chrome. Currently, the Internet Explorer is not officially supported but IE 11 should work fine.
At line 12 changed one line
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:
The binary distribution comes as a packaged installation, including Apache Tomcat ([http://tomcat.apache.org/|http://tomcat.apache.org/]) and JSPWiki ([http://www.jspwiki.org|http://www.jspwiki.org]).\\
Just unzip the package and copy the resulting folder to your desired location. You are then ready to start KnowWE.
At line 14 changed 3 lines
* __d3web__ (Java libraries to embed and run d3web knowledge bases in your own software or app, also sources and documentation)
* __KnowWE__ (The wiki to create and test d3web knowledge bases, also sources and documentation)
* Licenses
Additional Notes:
At line 18 changed one line
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, pre-configured with the KnowWE webapp.
* __Backup:__ If you are using a previous version of KnowWE, then move your KnowWE folder to a different location. Make sure that you are able to reuse the wiki articles you have created before.
* __Content (optional):__ If you have used KnowWE before, you may copy your {{wikicontent}} directory to the unpacked {{KnowWE-Tomcat/wikicontent}} directory of the new installation.
* __Windows users:__ Please be aware to set the system variable for Java before starting KnowWE: Set JRE_HOME for an installed JRE and JAVA_HOME for an installed JDK to the folder of the Java installation.
* __Linux/Mac users:__ When unpacking the KnowWE-Tomcat archive, sometimes the user rights are not correctly set. In this case, you may simply add read/write access to the entire KnowWE-Tomcat folder (including sub-directories), for instance by "{{chmod -R 777 *}}".
At line 20 removed one line
\\Additional Notes:
At line 22 changed 3 lines
* __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.
* __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.
* __Linux/Mac users:__ When unpacking the KnowWE-Tomcat zip file, sometimes the user rights are not correctly set. In this case, you may simply add read/write access to the entire KnowWE-Tomcat folder (including sub-directories), for instance by "{{chmod -R 777 *}}".
!!! Running KnowWE
At line 26 changed 4 lines
!!! Running
# __Start Tomcat server:__ In the extracted directory, navigate to the directory {{bin}} and start the server by calling the script {{startup.bat}} (MS-Windows) or {{startup.sh}} (Mac OS X/Linux)
# __Start server:__ In the unpacked directory, enter the directory {{bin}} and start the server by calling the script {{startup.bat}} (MS-Windows) or {{startup.sh}} (Mac OS X/Linux)
At line 35 changed 5 lines
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.\\
\\
%%quote
{{KnowWE-Tomcat/webapps/KnowWE/WEB-INF/classes/jspwiki-custom.properties}}
/%
The standard KnowWE installation comes with the standard file provider, that does not support version control of the wiki content.
You can change the file provider as well as other configurations (e.g., the folder of the wiki content, the encoding, or the style templates) in the file
At line 41 removed 6 lines
!!! Security
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.\\
\\
At line 48 changed one line
{{KnowWE-Tomcat/webapps/KnowWE/WEB-INF/jspwiki.policy}}
{{KnowWE/webapps/KnowWE/WEB-INF/jspwiki.properties}}
At line 37 added 2 lines
Use a standard text editor to modify the file.