FAQ, issues during upgrade

Evolveum has created First Steps Methodology to guide your midPoint deployment. Even if you are upgrading from midPoint 4.4 LTS and not installing from scratch, some of the information may be valuable for you as the methodology explains the new midPoint deployment approach leveraging simulations and other midPoint 4.8 features.

Make sure you have updated your Systemd service unit file / service startup script for midPoint.

midPoint 4.4 uses midpoint.war while new midPoint 4.8 uses midpoint.jar file!

If you have followed Upgrade with ninja page, after the application is upgraded, the lib/ directory contains both (old) midpoint.war and (new) midpoint.jar.

Please check and fix your Systemd service unit file or service startup file for midPoint.war references and replace them with midpoint.jar.

See also Running midPoint with systemd.

midPoint 4.8 LTS uses an updated resource definition. Some parts of resource definition are marked as DEPRECATED and the functionality will be eventually removed, e.g. <objectSynchronization> element defined in resource synchronization.

Also, <auxiliaryObjectClass>, <baseContext>, <searchHierarchyScope> in the resource object type definition are DEPRECATED. They were moved to the new <delineation> item.

The old resources should still work in 4.8 LTS (while the deprecated elements are still in midPoint schema), but cannot be edited using resource wizard.

Please refer to schema handling changes documentation for more information how to change your resource definitions after you upgrade midPoint to 4.8 LTS.

midPoint 4.8 LTS uses an improved correlation mechanism named Smart correlation.

The old query-only-based correlation is still supported, but it is DEPRECATED does cannot be edited using resource wizard.

We recommend to upgrade your resource definitions to use the new mechanism, especially the easy-to-use Items correlator after you upgrade midPoint to 4.8 LTS.

There are two relevant improvements related to synchronization situations in 4.8 LTS:

See also answer for Do I need to update my 4.4-based resources after upgrade to 4.8 LTS?.

midPoint resource wizard can be currently used to create and update resource definitions mainly for your first steps midPoint. There are limitations in supported expressions (e.g. it supports "As is", "Literal", "Script" and "Generate" expressions) and correlation (e.g. it does not support "correlation by query" yet). Also, mapping domain / ranges are not currently supported.

If the resource wizard does not meet your expectations, feel free to define your resources using midPoint XML language.

The resource wizard features will be gradually improved in future midPoint releases.

In midPoint 4.4, mappings could be disabled to temporarily switch them off from processing. This feature is DEPRECATED in midPoint 4.8 LTS.

Please use the mapping’s lifecycleState set to draft to switch off the mapping. This is supported also in the resource wizard. In addition to draft, there are other lifecycle states supporting simulations and other operations.

The resource wizard allows setting a name for all your mappings. Mapping names can significantly help with mapping troubleshooting. They are also used for merging configuration if you use Resource and Object Type Inheritance (e.g. resource templates).

We recommend to use mapping names and this is why resource wizard displays the mapping names as the first (prominent) column in the resource mappings table.

In midPoint 4.8 LTS, there is a new Resource phase in auditing subsystem (and audit log). This phase audits all operations performed on provisioning level - changes of resource objects.

The Resource phase auditing is turned on by default in midPoint 4.8 LTS. It can significantly increase audit log size, especially when the deployment manages a lot of resources.

Please refer to Auditing of Resource Object Changes if you want to turn this auditing off.