Automation Composition Management manages a number of states of various types to manage the lifecycle of compositions. Those states are described here. Please also see the ACM System Level Dialogues page to see the system dialogues that change states and how states interrelate in detail. Please also see ITU Recommendation X.731, which is reflected in the states of AC Element Instances.

Participant State

ACParticipant states are NOT managed by ACM but the state of a participant is recorded and supervised by ACM.

@startuml

[*] --> ONLINE: Register
ONLINE --> ONLINE: Heartbeat
ONLINE --> OFFLINE: Timeout
OFFLINE --> ONLINE: Heartbeat
ONLINE --> [*]: Deregister
OFFLINE --> [*]: Deregister

@enduml

Automation Composition Type State

The states that an Automation Composition Type can have are shown in the diagram below.

@startuml

[*] --> COMMISSIONED: Commission
COMMISSIONED --> [*]: Decommission
COMMISSIONED --> PRIMING: Prime
PRIMED --> PRIMING: Prime
PRIMING --> PRIMED: AC Element Types\nall PRIMED
PRIMING --> DEPRIMING: Deprime
PRIMED --> DEPRIMING: Deprime
DEPRIMING --> COMMISSIONED: AC Element Types\nall DEPRIMED

@enduml

Automation Composition Element Type State

The states that an Automation Composition Element Type can have on ACM Runtime are shown in the diagram below.

The current ACM state machine works but it is incosistent in the way it handles error states or failed transitions. A composition and its elements can get "stuck" in transition states.

We need to

• Specify what the current state machine is for both compositions and elements and describe what the state machine for both should be
• Specify what the behaviour of the runtime and participants should be in each state
• Specify what the behaviour should be for the runtime and participants should be in transitions

Specifically we need to clarify:

• State of the composition elements
• State of the overall composition is derived from the composition element states
• Admin state/Running state
• When all the elements are fully up and configured, the go to state Passive, when all elements are in Passive, the full composition goes to Passive
• Error states: Are they parallel sates or part of the same state?
• There should “it didn’t work” states like “Passive-Error” or “Run_Error” (names to be decided later)
• Describe what the “Running” state means and what the participant should do in Passive->Running and Running->Passive transitions.
• Say a K8S service crashes, how do we feed that back? Running_Error. The state of the POD is only checked during startup. It is not periodically checked. There should be supervision.

ACM Element States in Participants

This section describes the state handling in ACM Elements in Participants

The following states are the only states in participants:

@startuml

[*] --> UNINITIALIZEDCOMMISSIONED: Created by\nACM Runtime
UNINITIALIZED Commission
COMMISSIONED --> [*]: Decommission
COMMISSIONED --> PASSIVEPRIMING: Initialize (Success)
UNINITIALIZEDPrime
PRIMED --> PRIMING: Prime
PRIMING --> UNINITIALIZED_ERROR: Initialize (Error)
UNINITIALIZED_ERRORPRIMED: AC Element Type Primed\nresponse from Participant
PRIMING --> UNINITIALIZED: UnitializeReset (Success)
UNINITIALIZED_ERRORDEPRIMING: Deprime
PRIMED --> DEPRIMING: Deprime
DEPRIMING --> UNINITIALIZED_ERROR: UnitializeReset (Error)

PASSIVECOMMISSIONED: AC Element Type Deprimed\nresponse from Participant

@enduml

The states that an Automation Composition Element Type can have on a Participant are shown in the diagram below.

@startuml

[*] --> UNINITIALIZEDPRIMED: Uninitialize (Success)
PASSIVEPrime from\nACM Runtime
PRIMED --> PASSIVE_ERRORPRIMED: Uninitialize (Error)
PASSIVE_ERRORPrime from ACM Runtime
PRIMED --> PASSIVE[*]: Deprime from\nACM Runtime

@enduml

Automation Composition Instance State

The states that an Automation Composition Instance can have are shown in the diagram below.

@startuml

[*]PassiveReset (Success)
PASSIVE_ERROR --> PASSIVE_ERROR: PassiveReset (Failure)
PASSIVE_ERRORUNDEPLOYED: Create
UNDEPLOYED --> [*]: Delete
UNDEPLOYED --> UNINITIALIZEDDEPLOYING: Uninitialize (Success)
PASSIVE_ERRORDeploy
DEPLOYING --> UNINITIALIZED_ERROR: Uninitialize (Error)

PASSIVEDEPLOYED: AC Element Instances\nall DEPLOYED
DEPLOYING --> UNDEPLOYING: Undeploy
DEPLOYED --> RUNNINGUNDEPLOYING: Activate (Success)
PASSIVEUndeploy
UNDEPLOYING --> PASSIVE_ERROR: Activate (Failure)
RUNNINGUNDEPLOYED: AC Element Instances\nall UNDEPLOYED


state DEPLOYED {
 [*] --> PASSIVELOCKED: Passivate (Success)
RUNNINGDeploy
 LOCKED --> RUNNING_ERROR[*]: Passivate (Error)
RUNNINGUndeploy
 LOCKED --> RUNNING_ERRORUNLOCKING: RuntimeError (Error)
RUNNING_ERRORUnlock
 UNLOCKING --> RUNNINGUNLOCKED: RuntimeReset
RUNNING_ERRORAC Element Instances\nall UNLOCKED
 UNLOCKED --> RUNNINGLOCKING: ClearRuntimeError
RUNNING_ERRORLock
 UNLOCKING --> PASSIVELOCKING: Passivate (Success)
RUNNING_ERRORLock
 LOCKING --> PASSIVE_ERRORLOCKED: Passivate (Error) AC Element Instances\nall LOCKED
}

@enduml

Then, a Control Loop Element can be running a number of operations, each of which has an operational state:

...

To

State

...

UNINITIALIZED

UNINITIALIZED

...

PASSIVE

UNINITIALIZED_ERROR

...

PASSIVE

PASSIVE

...

UNINITIALIZED

PASSIVE_ERROR

...

UNINITIALIZED_ERROR

UNINITIALIZED_ERROR

...

UNINITIALIZED

UNINITIALIZED_ERROR

...

A Control Loop Element has a status indicator

...

Automation Composition Element Instance State

The states that an Automation Composition Element Instance can have on ACM Runtime are shown in the diagram below.

@startuml

[*] --> UNDEPLOYED: Create
UNDEPLOYED --> [*]: Delete
UNDEPLOYED --> DEPLOYING: Deploy
DEPLOYING --> DEPLOYED: AC Element\nInstance DEPLOYED
DEPLOYING --> UNDEPLOYING: Undeploy
DEPLOYED --> UNDEPLOYING: Undeploy
UNDEPLOYING --> UNDEPLOYED: AC Element\nInstance UNDEPLOYED


state DEPLOYED {
 [*] --> LOCKED: Deploy
 LOCKED --> [*]: Undeploy
 LOCKED --> UNLOCKING: Unlock
 UNLOCKING --> UNLOCKED: AC Element\nInstance UNLOCKED
 UNLOCKED --> LOCKING: Lock
 UNLOCKING --> LOCKING: Lock
 LOCKING --> LOCKED: AC Element\nInstance LOCKED
}

@enduml

The states that an Automation Composition Element Instance can have on a Participant are shown in the diagram below.

@startuml

[*] --> DEPLOYING: Deploy
DEPLOYING --> DEPLOYED: AC Element\nInstance DEPLOYED\nRespond with\nAC Element State Update
DEPLOYING --> UNDEPLOYING: Undeploy
DEPLOYING --> [*]: Deploy Failed\nRespond with\nAC Element State Update
DEPLOYED --> UNDEPLOYING: Undeploy
UNDEPLOYING --> [*]: Undeployed\nRespond with\nAC Element State Update

state DEPLOYED {
 [*] --> LOCKED
 LOCKED --> [*]
 LOCKED --> UNLOCKING: Unlock
 UNLOCKING --> UNLOCKED: AC Element\nInstance UNLOCKED
 UNLOCKED --> LOCKING: Lock
 UNLOCKING --> LOCKING: Lock
 LOCKING --> LOCKED: AC Element\nInstance LOCKED
}

@enduml

Each participant also records a log of all operations that occur, recording the information below:

...

To
State

...