Last modified by Erik Bakker on 2024/02/22 12:20
Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2
3 {{error}}
4 Note that the functionality mentioned in this microlearning will become obsolete when migrating to the 3rd generation runtime.
5 {{/error}}
6
7 Sometimes you have runtimes running on-premises. What we mean by that is that the runtimes are running within a data center of the customer instead of running in the eMagiz Cloud. For running a runtime on-premise we support running them on either Windows or Linux as the operating system. In this microlearning, we will learn how you can edit the memory settings of a runtime that is deployed on-premise on Linux.
8
9 Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
10
11 == 1. Prerequisites ==
12 * Basic knowledge of the eMagiz platform
13
14 == 2. Key concepts ==
15 This microlearning centers on editing the memory settings for an on-premise runtime that is running on Linux. With an on-premise runtime we mean: A runtime that is running within a data center of the customer instead of running in the eMagiz Cloud
16
17 The focal point of this microlearning will be to learn how you can safely edit the memory settings for an on-premise runtime running on Linux
18
19 * The key aspects are:
20 ** eMagiz can help you determine the correct size you need to configure via Design *> Architecture
21 ** You need access to the on-premise location to perform the action
22 ** Only change the wrapper.conf file. Nothing else
23
24 == 3. Edit memory for on-premise runtime (Linux) ==
25
26 Sometimes you have runtimes running on-premises. What we mean by that is that the runtimes are running within a data center of the customer instead of running in the eMagiz Cloud. For running a runtime on-premise we support running them on either Windows or Linux as the operating system. In this microlearning, we will learn how you can edit the memory settings of a runtime that is deployed on-premise.
27
28 The focal point of this microlearning will be to learn how you can safely edit the memory settings for an on-premise runtime.
29
30 * The key aspects are:
31 ** eMagiz can help you determine the correct size you need to configure via Design *> Architecture
32 ** You need access to the on-premise location to perform the action
33 ** Only change the wrapper.conf file. Nothing else
34
35 === 3.1 Check adviced size ===
36
37 Within Design Architecture you can see for each connector runtime what the advised sizing of eMagiz is based on how you have configured your integration data model. To do so navigate to Design *> Architecture and open the context menu on connector runtime level via a right mouse click.
38
39 [[image:Main.Images.Microlearning.WebHome@intermediate-solution-architecture-edit-memory-on-premise-runtime-windows--context-menu-view.png]]
40
41 When selecting the option View container a pop*up will be shown. Within this pop*up, you will see the advised heap and non*heap memory settings of that particular runtime.
42
43 [[image:Main.Images.Microlearning.WebHome@intermediate-solution-architecture-edit-memory-on-premise-runtime-windows--pop-up-details.png]]
44
45 === 3.2 Edit memory on Linux based runtimes ===
46
47 Now that we know what the advised size is we can navigate to our on-premise installation location to edit the memory settings. Below we will detail the various steps needed to make this happen.
48
49 * Log in via Putty by typing in the host and the port and press load
50 * When asked for credentials fill in credentials (Be aware, Linux does not acceapt ctrl+v and does not show the password or an indication of the password). Right mouse click to copy the password and press enter
51 * Navigate to the directory where you have installed the runtime (Command is: cd {directory structure})
52 * Open the folder related to the runtime you want to change (Command is: cd emagiz_{technicalbusname}-{containertype}-{techincalnameruntime}_{environment}).
53 * Open the etc folder within your runtime installation (Command is: cd etc)
54 * Type in the following command: sudo vi emagiz and press Tab. This way Linux should auto suggest the so called wrapper.conf to be edited and press Enter if so
55 * Type "i" to enter insert mode
56 * Change the values of heap and or metaspace memory you want to change (you can navigate through the document with your arrow keys)
57 * Press ESC and then type ":wq!" then press Enter to save the changes and exit Edit mode. Note: If you would like to exit the file without making any changes press ESC, then type ":q!" and press Enter
58 * Restart the runtime by executing the correct restart command:
59 ** systemd type: sudo systemctl restart <SERVICE_NAME>
60 ** SystemV Type: sudo /etc/init.d/<SERVICE_NAME>-service restart
61
62 == 4. Key takeaways ==
63
64 * The key aspects are:
65 ** eMagiz can help you determine the correct size you need to configure via Design *> Architecture
66 ** You need access to the on-premise location to perform the action
67 ** Only change the wrapper.conf file. Nothing else
68
69 == 5. Suggested Additional Readings ==
70
71 None)))((({{toc/}}))){{/container}}{{/container}}