Upgrade to the 6.6

The upgrade to the new Jahia CMS 6.6 consists of 4 easy steps, please read all of them carefully before proceeding.

Prerequisites:

Stop the user requests / traffic to the server (either on the front-end Apache HTTPD server or firewall/router)
Stop jahia before backing up and running the fix applier
Backup your jahia installation before running the fix applier (for more details about how to backup jahia please check the Configuration and Fine tuning guide available on our Enterprise Documentation extranet page)
Run a pre-production test first

Enterprise Jahia Subscribers:

Please click here to access the specific procedure for Enteprise Jahia, available in the extranet

Jahia Migration from 6.5.1 to 6.6

The first step of the migration is to copy the fix applier Jahia6.6_6.5.1.0_r39069_to_6.6.0.0_r40429.jar to your production server

At this stage, a list of all the files you have customized in your installation will help you to go through the upgrade and decide more easily if you want to merge, keep or overwrite the files.

For all the files impacted, the fix applier will create a backup in the following folder

$USER_HOME/.fixapplier/backup/

and a detailed log is also available here

<Jahia_installation>/tomcat/webapps/ROOT/META-INF/updates/history/fixes/Jahia6.6_6.5.1.0_r39069_to_6.6.0.0_r40429.log

If the fix creator detect that a file has been modified it will try to automatically merge it. If the merge fails you will be able to overwrite the files or skip.

If the merge fails or you decide to skip it, a diff file <file_name>.patch will be available in the destination folder, please make sure that you don't forget to manually apply the changes.

1. Stop Jahia

2. Open a terminal on the following folder

<JAHIA_INSTALLATION>/tomcat/webapps/ROOT

and type the following command :

java -jar <PATH-TO-FIX-APPLIER/Jahia6.6_6.5.1.0_r39069_to_6.6.0.0_r40429.jar

The fix applier will manage the upgrade of your platform by deleting, updating and merging all the necessaries files.

In case you have externalized your configuration (jar file), you will need to apply the modification relative to jahia.properties and jahia.advanced.properties manually.

Please review your log before starting the next step to ensure you haven't missed a file that need to be manually merged.

3. Clean the following Tomcat folder

Remove the contains of your folder

<JAHIA_INSTALLATION>/tomcat/temp

and

<JAHIA_INSTALLATION>/tomcat/work

4. Start JAHIA

During the Jahia startup several scripts will be launched to migrate your datas. One of them will migrate your repository from Blob to Datastore format. This operation can take some time depending of the size of your repository. To give you an idea, for a 4Gb repository the operation took 30min.

Please wait until the migration is completed.

For reference the last script to be executed is Execution of script ServletContext resource [/WEB-INF/var/patches/groovy/6.6.0.0-11-rebuild-spellchecker-index.groovy]

Your upgrade to Jahia 6.6.0.0 is now completed!