Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(NODE-5730): update load balancer docs #3910

Merged
merged 4 commits into from
Nov 8, 2023
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 21 additions & 2 deletions test/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -284,14 +284,33 @@ The following steps will walk you through how to start and test a load balancer.
```

Create two mongoses running on ports 27017 and 27018:
`mongos --configdb test/localhost:27217 --bind_ip localhost --setParameter enableTestCommands=1 --setParameter featureFlagLoadBalancer=true --setParameter loadBalancerPort=27050`
`mongos --configdb test/localhost:27217 --port 27018 --bind_ip localhost --setParameter enableTestCommands=1 --setParameter featureFlagLoadBalancer=true --setParameter loadBalancerPort=27051`.
`mongos --configdb test/localhost:27217 --bind_ip localhost --setParameter enableTestCommands=1 --setParameter --setParameter loadBalancerPort=27050`
durran marked this conversation as resolved.
Show resolved Hide resolved
`mongos --configdb test/localhost:27217 --port 27018 --bind_ip localhost --setParameter enableTestCommands=1 --setParameter --setParameter loadBalancerPort=27051`.

Initiate cluster on mongos in shell:
```shell
mongosh "mongodb://localhost:27017" --eval "sh.addShard('testing/localhost:27218,localhost:27219,localhost:27220')"
mongosh "mongodb://localhost:27017" --eval "sh.enableSharding('test')"
```
1. An alternative way to the fully manual cluster setup is to use `mlaunch`:
Initialize the sharded cluster via `mlaunch` in a new empty directory:
```shell
mlaunch init --dir data --ipv6 --replicaset --nodes 2 --port 51000 --name testing --setParameter enableTestCommands=1 --sharded 1 --mongos 2
```

`mlaunch` will then start up the sharded cluster. Once it finishes, stop the cluster:
```shell
mlaunch stop
```

When `mlaunch` has stopped the cluster, navigate to the `data` directory and edit the `.mlaunch_startup` file:
durran marked this conversation as resolved.
Show resolved Hide resolved
- Add `--setParameter \"loadBalancerPort=27050\"` to the first mongos configuration at the bottom of the file.
- Add `--setParameter \"loadBalancerPort=27051\"` to the second mongos configuration at the bottom of the file.

Navigate back up to the root directory where `mlaunch` was initialized and restart:
```shell
mlaunch start
```

1. Create an environment variable named `MONGODB_URI` that stores the URI of the sharded cluster you just created. For example: `export MONGODB_URI="mongodb://host1,host2/"`
1. Install the HAProxy load balancer. For those on macOS, you can install HAProxy with `brew install haproxy`.
Expand Down