l2-nfapi-simulator/l2-nfapi-simulator-w-S1-same-machine.md

@@ -299,20 +299,26 @@ We do recommend the redirection in steady mode once your setup is correct.
 
 # 11. Start the UE #
 
+Important information: in an earlier version, it has been recommended to start
+as many UE threads as UEs present in the simulator. This is not recommended
+anymore, since multiple threads will execute the higher layers at the same
+time, leading to races and segfaults. Instead, **you should only start one
+thread** using the switch `--nums_ue_thread 1` or leave it out as below since 1
+is the default.
+
 In the second terminal (the one you used to build the UE):
 
 ```bash
 $ ssh sudousername@machineB
 $ cd ue_folder/cmake_targets
 # Test 64 UEs, 64 threads in FDD mode
-$ sudo -E ./lte_build_oai/build/lte-uesoftmodem -O ../ci-scripts/conf_files/ue.nfapi.conf --L2-emul 3 --num-ues 64 --nums_ue_thread 64 > ue.log 2>&1
+$ sudo -E ./lte_build_oai/build/lte-uesoftmodem -O ../ci-scripts/conf_files/ue.nfapi.conf --L2-emul 3 --num-ues 64 > ue.log 2>&1
 # Test 64 UEs, 64 threads in TDD mode
-$ sudo -E ./lte_build_oai/build/lte-uesoftmodem -O ../ci-scripts/conf_files/ue.nfapi.conf --L2-emul 3 --num-ues 64 --nums_ue_thread 64 -T 1 > ue.log 2>&1
+$ sudo -E ./lte_build_oai/build/lte-uesoftmodem -O ../ci-scripts/conf_files/ue.nfapi.conf --L2-emul 3 --num-ues 64 -T 1 > ue.log 2>&1
 # The "-T 1" option means TDD config
 ```
 
 -   The number of UEs can set by using `--num-ues` option and the maximum UE number is 255 (with the `--mu*` options, otherwise 16).
--   The umber of threads can set with the `--nums-ue-thread`. This number **SHALL NOT** be greater than the number of UEs.
 -   How many UE that can be tested depends on hardware (server , PC, etc) performance in your environment.
 
 # 12. Test with ping #
@@ -329,4 +335,5 @@ $ ping -c 20 192.168.200.4
 
 # 13. Limitations #
 
-Testing on the CI process is currently limited at time of writing. Improvements will be made soon.
+Testing on the CI process is currently limited at time of writing: it is only
+tested with up to four phones.