header

Professional installation

With this professional installation there are no limits with regards to large teams and countless users.

With this professional installation there are no limits with regards to large teams and countless users.

Own web-server with https, professional data base

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

  1. Download the distribution ProjectForge-force-SSL-<version>.war
  2. Install of PostgreSQL
  3. Copy the jdbc driver of this PostgreSQL version (from the PostgreSQL distributation) into the Tomcat lib directory.
  4. Create the database user and the database:
    createuser -U postgres -P projectforge
    createdb -U postgres -E UTF-8 -O projectforge projectforge
  5. Create ProjectForge.xml in conf/Catalina/localhost/ directory (see below) and change the data base parameters (password etc.).
  6. Create apache-tomcat/bin/setenv.sh (see below)
  7. Re-start Tomcat.
  8. Call web site http://localhost:8080/ProjectForge/.
  9. Please follow the setup dialogue.
  10. 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="false">
  <Resource name="jdbc/ProjectForgeDS" type="javax.sql.DataSource" auth="Container" driverClassName="org.postgresql.Driver"
    url="jdbc:postgresql://localhost:5432/projectforge" maxActive="100" maxIdle="30" maxWait="10000" username="projectforge" password="" />
  <Parameter name="base.dir" value="${user.home}/ProjectForge" override="false" />
  <Parameter name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect" 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:
<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.26/conf/tomcat-localhost.keystore"
               compression="on" compressionMinSize="2048" noCompressionUserAgents="gozilla, traviata"
               compressableMimeType="text/css,text/html,text/javascript,text/plain,text/xml"
               URIEncoding="UTF-8" />

apache-tomcat/bin/setenv.sh:

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

Further information

For more detailed information visit: AdministrationGuide.