Changes for page Exercise - Apply to environment

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,40 +1,75 @@
1		-{{container}}{{container layoutStyle="columns"}}(((
2		-With this exercise, we learn how to use the "apply to environment" functionality in Deploy -> Architecture. This functionality is a key component in sending changes to our eMagiz cloud to actualize these changes. Most notably among these changes are the configuration of routes and certificates.
	1	+{{container}}
	2	+{{container layoutStyle="columns"}}
	3	+(((
	4	+In this microlearning, we will focus on the "apply to environment" action. As we saw in previous microlearnings and will see in microlearnings to come with regards to cloud management is that some actions in Deploy Architecture have a direct effect (i.e. Slot Wakeup, Restart Runtime, Reset Runtime, etc.) and others have an indirect effect (i.e. Add Route, Add Certificate, Remove Runtime, etc.). For the actions that have an indirect effect on the eMagiz Cloud, you need the "apply to environment" functionality to actualize the changes on the eMagiz Cloud level.
3	3
4	4	Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5	5
6	6	== 1. Prerequisites ==
7	7
8		-* Completed all previous microlearnings on the subject.
9		-* Access to my.emagiz.com with your own account and MFA configured.
10		-* A model in which you can create this exercise.
	10	+* Basic knowledge of the eMagiz platform
	11	+* Basic knowledge of cloud management
11	11
12		-== 2. Exercise ==
	13	+== 2. Key concepts ==
13	13
14		-In this exercise we will add a certificate and a route. Once done we press the "Apply to environment" functionality to understand that those kinds of changes are only applied once you press this button.
	15	+This microlearning centers around the apply to environment action
	16	+With "apply to environment", we mean: Actualizing all changes, with an indirect effect, within the eMagiz Cloud that were made by users on the Deploy Architecture canvas after the last press on this button
15	15
16		-To complete this exercise you need to execute the following steps:
	18	+* Apply to environment actualizes all changes with an indirect effect
	19	+* It gives you the option to change multiple things at once before applying the bulk change. This is to reduce downtime
	20	+* It ensures that the eMagiz Cloud is only affected when a user want to affect it
17	17
18		-* Navigate to Deploy -> Architecture
19		-* Enter "Start Editing" mode and open the context menu (by clicking on the white area of the canvas)
20		-* Select the certificate option and fill in the following things:
21		-** CN Name
22		-** Client Name
23		-* Save your changes on certificate level
24		-* Open the context menu again and select the route option.
25		-* Fill in the following things:
26		-** DNS Left most label
27		-** Port
28		-** Runtime(s)
29		-** Certificate to use
30		-* Save your changes
	22	+== 3. Apply to environment ==
31	31
32		-== 3. Solution ==
	24	+In this microlearning, we will focus on the "apply to environment" action. As we saw in previous microlearnings and will see in microlearnings to come with regards to cloud management is that some actions in Deploy Architecture have a direct effect (i.e. Slot Wakeup, Restart Runtime, Reset Runtime, etc.) and others have an indirect effect (i.e. Add Route, Add Certificate, Remove Runtime, etc.). For the actions that have an indirect effect on the eMagiz Cloud you need the "apply to environment" functionality to actualize the changes on the eMagiz Cloud level.
33	33
34		-* Understand that indirect changes will only be applied to your cloud once you press "Apply to environment" and confirm "Apply changes".
	26	+The Apply to environment functionality gives you:
35	35
36		-In this short movie, you will find the workout of this exercise. Take a moment to review this one and compare it to your solution.
	28	+* Apply to environment actualizes all changes with an indirect effect
	29	+* It gives you the option to change multiple things at once before applying the bulk change. This is to reduce downtime
	30	+* It ensures that the eMagiz Cloud is only affected when a user want to affect it
37	37
38		-{{video attachment="exercise-intermediate-emagiz-cloud-management-apply-to-environment.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
	32	+Below we have categorized each action to see whether they have a direct effect on the eMagiz Cloud or an Indirect effect. This is to give context per action what is the consequence of your action.
39	39
40		-)))((({{toc/}}))){{/container}}{{/container}}
	34	+| **Direct Effect** | **Indirect Effect** |
	35	+| --------------------------------------- | ----------------------------------------- |
	36	+| Restart Runtime (Not JMS) | Add Route |
	37	+| Restart Runtime (JMS) | Update Route |
	38	+| Reset Runtime (Not JMS) | Delete Route |
	39	+| Reset Runtime (JMS) | Add Certificate |
	40	+| Restart Runtime (Not JMS) | Update Certificate |
	41	+| Restart Connector Machine | Delete Certificate |
	42	+| Restart Core Machine | Add runtime to connector machine |
	43	+| Stop Connector Machine | Add runtime to core machine |
	44	+| Stop Core Machine | Remove runtime from connector machine |
	45	+| Start Connector Machine | Remove runtime from core machine |
	46	+| Start Core Machine | Update memory settings runtime (not JMS) |
	47	+| Wake up Cloud Slot | Update memory settings runtime (JMS) |
	48	+| Put Cloud Slot to sleep | Change Cloud Template |
	49	+| Clean Store |
	50	+| Upgrade Cloud Slot* |
	51	+
	52	+{{info}}~* Note that the upgrade of the cloud slot can be planned for a later moment in time.{{/info}}
	53	+
	54	+So, in short, when you execute one (or more) actions on Deploy Architecture that have an indirect effect, you need to press Apply to Environment to actualize the changes within the eMagiz Cloud. Note that each move, whether it is direct or indirect, will cause a reaction and subsequent change within the eMagiz Cloud. So be cautious about changing things too many times over. Make sure you are especially careful when using custom folders on runtime level, as they could be deleted and recreated in cases where the machine is recreated. To safeguard yourself against this, place the folder either inside the data folder or directly on efs. Furthermore, we advise stopping the processes that have such custom folders before executing the change. This is especially relevant in the Production environment.
	55	+
	56	+== 4. Assignment ==
	57	+
	58	+There is no assignment for this microlearning.
	59	+
	60	+== 5. Key takeaways ==
	61	+
	62	+* Apply to environment actualizes all changes with an indirect effect
	63	+* It gives you the option to change multiple things at once before applying the bulk change. This is to reduce downtime
	64	+* It ensures that the eMagiz Cloud is only affected when a user want to affect it
	65	+
	66	+== 6. Suggested Additional Readings ==
	67	+
	68	+There are no suggested additional readings on this topic
	69	+
	70	+== 7. Silent demonstration video ==
	71	+
	72	+There is no demonstration video of this functionality.)))
	73	+
	74	+((({{toc/}}))){{/container}}
	75	+{{/container}}