You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: test/readme.md
+12-8Lines changed: 12 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -79,6 +79,9 @@ The actual implementations of the spec tests can be unit tests or integration te
79
79
80
80
## Running the Tests Locally
81
81
82
+
> [!NOTE]
83
+
> All scripts mentioned in the readme and in drivers-evergreen-tools expect to be run in bash. These scripts will work fine in other shells so long as they're launched with the `bash` command. The outputs of these scripts also expect the user to be running in a bash syntax-like shell; users using `fish` or shells with syntax for declaring environment variables that does not look like `export <name>=<value>` may find that they need to adapt the output of the tooling to work in their shell.
84
+
82
85
The easiest way to get started running the tests locally is to start a replica set and run all of the integration tests.
83
86
84
87
Ensure the drivers tools submodule is cloned:
@@ -112,7 +115,8 @@ Then run the tests:
112
115
npm run check:test
113
116
```
114
117
115
-
> **Note:** the command above will run a subset of the tests that work with the standalone server topology since the tests are being run against a standalone server.
118
+
> [!NOTE]
119
+
> The command above will run a subset of the tests that work with the standalone server topology since the tests are being run against a standalone server.
116
120
117
121
The output will show how many tests passed, failed, and are pending. Tests that we have indicated should be skipped using `.skip()` will appear as pending in the test results. See [Mocha's documentation][mocha-skip] for more information.
118
122
@@ -123,7 +127,7 @@ In the following subsections, we'll dig into the details of running the tests.
123
127
By default, the integration tests run with auth-enabled and the mongo orchestration script will run with auth enabled when the `AUTH` variable is set to `auth`. Tests can be run locally without auth by setting the environment variable `AUTH` to the value of `noauth`. This must be a two-step process of starting a server without auth-enabled and then running the tests without auth-enabled.
You can use the same [run-orchestration.sh](.evergreen/run-orchestration.sh) script to start a replica set or sharded cluster by passing the appropriate option:
If you are running more than a standalone server, make sure your `ulimit` settings are in accordance with [MongoDB's recommendations][mongodb-ulimit]. Changing the settings on the latest versions of macOS can be tricky. See [this article][macos-ulimt] for tips. (You likely don't need to do the complicated `maxproc` steps.)
148
152
@@ -462,7 +466,7 @@ The following steps will walk you through how to start and test a load balancer.
462
466
```
463
467
1. Start the load balancer by using the [run-load-balancer script](https://github.com/mongodb-labs/drivers-evergreen-tools/blob/master/.evergreen/run-load-balancer.sh) provided in`drivers-evergreen-tools`.
A new file name `lb-expansion.yml` will be automatically created. The contents of the file will be similar in structure to the code below.
468
472
```yaml
@@ -494,7 +498,7 @@ The following steps will walk you through how to start and test a load balancer.
494
498
Verify that the output from Mocha includes `[ topology type: load-balanced ]`. This indicates the tests successfully accessed the specialized environment variables for load balancer testing.
495
499
1. When you are done testing, shutdown the HAProxy load balancer:
0 commit comments