Enterprise Jahia: Installation Made Easy

Nov 09, 2011
Carlos Araujo

Jahia is an excellent open source java web content management system.  This post focuses on how to install the Enterprise version of the Jahia WCM on your server using the pre-package Jahia compressed file found here http://extranet.jahia.com/jahia/Jahia/site/net/download/binaries_v6 . It will be a simple ride for you. So let’s start.


The Jahia bundle comes with an integrated Tomcat application server as well as a Hypersonic SQL database. This is very useful for a quick installation as well as for developers.


Jahia will run on any machine running Windows NT / 2000 / XP, in any Linux, Solaris, Mac OSX. Jahia Version 6.0 tries to cache a maximum of data to improve and boost performance; this is why it is highly recommended to provide enough system memory to the machine or server where Jahia will be running.


On the Jahia download page there are several bundles ready to be installed. For Linux there are two distributions; a Tomcat/Linux and a Jboss/Linux version and for Windows there is only the Tomcat/Windows version. For this post I chose the Windows Tomcat version.


It is important to have installed the JDK 1.5 as minimum, you can find Linux and Windows version on SUN/ORACLE web site. http://java.sun.com/javase/index.jsp


I assume you already have the system variables JAVA_HOME set.


Jahia Enterprise Edition v6 is distributed with an embedded application server Apache Tomcat 6.0.18. A manual configuration of the server is NOT required. It will be configured over the Jahia installation. Please note that the software is configured to run on port 8080, it will create conflicts if you have another instance of tomcat or any other application running on that port.


The default embedded database on Jahia Enterprise Edition v6 is HyperSonicSQL Database. This configuration is used to start rapidly on Jahia environment, but of course during the configuration wizard in Jahia you can setup Jahia on another database.


Now let’s unzip the file we downloaded into a folder. The folder name cannot have any spaces between words. Once you get into the unzipped folder, locate the file named JahiaInstallation.bat and follow the installation process.


The process will open a browser with location http://localhost:8080/config/installation/ please follow the wizard configuration.


Agree to the Enterprise License, then setup administration settings like username, password, first and last name and email address. This info will be prompted each time you want to access Jahia admin panel.


Continue configuring the server settings. Servlet container home disk path is important; there should not be any spaces in the name.

In the same panel you can configure some other Database settings using the advance settings link. In the new window if you want you can set a different database engine, for this you need to set the database driver, the database username, the database password.


Also you can set mail setting, this is optional. These settings are for system notifications.


At the end you will see a screen confirming all the info set throughout the entire wizard process. After saving, Jahia Enterprise restarts and is ready to be in use. To start using Jahia always go to the following URL http://localhost:8080/cms (replace localhost with the domain or IP where Jahia Enterprise v6 resides)


Something that is important to set in the machine where Jahia is installed before compiling is the settings.xml file information. This file resides in the conf folder of maven installation folder.
In this file, the tomcat profile needs to be set as follows (Replace the targetServerDirectory with the value of your installation)



<profile>

<!-- Tomcat 6.0 development -->

<id>andromeda-deployment-tomcat6-dev</id>

<properties>

<jahia.deploy.targetServerType>tomcat</jahia.deploy.targetServerType>

<jahia.deploy.targetServerVersion>6</jahia.deploy.targetServerVersion>

<jahia.deploy.targetServerDirectory>C:/JAHIA/Jahia_EE_v6_SP1_r28889</jahia.deploy.targetServerDirectory>

<jahia.deploy.war.dirName>ROOT</jahia.deploy.war.dirName>

<jahia.deploy.war.contextPath>/</jahia.deploy.war.contextPath>

<jahia.deploy.war.servletPath>/cms</jahia.deploy.war.servletPath>

<jahia.debug.address>socket:hostname=localhost,port=17000</jahia.debug.address>

</properties>

</profile>

 


Also set the activeProfiles, the Jahia plugin and the pluginGroups information as follows (replace the localRepository with your server information):


<activeProfiles>

<activeProfile>gwt-1.5</activeProfile>

<activeProfile>andromeda-deployment-tomcat6-dev</activeProfile>

</activeProfiles>

<!-- Jahia plugin -->

<pluginGroups>

<pluginGroup>org.jahia.server</pluginGroup>

</pluginGroups>

<localRepository>C:/Documents and Settings/Oshyn_1/.m2/repository</localRepository>