Wiki source code of Settings

Last modified by Erik Bakker on 2023/01/24 15:08

Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 In this microlearning, we will educate you on which settings you need to define in Design to ensure that you can transfer your solution to Create.
3
4 Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5
6 == 1. Prerequisites ==
7
8 * Basic knowledge of the eMagiz platform
9
10 == 2. Key concepts ==
11
12 This microlearning centers around the Settings in Design
13
14 With settings we mean: A set of configuration items that define how the setup of the model will look like.
15
16 The settings define:
17
18 * Technical name
19 * Namespace URL
20 * Enforce CDM best practices
21 * Nr. of process containers
22 * IaaS where is your eMagiz model deployed)
23 * Use failover
24 * Use cluster
25 * Connection type
26
27 == 3. Settings ==
28
29 In this microlearning, we will discuss how to configure the settings to represent the correct structure of how your model will be running.
30
31 eMagiz will fill in several settings for you and those you don't need to change. These settings are:
32
33 * Enforce CDM best practices
34 * Use cluster
35 * Connection type
36
37 The other settings can be divided into two segments. The first segment defines settings that you need to set once and never have to change anymore.
38 Under this segment we define the following settings:
39
40 * Technical name
41 * Namespace URL
42
43 The second segment defines settings that might change over time as your integration landscape is growing which leads to different choices:
44
45 * Nr. of process containers
46 * IaaS (where is your eMagiz model deployed)
47 * Use failover
48
49 Editing either one of these settings can be done via the Edit Settings button:
50
51 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--edit-project-settings.png]]
52
53 === 3.1 Generic Settings ===
54
55 The generic settings that need to be defined once are the technical name and the namespace URL.
56 The advice is to shorten your display name to seven characters to represent the technical name and let the namespace URL reflect what your eMagiz model is about (i.e name of a business, organizational unit, etc.).
57
58 An example of such a implementation would be:
59
60 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--generic-project-settings.png]]
61
62 === 3.2 Specific Settings ===
63
64 The specific settings could change over time as your integration landscape is growing leading to other decisions being made.
65 Let us take a look at each of these settings one by one to see what they are about and how they can change over time.
66
67 ==== 3.2.1 Nr. of process containers ====
68
69 The number of process containers defines how many runtimes will be used to run your core flows (i.e. onramp, offramp, routing, error).
70 The default setting is 1 process container.
71
72 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--number-of-process-containers.png]]
73
74 However the moment your integration landscape grows beyond a certain number of flows you should think about dividing the load between multiple process containers.
75 The current limit we advise is a maximum of 60 flows per process container.
76
77 ==== 3.2.1 IaaS ====
78
79 We offer two choices when it comes to where you are deploying your integration (eMagiz Cloud in AWS or On-premise). The third option (Root) is deemed end of life
80
81 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--IaaS-options.png]]
82
83 The best practice for test models and academy-related models is to run them on-premise (meaning in this case your laptop).
84 The best practice for actual models is to run them in the eMagiz Cloud (AWS)
85
86 ==== 3.2.1 Use failover ====
87
88 The third setting that could change over time is the setting to use a failover or not.
89
90 Using failover will add high availability and redundancy of the JMS servers to the solution, but also requires more hardware to deploy on.
91 Note that in most cases using failover with only a single process container is not very useful, as this makes the process container the single point of failure.
92
93 This means that you have to decide whether your model should be always up and running (also in case of trouble on one of the JMS servers) or if it is okay that downtime can occur in those situations.
94 Furthermore, it means that this setting also impacts the setting for the nr. of process containers.
95
96 If you use failover and have less than 60 flows you should have 2 process containers.
97 If you have between 60-120 flows and use failover you should have 4 process containers. As you can imagine the logic continues onwards if you continue to grow.
98
99 === 3.3 Applying Settings ===
100
101 The moment you are satisfied with your settings you need to apply the settings for the Design Architecture to reflect your choices.
102 The first time you set up these settings you can press the Apply Settings button in this overview as it will immediately apply the settings to Test, Acceptance, and Production.
103
104 However, the moment you are already running your eMagiz integration landscape on these environments on Test, Acceptance, and Production
105 we strongly advise that you apply the change in settings **per** environment.
106
107 You can apply these settings **per** environment via the Design Architecture overview by selecting the option Apply settings.
108
109 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--apply-settings-design-architecture.png]]
110
111 === 3.4 Transfer settings to Create ===
112
113 Furthermore, the moment you change your settings **after** you have transferred at least one flow to Create you should also update the settings in Create to reflect the new reality.
114 You can do so by navigating to Create -> Settings -> Transfer Settings from Design.
115
116 If there are differences in one of the specified categories you should press the Transfer button to sync Design and Create.
117
118 [[image:Main.Images.Microlearning.WebHome@crashcourse-platform-design-project-settings--transfer-settings-from-design.png]]
119
120 Be aware that changing these settings can have an impact on a multitude of flows, therefore proceed with caution and be patient to see results
121
122 == 4. Key takeaways ==
123
124 * Some settings need to be defined once
125 ** Technical name
126 ** Namespace URL
127 * Other settings can change over time
128 ** Nr. of process containers
129 ** IaaS
130 ** Use failover
131 * Applying them should be done with caution and with reason
132
133 == 5. Suggested Additional Readings ==
134
135 If you are interested in this topic and want more information on it please read the help text provided by eMagiz.
136 )))((({{toc/}}))){{/container}}{{/container}}
eMagiz
1.0.0