Skip to content

Commit 64627b1

Browse files
Benjamin Délèzeomichel
andauthored
Add tips on swap (cyberbotics#5825)
* tips swap * typo * title * style * style * test * test * test * typo * typo * Update docs/guide/advanced-configuration.md Co-authored-by: Olivier Michel <Olivier.Michel@cyberbotics.com> * Update docs/guide/advanced-configuration.md Co-authored-by: Olivier Michel <Olivier.Michel@cyberbotics.com> --------- Co-authored-by: Olivier Michel <Olivier.Michel@cyberbotics.com>
1 parent 328e71c commit 64627b1

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

docs/guide/advanced-configuration.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,3 +93,45 @@ To work, your assets folder must correspond to the version of Webots that is in
9393
For more informations about assets, see [here](installation-procedure.md#asset-cache-download).
9494

9595
**Note**: This is already implemented in the Docker images provided by Cyberbotics.
96+
97+
#### Increase the Number of Parallel Simulations Supported by the Server
98+
99+
The server can become saturated because both its CPU and GPU RAM are full.
100+
What happens normally is that the GPU and CPU will grow in parallel as new simulations are added.
101+
In most cases the GPU RAM will be saturated first.
102+
Once it happens, the CPU RAM will take the share of the GPU and therefore fill up faster.
103+
Once the CPU RAM is full, the swap will take over.
104+
Once the swap is full, the computer will crash if we try to open more simulations.
105+
106+
##### Enable the Zram
107+
108+
[Zram](https://en.wikipedia.org/wiki/Zram) is a Linux kernel module that will compress the least used parts of the RAM.
109+
It has the same role as swap but is normally faster.
110+
111+
To enable it:
112+
```
113+
sudo apt-get install zram-config
114+
sudo service zram-config start
115+
```
116+
117+
To check the zram installation:
118+
```
119+
cat /proc/swaps
120+
```
121+
122+
It should display something like:
123+
```
124+
Filename Type Size Used Priority
125+
/dev/sda3 partition 9215996 0 -1
126+
/dev/zram0 partition 755740 8104 5
127+
/dev/zram1 partition 755740 8004 5
128+
/dev/zram2 partition 755740 8120 5
129+
/dev/zram3 partition 755740 8064 5
130+
```
131+
132+
#### Increase the Size of the Swap
133+
134+
Increasing the size of the swap will allow the server to support more simulations in parallel.
135+
However, when the swap is filling-up, you may observe a performance drop.
136+
137+
You can follow [this tutorial](https://linuxhandbook.com/increase-swap-ubuntu/) to increase the size of the swap.

0 commit comments

Comments
 (0)