Start/Stop Flows

{{container}}{{container layoutStyle="columns"}}(((

In most cases, deploying on the container level is the preferred approach to deploy a release. It is faster, more stable, and less error-prone. However, when running into problems or maintaining your solution in a Production environment, you might need something extra. So, something extra is what we call "Start/Stop flows." In this microlearning, we will explain what the function does for you and when best to use it.

4

5

Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].

6

7

== 1. Prerequisites ==

8

9

* Intermediate knowledge of the eMagiz platform

10

11

== 2. Key concepts ==

12

13

This microlearning centers around start/stop flows for the 3rd generation runtime.

14

This functionality allows you to

15

16

* Stop the entry point of a flow, ensuring no messages are consumed from that point onwards

17

* Start the entry point of a flow, ensuring messages are consumed again

18

* Gain additional control over your model in case of Production issues or maintenance windows of related external applications.

19

20

== 3. Start/Stop Flows ==

21

22

In most cases, deploying on the container level is the preferred approach to deploy a release. It is faster, more stable, and less error-prone. However, when running into problems or maintaining your solution in a Production environment, you might need something extra. So, something extra is what we call "Start/Stop flows."

23

24

=== 3.1 How to use it ===

25

26

You can access this functionality via the "Deploy Architecture" overview in Deploy. For example, you can open the context menu on the runtime level and select the "Start/Stop Flows" option.

27

28

[[image:Main.Images.Microlearning.WebHome@intermediate-emagiz-runtime-management-start-stop-flows--context-menu-deploy-architecture.png]]

29

30

After selecting the option, eMagiz will open a pop-up where you can stop and start the starting point of each flow deployed on that runtime. This effect is that the flow will process **no new messages**, but the flow will still process all remaining messages after stopping the flow. To prevent a flow, you select a flow and press the Stop button. To start it again, press Start.

31

32

[[image:Main.Images.Microlearning.WebHome@intermediate-emagiz-runtime-management-start-stop-flows--pop-up-menu-start-stop-flows.png]]

33

34

=== 3.2 When to use it ===

35

36

Now that we have learned when to use it, we can focus our attention on when to use it. The preferred option when executing changes on the 3rd generation runtime is via the deployment plan, which keeps all parts of your model in sync. Furthermore, as a result, anyone with access can easily see the runtime state. Having said that, when running into issues on a specific integration, for example, spamming of error message on a particular flow, you should turn to the "Start/Stop flows" functionality only to stop that specific process but keep the rest running.

37

38

Another use case of the "Start/Stop flows" functionality is when maintenance is performed on an external system linked to your model. In these cases, you should halt all traffic toward that system but still want to allow them to send you information (in case that is needed).

39

40

== 4. Key takeaways ==

41

42

* Stop the entry point of a flow, ensuring no messages are consumed from that point onwards

43

* Start the entry point of a flow, ensuring messages are consumed again

44

* Gain additional control over your model in case of Production issues or maintenance windows of related external applications.

45

* Only use the functionality in specific scenarios.