header

Installation in 10 minutes

Looking for more?
With this variant all data will be exchanged in a crypted way. A small database ensures that no data will be lost.

Looking for more?
With this variant all data will be exchanged in a crypted way. A small database ensures that no data will be lost.

Own web-server with https, small data base

Java 1.6 and Tomcat 6.x are already installed. Follow these subsequent steps under Unix (Linux, Mac OS X etc.):

  1. Download the distribution ProjectForge-force-SSL-<version>.war
  2. Create ProjectForge.xml in conf/Catalina/localhost/ (see below) and modify data base account data if wanted.
  3. Copy the data base driver Hypersonic (Downloads) into the Tomcat lib directory.
  4. Deployment into Tomcat and re-start Tomcat if required.
  5. Call web site http://localhost:8080/ProjectForge/.
  6. Please follow the setup dialogue.
  7. Finished.

ProjectForge.xml

$CATALINA_BASE/conf/[enginename]/[hostname]/ProjectForge.xml:

<?xml version="1.0" encoding="UTF-8"?>
<Context path="" reloadable="false" debug="0" docBase="webapps" cookies="true">
  <Resource name="jdbc/ProjectForgeDS" type="javax.sql.DataSource" auth="Container" driverClassName="org.hsqldb.jdbcDriver"
    url="jdbc:hsqldb:${user.home}/ProjectForge/ProjectForgeTestDB" maxActive="100" maxIdle="30" maxWait="10000" username="sa" password="" />
  <Parameter name="base.dir" value="${user.home}/ProjectForge" override="false" />
  <Parameter name="hibernate.dialect" value="org.hibernate.dialect.HSQLDialect" override="false" />
  <Parameter name="hibernate.schemaUpdate" value="true" override="false" />
  <Parameter name="development" value="false" override="false" />
</Context>

Optional: run ProjectForge in root context

If the desire to run ProjectForge in the Tomcat&apos;s root context exists, then webapps/ROOT must be used as directory and ROOT.xml must be used instead of ProjectForge.xml.

Optional: configure https in the Tomcat if not already done:

  1. Create key store for https:
    keytool -genkey -keystore tomcat-localhost.keystore -alias tomcat -keyalg RSA -keysize 1024 -keypass changeit -storepass changeit
  2. Copy key store file to the Tomcat/conf/ directory.
  3. server.xml
    <Server port="8005" shutdown="SHUTDOWN">    
      <Service name="Catalina">
        <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
                   maxThreads="150" scheme="https" secure="true"
                   clientAuth="false" sslProtocol="TLS"
                   keystoreFile="/home/projectforge/apache-tomcat-6.0.14/tomcat-localhost.keystore"
                   compression="on" compressionMinSize="2048" noCompressionUserAgents="gozilla, traviata"
                   compressableMimeType="text/css,text/html,text/javascript,text/plain,text/xml"
                   URIEncoding="UTF-8" />
      </Service>
    </Server>

Optional more memory:

apache-tomcat/bin/setenv.sh:

export JAVA_OPTS="-Duser.timezone=UTC -Xmx512m -XX:PermSize=96m -XX:MaxPermSize=192m -Djava.awt.headless=true"

Further informationen

For more detailed information visit: AdministrationGuide.