Wiki source code of Runtime Overview Exit codes
Last modified by Carlijn Kokkeler on 2024/09/17 15:13
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{container}}{{container layoutStyle="columns"}}((( |
| |
15.1 | 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. |
| |
1.1 | 3 | |
| 4 | Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]]. | ||
| 5 | |||
| |
8.1 | 6 | == 1. Key concepts == |
| |
1.1 | 7 | |
| |
16.1 | 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. |
| |
1.1 | 9 | |
| |
11.1 | 10 | [[image:Main.Images.RCA-Knowledgebase.WebHome@rca-knowledgebase-runtime-overview-exit-codes.png]] |
| 11 | |||
| |
8.1 | 12 | == 2. Exit code values == |
| |
1.1 | 13 | |
| |
13.1 | 14 | * Exited with code **0** |
| |
14.1 | 15 | ** The application inside the container completed its work successfully without any errors. |
| |
1.1 | 16 | |
| |
13.1 | 17 | * Exited with code **1** |
| |
14.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. | ||
| |
1.1 | 20 | |
| |
13.1 | 21 | * Exited with code **125** |
| |
14.1 | 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. | ||
| |
1.1 | 24 | |
| |
13.1 | 25 | * Exited with code **126** |
| |
14.1 | 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. | ||
| |
1.1 | 28 | |
| |
13.1 | 29 | * Exited with code **127** |
| |
14.1 | 30 | ** The command was not found. This usually happens if a script is missing or the path is not set correctly. |
| |
1.1 | 31 | |
| |
13.1 | 32 | * Exited with code **137** |
| |
14.1 | 33 | ** The container was forcefully stopped |
| 34 | ** This happens when the container exceeds its memory resource limit (OOM). | ||
| |
1.1 | 35 | |
| |
13.1 | 36 | * Exited with code **139** |
| |
14.1 | 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. |
| |
9.1 | 38 | |
| |
13.1 | 39 | * Exited with code **143** |
| |
17.1 | 40 | ** The container stopped gracefully after receiving the operating system's SIGTERM signal, which instructs the container to do so. |
| |
14.1 | 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. |
| |
12.1 | 42 | |
| |
13.1 | 43 | * Exited with code **255** |
| |
14.1 | 44 | ** Container exited, returning an exit code outside the acceptable range, meaning the cause of the error is not known. |
| |
1.1 | 45 | |
| |
19.1 | 46 | == 3. Suggested Additional Readings == |
| |
1.1 | 47 | |
| |
19.1 | 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"]] | ||
| |
21.1 | 50 | *** [[Runtime Overview>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-runtime-overview||target="blank"]] |
| |
19.1 | 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"]] |
| |
1.1 | 52 | |
| 53 | |||
| 54 | )))((({{toc/}}))){{/container}}{{/container}} |