1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
|
# FAQ
In this document are tips and hints documented which can help for troubleshooting on RouDi.
## Does iceoryx run in a docker environment
Yes. Take a look at the [icedocker example](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_examples/icedocker)
## iox-roudi fails on startup
An error message like
```console
user@iceoryx-host:/# iox-roudi
Log level set to: [Warning]
SharedMemory still there, doing an unlink of /iceoryx_mgmt
Reserving 59736448 bytes in the shared memory [/iceoryx_mgmt]
[ Reserving shared memory successful ]
SharedMemory still there, doing an unlink of /root
Reserving 27902400 bytes in the shared memory [/root]
While setting the acquired shared memory to zero a fatal SIGBUS signal appeared
caused by memset. The shared memory object with the following properties
[ name = /root, sizeInBytes = 27902400, access mode = AccessMode::READ_WRITE,
ownership = OwnerShip::MINE, baseAddressHint = (nil), permissions = 0 ] maybe
requires more memory than it is currently available in the system.
```
indicates that there is not enough shared memory available. Check with
```console
df -H /dev/shm
```
if you have enough memory available. In this exemplary error message we require
`59736448` (iceoryx management data) + `27902400` (user samples) ~ `83.57mb`
of shared memory.
## Stack size handling
The iceoryx middleware utilize stack memory from the system for book-keeping of
internal structures.
Most Linux distributions offers 8 Megabyte of stack memory for a process which is enough
for iceoryx. You can check this with the output from `ulimit -a`.
On other platforms like windows other rules apply for the stack memory.
On windows there is [only 1 Megabyte](https://docs.microsoft.com/en-us/cpp/build/reference/stack-stack-allocations?view=msvc-170) of stack available.
Increasing the stack size generally on iceoryx is not recommended since `Roudi`
could consume lots of memory without using it.
Especially using RouDi in a multi-threaded context can run out the stack memory and
lead to memory errors.
The `Single process` example shows that when compiling and executing it on windows.
Without setting the stack size the application will throw a `Stack overflow` exception
when entering the `main()` method.
This can be solved in CMake by adding a linker flag:
```cmake
target_link_options(single_process BEFORE PRIVATE /STACK:3500000)
```
For other platforms apply other flags or solutions.
### CI fails but error is locally not reproducable
One can use `tools/scripts/ice_env.sh` to create an iceoryx development environment
with a configuration very similar to the CI target.
When for instance the target ubuntu 18.04 fails one can create a docker container
with
```sh
cd tools/scripts
./ice-env.sh enter ubuntu:18.04
```
This starts the container, installs all dependencies which iceoryx requires and enters
the environment.
### docker
When you are in a docker environment check if there is enough memory available
in your docker.
```console
# docker stats
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS
367b9fae6c2f nifty_galileo 0.00% 4.48MiB / 1GiB 0.44% 11.6kB / 0B 17.6MB / 0B 1
```
If not you can restart the docker container with `--shm-size="2g"` to increase
the total amount of available shared memory.
```console
docker run -it --shm-size="2g" ubuntu
```
## Termination of RouDi and processes
To avoid undefined behavior of iceoryx posh it is recommended to terminate RouDi and the corresponding middleware
processes with SIGINT or SIGTERM. In RouDi, we have integrated a sighandler that catches the signals and gives RouDi
the chance to exit and clean-up everything. This also applies for processes. Therefore, we recommend adding a signalhandler
to your process (see [this example](https://github.com/eclipse-iceoryx/iceoryx/blob/v2.0.0/iceoryx_examples/icedelivery/iox_publisher_untyped.cpp)).
|
