Wiki source code of Runtime Overview Exit codes

Last modified by Carlijn Kokkeler on 2024/09/17 15:13

Show last authors
1 {{container}}{{container layoutStyle="columns"}}(((
2 In this document, we will use the information from the actual root cause analysis to make a generic view that can be used if you run into the same or a similar problem in the future. The focus will be on providing insights into what is an exit code, the main exit codes returned by a container when it stops and how can that help you to resolve your problem.
3
4 Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5
6 == 1. Key concepts ==
7
8 In a previous [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.Runtime Overview||target="blank"]] we explained that a container can have multiple statuses. Among these, there is the status Exit which is returned by the container uppon stopping and comes together with a code. The exit code usually points out the reason why the container stopped. In the section below we describe the most common exit codes that you can encounter in eMagiz.
9
10 [[image:Main.Images.RCA-Knowledgebase.WebHome@rca-knowledgebase-runtime-overview-exit-codes.png]]
11
12 == 2. Exit code values ==
13
14 * Exited with code **0**
15 ** The application inside the container completed its work successfully without any errors.
16
17 * Exited with code **1**
18 ** There was a general error in the application, which could be due to a variety of reasons like incorrect arguments or a failed dependency.
19 ** For example when you are missing a property value.
20
21 * Exited with code **125**
22 ** The docker run command was not executed successfully.
23 ** This usually occurs when eMagiz fails to execute a certain command on that container, e.g. Start, Stop.
24
25 * Exited with code **126**
26 ** The command inside the container was found but cannot be executed. This can be due to permission issues or if the command is not executable.
27 ** For example, when eMagiz is running on premises and the permissions are incorrectly configured.
28
29 * Exited with code **127**
30 ** The command was not found. This usually happens if a script is missing or the path is not set correctly.
31
32 * Exited with code **137**
33 ** The container was forcefully stopped
34 ** This happens when the container exceeds its memory resource limit (OOM).
35
36 * Exited with code **139**
37 ** The application inside the container crashed due to a segmentation fault, which is usually caused by accessing memory that the process does not have permission to access.
38
39 * Exited with code **143**
40 ** The container stopped gracefully after receiving the operating system's SIGTERM signal, which instructs the container to do so.
41 ** For example, when you command the container to stop via Deploy Architecture or when eMagiz stops the container, e.g. Stop Machine deployment step.
42
43 * Exited with code **255**
44 ** Container exited, returning an exit code outside the acceptable range, meaning the cause of the error is not known.
45
46 == 3. Suggested Additional Readings ==
47
48 * [[Crash Courses (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]]
49 ** [[Crash Course Platform (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.WebHome||target="blank"]]
50 *** [[Runtime Overview>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-runtime-overview||target="blank"]]
51 * [[Runtime Overview (Search Result)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22runtime+overview%22||target="blank"]]
52
53
54 )))((({{toc/}}))){{/container}}{{/container}}