Child pages
  • 4.3.0

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • If upgrading from 4.1 or prior, do not attempt an upgrade without an initdb.  If upgrading from 4.1, you can do it if your 4.1 theme was Respondr.  If your 4.1 theme was Universality, you must do an initdb.
  • EntityProperties  The unused entityType org.jasig.portal.services.entityproperties.EntityProperties was removed;  if you are deploying uPortal 4.3 with an existing database, use the following SQL to remove it:  DELETE FROM UP_ENTITY_TYPE WHERE ENTITY_TYPE_NAME = 'org.jasig.portal.services.entityproperties.EntityProperties';  deployments that run initportal or initdb will not experience this issue.
  • As always with an version update when not doing an initdb, run the command ant -Dmaven.test.skip=true db-update to update the schema of your database.  If you want to review what the changes would be first, run ant -Dmaven.test.skip=true db-gen-update-script -DoutputDir=dbUpdateDdl and review the SQL scripts in that directory.
  • SimpleContentPortlet moved from version 1.x to version 2.x.  If you are upgrading without an initdb and you used the Attachments feature to upload images, documents etc. into SimpleContentPortlets, Announcements, or other locations, you must export the attachments using the 1.x SimpleContentPortlet and import them using the 2.x SimpleContentPortlet.  The attachment storage changed from a Base64-encoded text field to a BLOB.  See Upgrading from 1.2.x or prior to 2.0.0.
  • The Newsreader portlet definitions changed because the single-news-feed portlet is eliminated.  Integrate the changes into your portlet definitions.
  • There are a number of permissions changes that were made in 4.3.0.  As with any upgrade, you should compare your src/main/data for 4.3.0 to your current version, including your institutionalized version of the quickstart entities (most sites copy the quickstart entities to an institution-specific entities directory and customize the institution-specific entities directory).  For more details on that process, see the updating section of Git Workflow for Vendor Branching for more details.  Some particular notes if upgrading from 4.1 or 4.2 to 4.3 without an initdb:
    • For Manage Portlets and other features, there are additional permissions that need to be imported.  There are some permissions that were removed for security reasons.  See the following image for changes that need to be imported and permissions that need to be deleted when going from 4.2.0 to 4.3.0 (non-exhaustive comparison, do your diligence comparing the directories yourself and certainly do it for 4.1 to 4.3.0 as it has additional files needing importing).
      • When going from 4.1 or 4.2 to 4.3.0 you can create your list of files to import and import them all at once using a new capability added to ant data-import.  For 4.2.x to 4.3.0 for instance, you can check out the file https://github.com/Jasig/uPortal/blob/master/uportal-war/src/main/data/default_entities/update4-2to4-3-0.txt and run the ant command ant data-import -Dmaven.test.skip=true -DfilesListFile=uportal-war/src/main/data/default_entities/update4-2to4-3-0.txt to update the standard default-entities as shown in the picture below (you'll still need to use the Admin UI to delete the permissions in grey).  You potentially can just re-import the default_entities directory, but beware that you probably have some overlapping files in your institution_entities directory that would be overridden if you imported the default_entities.

...