Preparing Maven

Installation requires Maven, with some additional plugins. We will assume that MAV_HOME is the directory that contains the maven installationd and the plugins subdirectory and MAVEN_REPO contains the Maven repository, usually $HOME/.maven/repository on Unix machines.

  • You will need to add some extra maven repositories. To do that, create aor add to ${user.home}/build.properties a line like
    maven.repo.remote=http://www.ibiblio.org/maven/,http://www.apache.org/dist/java-repository/,http://maven.jahia.org/
    		
  • execute maven -DartifactId=maven-torque-plugin -DgroupId=torque -Dversion=3.1.1-dev plugin:download (on one line) to install the torque plugin.
  • From the META home, put the torque-gen-3.1.1-dev.jar in the MAVEN_REPO/torque/jars directory.
  • From the META home, download the META plugin and place it in the MAVEN_HOME/plugins directory.
  • Download the Java Activation Framework (version 1.0.2) and put it in the MAVEN_REPO/jaf/jars directory.

Using the internal database

Blogentis needs a database, and it comes configured to use HSQL, an embedded database written in Java. Using HSQL is not recommended for production use, but it is very easy to set up.

To use HSQLDB, modify torque.dsfactory.blogentis.connection in WEB-INF/conf/Torque.properties to the correct path of your blogentis installation.

Using an external database

Blogentis will need a database, either PostgreSQL or MySQL is fine. You will need to create the database so that tomcat has full permissions on that database, and you will need to note the database name, user and password for later use.

Specifically, you will need to edit the following files, and replace some values by the user that will access the database, the password that identifies the user, the JDBC Driver, which is org.postgres.Driver for postgres and com.mysql.Driver for MySQL, the JDBC Connection URL, whic

  • WEB-INF/conf/Torque.properties: set torque.database.blogentis.adapter to the save value as above, and set all properties under torque.dsfactory.blogentis.connection to their apropriate values.
  • build.properties: set all properties under torque.database to their appropriate values, with buildUrl and createUrl set to the JDBC Connection string. Also set torque.database to postgres or mysql depending on your database server.

Setting Slide parameters

The Slide WebDAV server will need to be configured and point to a directory on the filesystem where the user Tomcat is running as has write access. You will need to change the rootpath and workpath of the stores (XPath /slide/namespace/definition/store/(nodestore|contentstore)/parameter) to point (using absolute pathnames) to that directory.

Enabling LDAP access

Blogentis can be set up so that it pulls user account information from an LDAP directory. This is useful if you already use LDAP for user authentication and wish to give the users access to blogentis. Please note that at the tme of writing, this options incurs a slight performance penalty; it also is not recommended for security-concious servers, as the same password for user authentication is used to authenticate with Basic HTTP authentication, which isn't secure.

To enable LDAP access, edit the WEB-INF/conf/TurbineResources.properties file and locate the services.SecurityService.user.class and services.SecurityService.user.manager properties and modify them according to the comments of the file. Also change all properties under services.SecurityService.ldap.user to values that reflect your LDAP schema; the defaults have been set for UNIX accounts, they may or may not work with your schema.

You will need to set services.SecurityService.ldap.admin to an bindable object on your server, but it need not be the admin account. If it is not the admin account, the users wiil not be able to store personal preferences on the LDAP server.