How to install

In this section

• System requirements
• Installation
• LDAP configuration
• Installation issues

System requirements

Operating system :

• Windows 2000/2003/XP
• Linux
• Solaris
• Max OSX

Suggested Min. Development Configuration :

• Bi-Pro Pentium 2GHz or + / Xeon
• 2GB RAM
• 1GB HD

Suggested Min. Production Configuration :

• Bi-or quadri Pro (64 bits CPU and OS)
• 4 or 8 GB RAM
• 100GB HD

Warning: 32 bits JVM are limited in max memory (1.5 GB under Windows - 2 or 3 GB under Linux/Solaris). Jahia 5.0 tries to cache a maximum of data in order to boost performance. So we highly recommend 64 bits environments with enough memory available at least for all production environments.

Supported databases :

• HyperSonic SQL
• MySQL
• PostgreSQL
• Oracle
• MS SQL Server

Compatible application / web servers :

Developed with :

• Tomcat 5.5

Periodically tested with

• Websphere 6.1 with latest patches
• JBoss AS 4.x

Java :

• Sun JDK 1.5.x
• Sun JDK 1.6.x

Client :

• Internet Explorer (from version 5.5+)
• Firefox (from version 1.0+)

Installation

Before running Jahia, you first need to install a Java virtual machine on your system. You will find both versions for Linux and Windows on the SUN Java web site. You need to download the J2SE SDK (or JDK), the JRE (runtime environment only) will NOT be sufficient.

Please note that to install a Java virtual machine on a Windows system (Windows NT, Windows 2000 or Windows XP), you need to have administrator rights on your computer. Please contact your system administrator if you have not sufficient permissions.

After the installation, you have to set the JAVA_HOME environment variable to the directory where your have installed the Java virtual machine. The default installation path of the Java virtual machine on Windows is "c:\j2sdk1.5.0_XX" (XX being the version number of the JDK).

To add the JAVA_HOME environment variable, proceed to the following:

Windows

1. Open the Control Panel, then open the System option. Then, depending on your system :
   • Select the Advanced tab and click on the Environment Variables button (Windows 2000/XP)
   • Select the Properties tab and click on the Environment button (Windows NT)
2. Click on New in the "System variables" part to add a new environment variable
3. Enter the following information:
   • Variable name : JAVA_HOME
   • Variable value: c:\j2sdk1.5.0_XX(If you have not installed the Java virtual machine in the default directory, replace this value with the correct path)
4. Click on OK to validate your entry. The Java virtual machine should now be correctly set-up.

Linux

On Unix systems, the JAVA_HOME variable is usually set by typing:

• export JAVA_HOME=usr/java/j2sdk1.5.0_XX (in bash or ksh)
• setenv JAVA_HOME usr/java/j2sdk1.5.0_XX (in csh or tcsh)

You can now start Jahia by running jahia.bat from the menu (Windows) or jahia.sh (Linux).

LDAP/AD Connection

To setup the connection to your LDAP or ActiveDirectory server, you will need to modify the following files :

• jahia/WEB-INF/etc/spring/applicationcontext-services.xml :
  Uncomment the part beginning with bean id="JahiaUserManagerLDAPProvider", the parts with <key><value>ldap</value></key>, as well as the part beginning with bean id="JahiaGroupManagerLDAPProvider"
  
• jahia/WEB-INF/etc/services/usermanager/router-config.xml and group-router-config.xml :
  Uncomment in both files the part beginning with <provider><key>ldap</key>, as well as the part beginning with <criteria><key>ldap_criteria</key>.
  
• jahia/WEB-INF/etc/ldap/users.ldap.properties and groups.ldap.properties :
  Modify both files to suit the parameters needed to connect to your LDAP/Active Directory. For the users.ldap.properties file, you will also need to map the "username", "first name", "last name", "email" and "organization" parameters to the corresponding attributes in your LDAP schema. The same goes for the groups.ldap.properties with the "groupname" and "description" parameters.
  Make sure the other parameters in these 2 files match your ldap schema.
  

Installation Issues

Make sure you don't use any white space in the path name when installing Jahia.

Make sure also that the database you created for Jahia is empty before installing this release (no previous Jahia tables should exist in the database).

Please check the archive of the public Install mailing list before sending us your issue (Archives Install mailing list).