docs: Update parallel tests setup tutorial
MODIFY
docs/en/advanced-concepts/parallel-tests.md
docs/en/advanced-concepts/parallel-tests.md
Appium provides a way for users to automate multiple Android sessions on a single machine on single server instance. All it involves is starting Appium server on any available port.
+Note, that it is not possible to have more than one session running on the *same* device.
+
The important capabilities:
- `udid` the device id
- `chromeDriverPort` the chromedriver port (if using webviews or chrome)
-- `systemPort` If you are using [appium-uiautomator2-driver](https://github.com/appium/appium-uiautomator2-driver), set a different system port for each android session, set with `systemPort` capability since sometimes there can be a port conflict if different ports aren't used, such as in [this issue](https://github.com/appium/appium/issues/7745).
+- `systemPort` If you are using [appium-uiautomator2-driver](https://github.com/appium/appium-uiautomator2-driver), set a unique system port for each parallel session. Otherwise you might get a port conflict such as in [this issue](https://github.com/appium/appium/issues/7745).
### Parallel iOS Tests
-From Xcode9, Appium supports parallel RealDevice and Simulator testing. Start your Appium Server on any available port.
+Since Xcode9, Appium supports parallel RealDevice and Simulator testing. Start your Appium Server on any available port.
The important capabilities:
#### RealDevice
-- `udid` the device id
-- `wdaLocalPort` unique wdaPort, as WDA defaults to 8100
-#### Simulator
-
-- `udid` simulator UDID,this can be retrieved from xcrun simctl list.
-- `deviceName` Simulator Name
-- `platformVersion` Simulator OS version
-- `wdaLocalPort` unique wdaPort, as WDA defaults to 8100
+- `udid` must be a unique device UDID for each parallel session
+- `wdaLocalPort` must be a unique port number for each parallel session. The default value is 8100
- `derivedDataPath` set the unique derived data path root for each driver instance. This will help to avoid possible conflicts and to speed up the parallel execution.
-Parallel Safari/Webview sessions are not working due to an Apple bug
-
-Refer: https://github.com/appium/appium/issues/9209
-
-#### Parallel Safari Real device
+#### Simulator
-- `udid` the device id
-- `wdaLocalPort` unique wdaPort, as WDA defaults to 8100
+- Either `udid`, which is the unique simulator UDID for each parallel session(this can be retrieved from xcrun simctl list) or a unique combination of `deviceName` and `platformVersion` to identify the appropriate simulator with the given name and version number for each parallel session
+- `wdaLocalPort` must be a unique port number for each parallel session. The default value is 8100
- `derivedDataPath` set the unique derived data path root for each driver instance. This will help to avoid possible conflicts and to speed up the parallel execution.
-- `webkitDebugProxyPort` unique webKitProxy, as IWDP defaults to 27753 (Does not need for XCUITest driver)
+
### Troubleshooting

docs: Update parallel tests setup tutorial (#13650)