SUREFIRE-1136 Current working directory propagation in forked mode - add documentation.
Project: http://git-wip-us.apache.org/repos/asf/maven-surefire/repo Commit: http://git-wip-us.apache.org/repos/asf/maven-surefire/commit/2b4629c7 Tree: http://git-wip-us.apache.org/repos/asf/maven-surefire/tree/2b4629c7 Diff: http://git-wip-us.apache.org/repos/asf/maven-surefire/diff/2b4629c7 Branch: refs/heads/master Commit: 2b4629c71e5c82716d99a738f02063c90413253f Parents: 9a8bb17 Author: Norbert Wnuk <norbert.w...@sabre.com> Authored: Sat Jan 31 21:57:46 2015 +0100 Committer: Norbert Wnuk <norbert.w...@sabre.com> Committed: Sat Jan 31 22:21:55 2015 +0100 ---------------------------------------------------------------------- .../examples/fork-options-and-parallel-execution.apt.vm | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/maven-surefire/blob/2b4629c7/maven-surefire-plugin/src/site/apt/examples/fork-options-and-parallel-execution.apt.vm ---------------------------------------------------------------------- diff --git a/maven-surefire-plugin/src/site/apt/examples/fork-options-and-parallel-execution.apt.vm b/maven-surefire-plugin/src/site/apt/examples/fork-options-and-parallel-execution.apt.vm index 6b9d046..271f58c 100644 --- a/maven-surefire-plugin/src/site/apt/examples/fork-options-and-parallel-execution.apt.vm +++ b/maven-surefire-plugin/src/site/apt/examples/fork-options-and-parallel-execution.apt.vm @@ -190,7 +190,8 @@ Fork Options and Parallel Test Execution <databaseSchema> is passed to the processes, that shall specify the database schema to use during the tests. The values for that will be <MY_TEST_SCHEMA_1>, <MY_TEST_SCHEMA_2>, and <MY_TEST_SCHEMA_3> for the three - processes. + processes. Additionaly by specifying custom <workingDirectory> each of processes + will be executed in a separate working directory to ensure isolation on file system level. +---+ <plugins> @@ -206,6 +207,7 @@ Fork Options and Parallel Test Execution <systemPropertyVariables> <databaseSchema>MY_TEST_SCHEMA_${surefire.forkNumber}</databaseSchema> </systemPropertyVariables> + <workingDirectory>FORK_DIRECTORY_${surefire.forkNumber}</workingDirectory> </configuration> </plugin> [...] @@ -270,3 +272,10 @@ Fork Options and Parallel Test Execution | had that one set) | *--------------------------+-------------------------------------------+ +* Known issues and limitations + + * <<<$\{surefire.forkNumber\}>>> propagation is not supported on Maven 2.x + (the variable will be resolved to null value all the time) + + * <<<$\{surefire.forkNumber\}>>> is properly propagated within <<<workingDirectory>>> since Surefire 2.19, + more details in {{{https://jira.codehaus.org/browse/SUREFIRE-1136}SUREFIRE-1136}}