This page describes the minimal setup for your Hippo CMS project. For the various parts of the Hippo Community Apps or the use of other databases than MySQL additional settings may be required.

Hippo Cocoon Plugin version 2.0.13 or higher is required

1. Create a new eclipse project
2. Add the editor folder from latest Hippo CMS tag (version 6.04.02 or higher) to svn:externals. Name it editor.
3. Add the folder cms-hcamanager from the latest tag of Hippo Community apps to svn:externals. Name it hcamanager. Note that Oracle users need the Oracle specific tag.
4. Do an svn update to retrieve the code.
5. Add a file common-project.xml in your project root with the following structure:

   <project>
     <extend>hcamanager/project.xml</extend>
   </project>

6. Create a file build.properties in the editor folder and add the following properties
   1. for MySQL:

      hca.jdbc.driverClassName=com.mysql.jdbc.Driver
      hca.jdbc.url=jdbc:mysql://localhost/default
      hca.jdbc.username=username
      hca.jdbc.password=password

   2. For Oracle:

      hca.jdbc.driverClassName = oracle.jdbc.driver.OracleDriver
      hca.jdbc.url = jdbc:oracle:thin:@localhost:1521:TEST
      hca.jdbc.username=USERNAME
      hca.jdbc.password=PASSWORD
      # Schema creation
      hca.jpox.autocreatetables=false
      hca.jpox.autocreateschema=false
      hca.jpox.autocreatecolumns=false
      hca.jpox.autocreateconstraints=false
      # Validataion
      hca.jpox.validateTables=true
      hca.jpox.validateColumns=false
      hca.jpox.validateConstraints=false

      Note: use the oracle.sql file from the latest release to create the necessary tables

7. Build the CMS from the project root folder with

   maven -d editor cocoon:deploy

8. Create dashboard configuration
   1. Customize dashboard : follow steps 1-4
   2. Add below welcome:

      <view src="hcamanager://perspectives/dashboard/views/mailing-profiles/component.xml"/>
      <view src="hcamanager://perspectives/dashboard/views/mailgroups/component.xml"/> <!-- added in version 2.01.00 -->
      <view src="hcamanager://perspectives/dashboard/views/newslettertypes/component.xml"/>
      <view src="hcamanager://perspectives/dashboard/views/mailings/component.xml"/>
      <view src="hcamanager://perspectives/dashboard/views/poll/component.xml"/> <!-- added in version 2.01.00 -->

   3. When getting an error check: http://<cms>:<port>/workbench/repository-configuration/perspectives/dashboard

Secure connection (https)

If https is used as protocol for Hippo CMS, add an extra RequestHeader to the Apache SSL config:

 RequestHeader add X-Forwarded-Protocol "https"