enPortal 5 contains many significant changes from previous versions of enPortal. The major changes are detailed in enPortal 5.6 New Features. Due to the significant changes between enPortal 4.x and enPortal 5.x, special steps are needed to upgrade an enPortal 4.x system to enPortal 5.x.
The upgrade process primarily manages the specific transition of the provisioning of content. In enPortal 4.x, the administrator could provision (assign) content directly to Roles, Users, or Domains. In enPortal 5.x, all of the content must be provisioned by Role in order for it to work properly in the UI. If you had previously provisioned content by Role, then it should not be difficult to transition this to the new system. If not, then you may need to create new Roles for any Domains and Users that had content provisioned to them directly.
As with any upgrade, you will need to ensure that any customizations you have been preserved by the files export process. If not, you may need assistance with tweaking the export.properties file to adjust it as needed.
This step ensures that the enPortal 4.x system is prepared for the upgrade process.
Perform the following steps prior to implementing the upgrade:
After completing the Pre-Upgrade Work described above, install enPortal 5 in the new directory or server.
To do so, follow the enPortal 5.x installation instructions.
This step bundles some important files from the enPortal 4.x system and transfers them to the enPortal 5.x system.
This step exports the content from the enPortal 4.x database and loads it into the enPortal 5.x database
This step tweaks the configuration of enPortal 5.x to properly recognize the content that was loaded in the steps above.