Page tree
Skip to end of metadata
Go to start of metadata

EXPERIMENTAL - Contributed by the community

This feature is experimental and contributed by the midPoint community. Although it should work, please use at your own risk. This feature is not covered by midPoint support. In case that you are interested in supporting development of this feature, please consider purchasing midPoint Platform subscription.

MidPoint 4.2 and later

This feature is available only in midPoint 4.2 and later.

MidPoint provides feature that puts Resource into maintenance mode by administrative decission. It is also known as administrative operational state of the resource. This setting is useful when target system is e.g. undergoing planned maintenance to save computing time of the midPoint and to limit error messages that would normally appear from communication exceptions and so. Administrative operational state signalizes whether resource is up and operational to receive provisioning requests or is down in maintenance and midPoint should not contact it during the provisioning.

When under maintenance, operations are cached to the repository shadow and processed later when resource is back in operational mode. This is possible due to synergy with midPoint's Consistency mechanism.

Administrative operational state is set manually by midPoint power user (e.g. administrator) in the ResourceType object - see example below. This is in contrast with OperationalStateType setting of the Resource, which is set automatically by the midPoint after each provisioning operation.

Resource administrativeOperationalState
<resource ...>
    <name>Resource1</name>

    <administrativeOperationalState>
        <administrativeAvailabilityStatus>maintenance</administrativeAvailabilityStatus> <!-- values: maintenance/operational -->
    </administrativeOperationalState>
...
</resource>


Operations executed on the resource which is under maintenance do not throw common provisioning errors. When change is requested, it's result is IN_PROGRESS to indicate that pending operation has been saved to the ShadowType. When no change is requested or pending delta is propagated to operational resource, SUCCESS result is returned.

Limitations

  • Feature was designed for "outbound" resources. It was not tested for authoritative sources with inbound mappings (e.g. HR resource), but theoretically it may work.
  • Background tasks that were fitted for the administrative operational state of the resource are Reconciliation and LiveSync tasks. The rest of the task handlers may or may not work well when resource is in the maintenance state. The recompute task is compatible with resource administrative operational state by default since it launches individual user reconciles, which are supported.
  • Some midPoint screens do not make use of administrative operational state, this is e.g. case of Resource detail - Accounts tab - Search In: Resource. These screens invoke resource connector operations regardless of the maintenance setting.


  • No labels