Installation and Administration

Upgrade from 5.6 to 5.8

For the general upgrade process, see the Upgrading the Nuxeo Platform page.

This chapter highlights some major information about upgrade from Nuxeo Platform 5.6 to Nuxeo Platform 5.8. Most of it is useful information you need to have to fully understand what has changed in this release. If you need an exhaustive list, see the 5.6 -> 5.8 upgrade notes.

You may also want to have a look at the 5.8 release notes.

If you have followed the Fast Track releases since Nuxeo Platform 5.6, you can refer to the Upgrade from 5.7.x to 5.8 section.

Installation & Configuration

Follow the Installation instruction.

Java 7 Required

Since version 5.7.1, the Nuxeo Platform enforces the use of Java 7 because it's faster (better GC among other things) and because Java 6 is getting unsupported, see NXP-11226.

Upgrade to Tomcat 7

Since version 5.7.2, the Nuxeo Platform was upgraded to Tomcat 7. Please follow the upgrade notes of NXP-10071.

Data migration


Since Nuxeo Platform 5.7.1 all the relations (including comments and publication relations, but excluding annotations) are stored by default in the VCS database. If you upgrade from a previous configuration (before 5.6) where you created relations, comments or publications, then these relation objects were stored using Jena. To keep using this configuration, please follow the upgrade notes of NXP-10350.

Derby Storage Moved to H2

For test and development instances that use the default configuration, audit logs storage has been moved from Derby to H2. If you plan on upgrading your test data on H2 from 5.6 to 5.8, note that audit logs will be lost unless you migrate data from Derby to H2 or change database configuration to use the old Derby database for audit logs.

This also applies to vocabularies, annotations, activities, local configuration and sequences.

SQL Server

The column type for ID columns has been changed from VARCHAR to NVARCHAR, for efficiency reasons. All new tables will be created with NVARCHAR, but existing tables must be migrated. Please follow the upgrade notes of NXP-10862.


The default path optimization has changed since NXP-10210: therefore you need to drop the ANCESTORS table. The data will be recomputed. If a timeout occurs at startup, you'll have to recompute the data by hand with the procedure

BEGIN nx_init_ancestors; END;

Code Migration

EL expressions in Action Filters

From Nuxeo Platform 5.7.3, EL expressions in action filters are using a more generic context to allow better filtering expressions. Please follow the upgrade notes of NXP-10566.

Document Context Used in Action Filters

From Nuxeo Platform 5.8, the document used to evaluate action filters using the category CREATE_DOCUMENT_FORM is the changeableDocument (document being created) instead of the currentDocument (parent of the document being created), see NXP-12605.

Permission checks will now fail because there are no security checks on the document until it is created in the repository - see details at NXP-21465. As a workaround, you can define EL expressions, such as #{documentManager.hasPermission(currentDocument.ref, 'Perm1')}.

Query Models and Result Provider Farms Removal

Content views and page providers have been in place since 5.4.2 to replace old query models and result provider farms, so old classes have been removed for 5.8.

Please follow detailed upgrade notes for these features.

Configuration Migration

Actions on Content View Actions of Ordered Folders

Since NXP-11845, the default content view presenting ordering actions only presents actions with category ORDERABLE_CURRENT_SELECTION_LIST (labelled "Orderable Document List Toolbar" in Studio). It previously presented also actions available to non-orderable content views, CURRENT_SELECTION_LIST (labelled "Document List Toolbar" in Studio).

When upgrading to 5.7.2 or higher, actions using this category will need to use the ORDERABLE_CURRENT_SELECTION_LIST to be available on the default content view orderable_document_content.

Upgrade from 5.7.x to 5.8

Previous Fast Track upgrades notes:



2 months ago Andrew Goodricke Syntax error fixed
3 years ago Solen Guitter 23
4 years ago Solen Guitter 22
6 years ago Anahide Tchertchian 21
6 years ago Solen Guitter 20
6 years ago Solen Guitter 19
6 years ago Florent Guillaume 18 | English
6 years ago Julien Carsique 17
6 years ago Florent Guillaume 16
6 years ago Solen Guitter 15
6 years ago Solen Guitter 14
6 years ago Solen Guitter 13
6 years ago Julien Carsique 11
6 years ago Julien Carsique 12
6 years ago Julien Carsique 10
6 years ago Anahide Tchertchian 9 | NXP-10566: mention changes about filter expressions
6 years ago Solen Guitter 8 | Added 5.7.2 upgrade to Tomcat 7
6 years ago Solen Guitter 7
6 years ago Solen Guitter 6 | Added section on Derby storage moved to H2
6 years ago Anahide Tchertchian 5 | mention java 7 requirement from 5.7.1
6 years ago Solen Guitter 4 | Changed since 5.7 for 5.7.1
7 years ago Anahide Tchertchian 3 | remove Studio migration...
7 years ago Thierry Martins 2
7 years ago Florent Guillaume 1
History: Created by Florent Guillaume

We'd love to hear your thoughts!

All fields required