From 853bc808bb26e8e0a4e2d6887b4e8d7bc6e3f76d Mon Sep 17 00:00:00 2001 From: Nic Di Noia Date: Tue, 26 Feb 2019 06:48:12 -0500 Subject: [PATCH] Update parallel-tests.md (#12222) Add a warning about Jenkins ProcessTreeKiller --- docs/en/advanced-concepts/parallel-tests.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/en/advanced-concepts/parallel-tests.md b/docs/en/advanced-concepts/parallel-tests.md index 75f800337..22d0c9db2 100644 --- a/docs/en/advanced-concepts/parallel-tests.md +++ b/docs/en/advanced-concepts/parallel-tests.md @@ -35,3 +35,10 @@ Refer: https://github.com/appium/appium/issues/9209 - `udid` the device id - `wdaLocalPort` unique wdaPort, as WDA defaults to 8100 - `webkitDebugProxyPort` unique webKitProxy, as IWDP defaults to 27753 + +### Troubleshooting + +When running on Jenkins, watch out for the [ProcessTreeKiller](https://wiki.jenkins.io/display/JENKINS/ProcessTreeKiller) when running multiple parallel test jobs on the same machine. If you are spawning simulators in one test job, Jenkins might kill all your simulators when the first test ends - causing errors in the remaining test jobs! + +Use `BUILD_ID=dontKillMe` to prevent this from happening. +