Wiki source code of Reset Runtime
Last modified by Danniar Firdausy on 2024/09/19 10:02
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | {{container}} | ||
2 | {{container layoutStyle="columns"}} | ||
3 | ((( | ||
4 | In the previous [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-emagiz-runtime-management-restart-runtime.WebHome||target="blank"]], we covered how to restart runtimes without affecting their underlying data or configurations. This time, we will delve into the process of resetting a runtime, which is a more thorough approach that essentially starts from scratch. We will explore when and why a reset might be necessary, and how it differs from a restart. Resetting a runtime can be particularly useful in cases of memory issues or during major updates. Let’s get started! | ||
5 | |||
6 | Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]]. | ||
7 | |||
8 | == 1. Prerequisites == | ||
9 | |||
10 | * Intermediate knowledge of the eMagiz platform | ||
11 | * Intermediate knowledge of runtime management | ||
12 | |||
13 | == 2. Key concepts == | ||
14 | |||
15 | This microlearning centers around resetting a runtime. | ||
16 | * With resetting, we mean: Ensure that we begin with a clean slate and forget about what happened before | ||
17 | |||
18 | == 3. Reset runtime == | ||
19 | |||
20 | In the previous [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-emagiz-runtime-management-restart-runtime.WebHome||target="blank"]], we learned about restarting runtimes. In that [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-emagiz-runtime-management-restart-runtime.WebHome||target="blank"]], we learned that restarting the runtime does not affect flows, data, psychical hardware, or otherwise. It is simply jump-starting the runtime or machine once more. In this microlearning, however, we will focus on the action to reset a runtime. A reset on the other hand is the more aggressive approach and does have a significant effect. In other words, the main difference is that with a reset you begin with a clean slate compared to the simple restart. | ||
21 | |||
22 | Having said that there are some cases where it can become beneficial to reset a runtime. For instance when running into memory issues or when doing large bulk build number upgrades. | ||
23 | |||
24 | In short, the reset action can be described by the following: | ||
25 | |||
26 | * A reset is the more aggressive approach compared to a restart. | ||
27 | * The reset does the following on runtime level: | ||
28 | ** Stops the runtime service (if running) | ||
29 | ** Removes data (except Artemis folder + revision info) | ||
30 | ** Removes local repository folder | ||
31 | ** Starts the runtime service (if stopped at step 1) | ||
32 | * With a reset, you start with a clean slate | ||
33 | ** Flow version could be different based on changes in the release | ||
34 | ** Custom H2 database is emptied | ||
35 | |||
36 | To execute this action please navigate to Deploy -> Architecture (if you are not there already). After you have done so you can access the context menu of a particular runtime (via a right mouse click), while in "Start Editing" mode, and select the option called "Reset runtime". | ||
37 | |||
38 | [[image:Main.Images.Microlearning.WebHome@intermediate-emagiz-runtime-management-reset-runtime--context-menu-reset-runtime.png]] | ||
39 | |||
40 | By pressing this button your executes all steps mentioned above. | ||
41 | |||
42 | To verify that everything went correctly and your runtime is running correctly you can access the details pop-up on Architecture level. In here you can access the "Status" tab to check the status of your runtime. | ||
43 | |||
44 | [[image:Main.Images.Microlearning.WebHome@intermediate-emagiz-runtime-management-reset-runtime--context-menu-details-runtime-status-tab.png]] | ||
45 | |||
46 | Subsequently you can double check this by looking at the logs under Manage -> Log Entries. | ||
47 | |||
48 | {{warning}}Note that when you have a custom H2 database on runtime level (i.e. for storing metadata) the H2 database will be deleted as well when you remove the runtime. To safeguard against this you could store your H2 database on EFS. Please take a look at the help text for the URL field on the JDBC H2 connection pool component for more information. | ||
49 | |||
50 | [[image:Main.Images.Microlearning.WebHome@intermediate-emagiz-runtime-management-reset-runtime--help-text-h2-efs.png]]{{/warning}} | ||
51 | |||
52 | == 4. Key takeaways == | ||
53 | |||
54 | * A reset is a more aggresive action compared to a restart. While a restart simply reboots the runtime without affecting its data or configuration, a reset clears out data and settings, effectively starting with a clean slate. | ||
55 | * The reset does the following on the cloud level: | ||
56 | ** Stops the runtime service (if it’s running). | ||
57 | ** Removes most runtime data (excluding the Artemis folder and revision information). | ||
58 | ** Removes the local repository folder. | ||
59 | ** Restarts the runtime service (if it was stopped at Step 1). | ||
60 | * After a reset, you will: | ||
61 | ** Begin with a fresh state, which might include different flow versions depending on changes in the release. | ||
62 | ** Have an emptied custom H2 database. | ||
63 | * Consider resetting a runtime if you encounter memory issues or need to perform significant updates. | ||
64 | |||
65 | == 5. Suggested Additional Readings == | ||
66 | |||
67 | If you are interested in this topic and want more information, please read the help text provided by eMagiz and check out these links: | ||
68 | |||
69 | * [[Intermediate Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.WebHome||target="blank"]] | ||
70 | ** [[eMagiz Runtime Management (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.WebHome||target="blank"]] | ||
71 | *** [[Restart Runtime (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-emagiz-runtime-management-restart-runtime.WebHome||target="blank"]] | ||
72 | *** [[Reset H2 Database (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-runtime-management-reset-h2.WebHome||target="blank"]] | ||
73 | * [[Advanced Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.WebHome||target="blank"]] | ||
74 | ** [[Key Concepts (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Key Concepts.WebHome||target="blank"]] | ||
75 | *** [[What data is stored on runtime level (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.Key Concepts.advanced-key-platform-concepts-what-data-is-stored-on-runtime-level||target="blank"]] | ||
76 | * [[Expert Level (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.WebHome||target="blank"]] | ||
77 | ** [[Recovery Guide (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Recovery Guide.WebHome||target="blank"]] | ||
78 | *** [[Signal received - Recovery Needed (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Recovery Guide.expert-recovery-guide-signals-reproducable-steps||target="blank"]] | ||
79 | ** [[eMagiz Cloud Management (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.eMagiz Cloud Management.WebHome||target="blank"]] | ||
80 | ** [[Clean Store (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.eMagiz Cloud Management.expert-emagiz-cloud-management-clean-store||target="blank"]] | ||
81 | * [[Reset Runtime (Search Results)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&l_space_facet=10&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22reset+runtime%22||target="blank"]] | ||
82 | |||
83 | ))) | ||
84 | ((({{toc/}}))){{/container}} | ||
85 | {{/container}} |