/inc/pf/img/header.jpg

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.

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

  1. Create sub-directory apache-tomcat/webapps/ProjectForge and unzip ProjectForge-...zip here.
  2. PostgreSQL installieren
  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. Datei apache-tomcat/bin/setenv.sh anlegen (s. u.)
  7. Re-start Tomcat.
  8. Call web side http://localhost:8080/ProjectForge/.
  9. Login as user "initialize" with the password "empty". ProjectForge creates a new user "admin" with the password "manage".
  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="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.