Upgrading from 2.4 to 2.5 - tsgrp/hpi GitHub Wiki

HPI Config Updates

When migrating an existing HPI application from 2.4 to 2.5, it is recommended to backup your existing /hpi/configs folder, and then reconfigure HPI. The following strategy is recommended:

  1. Install HPI 2.5 in a QA or Test environment
  2. Configure HPI based on your existing production environment
  3. Upgrade the production environment to HPI 2.5
  4. Port the configurations from QA/Test to Production.

Configuration Notes

  • Folder Notes - The note object type name was previously set to hpi_note. This was changed to HPI Note (the OC name) with HPI rev 16403.
  • Recent Objects Dashlet - The recent objects dashlet now allows for configuring recent folders / documents. The dashlet must be deleted and reconfigured with HPI rev 17691.

Alfresco Model Updates

HPI Email Message

With the 2.5 release, the HPI Email Message now has tsg:renditioned as a mandatory aspect. When upgrading, you have one of two options:

  1. After deploying the new model, run a script to add the aspect to the existing objects. Care should be taken to ensure that this is done in batches. Attaching this aspect to an object will kick off a HTML to PDF conversion on the Transformation Server.
  2. Alternatively, stick with HTML emails, and remove the mandatory aspect from the model. With this approach, emails will not be available for use in actions like Combine PDF and cannot be annotated.

Controlled Doc - Alfresco Updates

The To Be Read (TBR) aspect was added as a mandatory aspect in HPI 2.5. Here's what you need to do:

  1. Ensure that the Javascript console AMP is deployed to Share
  2. Ensure all Controlled documents are unlocked
  3. Deploy the latest OpenContent, which will update the model
  4. Run this update script in the Share Javascript console: HPI\trunk\setup\alfresco\upgrade\addTBRaspect.js