/inc/pf/img/header.jpg

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.

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. Create sub-directory apache-tomcat/webapps/ProjectForge and unzip ProjectForge-...zip here.
  2. Copy the data base driver Hypersonic (Downloads) into the Tomcat lib directory.
  3. ProjectForge.xml in conf/Catalina/localhost/ anlegen (s. u.) und DB-Zugangsdaten ggf. ändern.
  4. Re-start Tomcat.
  5. Call web side http://localhost:8080/ProjectForge/.
  6. Login as user "initialize" with the password "empty". ProjectForge creates a new user "admin" with the password "manage".
  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="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.