GWiki Install Tutorial

Project Structur:

GWiki is fully mavenized, so you need Maven to build the projects.

GWiki is devided in five subprojects:

Name	Description	Dependencies of the other subprojects
gwiki-parent	contains the parent pom.xml which includes the global configuration like versionnummer and deployment repository.	none
gwiki-genome-dependencies	Contains the required classes for Genome.	gwiki-parent
gwiki	The main project. Contains all to build the *.jar zu bauen!	gwiki-genome-dependencies
gwiki-webapp	The webproject which is needed to build a *.war file and to start GWiki out of Eclipse.	gwiki
gwiki-standalone	A Java Project to create a standalone version of GWiki	gwiki

Installation steps

Check out all necessary projects and use Maven to build them:

Run "mvn install" on the projects in this order:

gwiki-genome-dependencies
gwiki-parent.
gwiki
gwiki-webapp

If problems appear try to update the project configuration too.

To build the *.jar or *.war files run "mvn package" on the gwiki-genome-dependencies, gwiki or gwiki-webapp projects.

Starting the webapp

You need a Apache Tomcat Webserver (or any other servlet container) to run the webapp.
Edit the servers server.xml file and put the gwiki-webapp project in there. Here is an example configuration:

server.xml

<?xml version="1.0" encoding="UTF-8"?>


  <Listener SSLEngine="on" className="org.apache.catalina.core.AprLifecycleListener"/>
  <Listener className="org.apache.catalina.core.JasperListener"/>
  <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"/>
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>

  <GlobalNamingResources>

    <Resource auth="Container" description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory" name="UserDatabase"
pathname="conf/tomcat-users.xml" type="org.apache.catalina.UserDatabase"/>
  </GlobalNamingResources>


  <Service name="Catalina">

    <Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"/>
    <Connector SSLEnabled="true" clientAuth="false" maxThreads="150" port="8443"
protocol="HTTP/1.1" scheme="https" secure="true" sslProtocol="TLS"/>

    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>


    <Engine defaultHost="localhost" name="Catalina">

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>

      <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true"
xmlNamespaceAware="false" xmlValidation="false">

      <Context docBase="gwiki-webapp" path="/gwiki-webapp" reloadable="true"
 source="org.eclipse.jst.jee.server:gwiki-webapp"/></Host>
    </Engine>
  </Service>
</Server>

After you started the server, you can access GWiki under http://localhost:8081/index

GWiki Install Tutorial

Project Structur:

Installation steps

Starting the webapp

Labels