Upgrade from 5.4.2 to 5.5

Code migration

5.5 is mainly backward compatible with 5.4.2.

Changes in Nuxeo Automation: there was a Java package renaming from org.nuxeo.ecm.automation.client.jaxrs.model to org.nuxeo.ecm.automation.client.model.

If you have any problems, you can contact Nuxeo Support.

Packaging

The DM, DAM, SC, and CMF distributions are now available as Marketplace packages.

This new packaging system is used in the SetupWizard to allow to choose between different profile at installation time.
You can also use the Admin Center or the nuxeoctl commands to add or remove these packages. For projects having a custom distribution based on one of ours, no problem, we provide presets for automatically transform the new unique Tomcat distribution into a DM, DAM or CMF.
Also, the "EAR" (zip) assemblies do still exist.

Using the wizard is just an additional option.

Data

Only fews adds were done between 5.4.2 and 5.5 (no alter). So you can migrate and retrieve all your 5.4.2 data after 5.5 installation.

For relations, these attributes are added to the "relation" schema (NXP-7962):

A new metadata has been added to follow the legacy definition of dublincore schema (NXP-7884) :

A new schema has been added: task.xsd (related to the nuxeo-platform-task feature - NXP-7852):

(4 new tables due to complex types added)

Installation & Configuration

Follow Installation Instruction.

Under all OS:

• H2 Embedded database is not supported for data detection
• After the installation, uncomment the line custom.target in your template/custom/nuxeo.default and set it to "." to indicate the path of your custom templates
• "session.timeout" has been added to nuxeo.conf and can be overridden for defining the web session timeout which is then integrated into the web.xml file

Under linux:

• The new installation changes the opt/nuxeo content location to /var/lib/nuxeo/server - templates and conf still in etc/nuxeo folder
• The package debian autoconfigure
  • detects your data 
  • detects/adds your marketplace addons (including DM,CMF,DAM)

Under windows:

• Windows installer 
  • detects your data
  • detects/adds your marketplace addons (including DM,CMF,DAM)

Third party libraries upgrades

• GWT - Nuxeo is now using GWT 2.4.0.
• JAX-WS - Libraries have been upgraded to 2.2.5 in order to fix some compatibilities issues.
• OpenCMIS - Nuxeo Platform is now aligned on OpenCMIS 0.6 that comes with experimental support for the CMIS Browser binding (JS compliant API).
• JEXL - Location is changed from Nuxeo Runtime to Nuxeo Platform Action

Nuxeo Theme

Nuxeo Theme service has been extended so that you can now contribute page styles in a plain CSS stylesheet.
The page layouts are still managed by the Theme engine using an XML description, but all CSS information is now externalized to CSS stylesheets that can manage flavors (pretty much as with LessCSS).

• Theme documentation page
• Migrating a custom theme
• Migrating the branding in Studio to follow Nuxeo changes

Tasks

Until 5.5, the Task system was directly bound to JBPM.
Starting with 5.5, a new TaskService is available and uses VCS to store tasks.
This new TaskService is a first step towards the integration of Content Routing as the default Workflow engine in DM.

Migration should be 100% transparent :

• The Task Operations have not changed
• REST APIs are maintained
• Tasks created in jBPM and not directly associated to a process will be automatically migrated upon first access
• jBPM Tasks are still accessible via the new TaskService
• The jBPM task API is maintained

Relations

The new default configuration takes care about compatibility so that if you have existing relations in Jena graph you will still be able to transparently access them.

Fulltext

Partially missing fulltext index for the title field

Old versions of Nuxeo DM might have document before the introduction of the "fulltext_title" index. This is visible on the 5.5 release thanks to the new search suggestion widget that might be missing some suggestions on old documents.

To update the title fulltext index, just perform the following SQL query on your PostgreSQL server:

PostgreSQL fulltext phrase search

In Nuxeo 5.5 for PostgreSQL we've added a better way to store fulltext information that enables the use of phrase search. If you want to use phrase search, you should follow the upgrade notes of NXP-5689. If you do this fulltext upgrade, you may want to check the (unsupported for now) nuxeo-reindex-fulltext plugin to get more accurate phrase search results.

Digital Asset & Case Management

For now, it is not possible to install CMF with other packages like DM and DAM because there are some content model incompatibilities.

Distribution

Regarding to custom distributions and related to the new 5.5 packaging (DM, CMF, DAM are now addons), Ant assembly script (assembly.xml) has to be modified:

Deploy the nuxeo cap distribution (only nuxeo-cap classifier still exists):

Define type distribution:

Optional: choose the wizard distribution type by setting wizard addon preset (NXP-8031):