KnowWE is a Semantic Wiki for the development of knowledge-based applications.


!!! System Requirements

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+ and Safari should both work fine.


!!! Installation

The binary distribution comes as a packaged installation, including Apache Tomcat 8.0.9 ([http://tomcat.apache.org/|http://tomcat.apache.org/]) and JSPWiki 2.10 ([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.

Additional Notes:

* __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.
* __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.
* __Windows users:__ Please be aware to set the system variable for Java before starting KnowWE: Set JRE_HOME for an installed JRE or 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 *}}".


!!! Running

# __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)
# __Surf:__ Open your web browser and enter the link {{http://localhost:8080/KnowWE/}}


!!! Configuration

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}}
/%

\\
\\
\\
\\


!!! 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.\\
\\

%%quote 
{{KnowWE-Tomcat/webapps/KnowWE/WEB-INF/jspwiki.policy}}
/%