Jahia 4.2 README file

Please read this README carefully to learn about the new features present in this release.

Table of content:

- Status of this release
- New Features in 4.2
- How can I upgrade from a Jahia 4.1.x to this new release ?
- Installation Issues

Status

Besides the bug fixes and performance enhancements, this release mainly provides the new site export functionality, which should be used for migration to Jahia 5. Furthermore this release gives you more control on configuring the number of concurrent page generation threads and the prepared statments cache. We have also backported some useful features from Jahia 5.

New features/improvements in 4.2

• XML Export feature
  The XML export feature has been backported from Jahia 5 and allows to export Jahia sites and to import them in another Jahia 5 based server. This is also the recommended way to migrate a Jahia 4 installation to Jahia 5. Notice that several objects will get new IDs, so you should consider that and make manual changes in case you are referencing hardcoded IDs (page, container, field IDs...) in your templates, event handlers or expression markers.
  
  
• JDK 1.5 and 1.6 Support
  Jahia 4.2 can now be compiled under JDK 1.5 and run under JDK 1.6, which reportedly offers performance improvements of 30% to 40% over other Java Virtual Machines. Results of a few tests done by Sun and reporting good performance improvements out-of-the-box can be accessed here.
  
  
• Performance and stability
  We have refactored some methods synchronized by the JVM in order to prevent lock situations, fixed some concurrency problems and also worked on performance improvements.
  
  
• More editing features for page fields
  Like in Jahia 5 there are now more options when declaring page fields in a container. Until now it was only possible to set the "jahia_linkonly" keyword, now you can set: "linkonly", "pageonly", "move", "internal", "external" to control which options should be displayed on page creation. For new direct pages you can also define, which templates the editor may choose. For page-links the option "notitleoverwrite" will automatically copy the page title of the linked page and will not present a field to overwrite the title.
  
  
• Integration of the FCK Editor
  For editing big text fields, we have backported the integration of the FCK editor, which is now the default editor. It also provides plugins to insert links to Jahia pages or filed in the WebDAV repository. The HTMLArea editor is still available and can be chosen from the combobox.
  
  
• Using JBossCache, JGroups, transactions and new JahiaHiLoIdGeneratorService (work in progress)
  There is now an alternative to our cache service and the JMS cache replication in cluster. You can use the JBossCache and setup the cluster replication with JGroups. Furthermore Commaro has contributed some fixes to enable Jahia running with database transactions. Although this configuration is working in their production environment, it still has not been tested with all optional Jahia features. You should thoroughly test your application, if you decide to enable transactions. A guide how to configure transactions can be found here: To setup and activate transactions.
  
  

Please check the complete change Log to view a complete list of all the modifications.

How can I upgrade from a Jahia 4.1 to this new version ?

An automatic migration is provided and can be downloaded from the Jahia website. Please download the Jahia Update tool to proceed with the upgrade. This upgrade tool will allow to upgrade either from Jahia 4.1.0 OR Jahia 4.1.0_01 to this release. Read carefully the README provided with the update tool and make sure you do a full backup of all your current Jahia environment (file system + database).

Installation Issues

Be sure to check the How to install document for additional information on how to configure the Java environnement for Jahia, as well as a few other tips.
Please check the archive of the public Install mailing list before sending us your issue (http://list.jahia.org ).
The Technical FAQ can also help you solve some issues and/or improve Jahia performance.