From 8cc3c0128539b0927499d5abd6de8505e4d1124a Mon Sep 17 00:00:00 2001
From: Saw-jan <saw.jan.grg3e@gmail.com>
Date: Tue, 8 Feb 2022 12:44:20 +0545
Subject: [PATCH] add doc for running parallel deployment acceptance tests
 locally

---
 docs/ocis/development/testing.md | 47 ++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/docs/ocis/development/testing.md b/docs/ocis/development/testing.md
index 60a68c4763..fbc2402843 100644
--- a/docs/ocis/development/testing.md
+++ b/docs/ocis/development/testing.md
@@ -166,3 +166,50 @@ If you want to work on a specific issue
 5. go back to 2. and repeat till the tests are passing.
 6. remove those tests from the expected failures file
 7. make a PR that has the fixed code, and the relevant lines removed from the expected failures file.
+
+## Running tests for parallel deployment
+
+### Setup the parallel deployment environment
+
+Instruction on setup is available [here](https://owncloud.dev/ocis/deployment/oc10_ocis_parallel/#local-setup)
+
+Start the docker stack with the following command:
+
+```bash
+PROXY_ENABLE_BASIC_AUTH=true docker-compose up -d
+```
+
+**NOTE**: `PROXY_ENABLE_BASIC_AUTH=true` is required as the tests use basic auth.
+
+### Getting the test helpers
+
+All the test helpers are located in the core repo.
+
+```bash
+git clone https://github.com/owncloud/core.git
+```
+
+### Run the acceptance tests
+
+Run the acceptance tests with the following command from the root of the oCIS repository:
+
+```bash
+make test-paralleldeployment-api \
+TEST_SERVER_URL="https://cloud.owncloud.test" \
+TEST_OC10_URL="http://localhost:8080" \
+TEST_PARALLEL_DEPLOYMENT=true \
+TEST_OCIS=true \
+TEST_WITH_LDAP=true \
+PATH_TO_CORE="<path_to_core>" \
+SKELETON_DIR="<path_to_core>/apps/testing/data/apiSkeleton"
+```
+
+Replace `<path_to_core>` with the actual path to the root directory of core repo that you have cloned earlier.
+
+In order to run a single test, use `BEHAT_FEATURE` environment variable.
+
+```bash
+make test-paralleldeployment-api \
+... \
+BEHAT_FEATURE="tests/parallelDeployAcceptance/features/apiShareManagement/acceptShares.feature"
+```