Skip to content

Commit c8e662f

Browse files
committed
Fix test suite docs for running parallel tests
The guide for running the test suite in parallel is out of date as we no longer use `PARALLEL=true` and simply use the `parallel` gem's rake tasks out of the box.
1 parent 9ecc6c6 commit c8e662f

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

developer_setup/running_test_suites.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,24 @@ Running tests in parallel requires as many different databases as cores you plan
3939
To set up these databases, simply execute the following command:
4040

4141
```
42-
$ PARALLEL=true bin/rake test:vmdb:setup
42+
$ bin/rake parallel:rake[test:vmdb:setup]
4343
```
4444

45+
Depending on how many cores you have you might hit
46+
```
47+
Caused by:
48+
PG::OutOfMemory: ERROR: out of shared memory (PG::OutOfMemory)
49+
HINT: You might need to increase "max_locks_per_transaction".
50+
```
51+
52+
If this is the case simply edit your `main/postgresql.conf` conf file to increase the `max_locks_per_transaction` value and restart postgresql.
53+
4554
#### Run the entire suite in parallel
4655

4756
You can run the entire suite in parallel using the following command:
4857

4958
```
50-
$ PARALLEL=true bin/rake test:vmdb
59+
$ bin/rake parallel:spec
5160
```
5261

5362
#### Passing RSpec options to the rake tasks
@@ -60,7 +69,7 @@ For example, I may wish to set a particular seed and stop running the tests
6069
immediately on a failure:
6170

6271
```
63-
$ PARALLEL=true SPEC_OPTS="--seed 1234 --fail-fast" bin/rake test:vmdb:setup
72+
$ SPEC_OPTS="--seed 1234 --fail-fast" rake parallel:spec
6473
```
6574

6675
Note that `--fail-fast` will stop whichever core encountered the error, not

0 commit comments

Comments
 (0)