[DRIVERS-1942] Clarify clearing behavior for load balanced pools Created: 05/Oct/21  Updated: 29/Apr/22

Status: Implementing
Project: Drivers
Component/s: CMAP, Load Balancer
Fix Version/s: None

Type: Spec Change Priority: Unknown
Reporter: Patrick Freed Assignee: Boris Dogadov
Resolution: Unresolved Votes: 1
Labels: size-small, spec-change
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Issue split
split to PYTHON-2933 Clarify clearing behavior for load ba... Backlog
split to CDRIVER-4180 Clarify clearing behavior for load ba... Backlog
split to CXX-2384 Clarify clearing behavior for load ba... Backlog
split to NODE-3657 Clarify clearing behavior for load ba... Closed
split to CSHARP-3892 Clarify clearing behavior for load ba... Closed
split to GODRIVER-2177 Clarify clearing behavior for load ba... Closed
split to JAVA-4332 Clarify clearing behavior for load ba... Closed
split to MOTOR-828 Clarify clearing behavior for load ba... Closed
split to PHPLIB-731 Clarify clearing behavior for load ba... Closed
split to RUBY-2804 Clarify clearing behavior for load ba... Closed
split to RUST-1043 Clarify clearing behavior for load ba... Closed
Problem/Incident
causes DRIVERS-2236 CMAP inconsistency when clearing load... Closed
Driver Changes: Needed
Downstream Changes Summary:

Added clarification of pool "Clear" behavior in load balancer mode.
Drivers should verify that the pool is not paused and WaitQueue is not cleared by "Clear" method in load balancer mode.

Driver Compliance:
Key Status/Resolution FixVersion
CDRIVER-4180 Backlog
CXX-2384 Backlog
CSHARP-3892 Works as Designed
GODRIVER-2177 Done
JAVA-4332 Done
NODE-3657 Fixed 4.10.0
PHPLIB-731 Won't Do
PYTHON-2933 Backlog
MOTOR-828 Duplicate
RUBY-2804 Fixed 2.19.0
RUST-1043 Works as Designed
SWIFT-1366 Duplicate

 Description   

Summary

The CMAP spec currently requires that pools are marked as paused after being cleared, regardless of whether the pool is associated with a load balancer or not. The benefits of pausing the pool / clearing the WaitQueue aren't present when the endpoint is a load balancer though, so we should update the spec wording accordingly.

Motivation

Who is the affected end user?

Driver authors, potentially users depending on drivers' implementations.

How does this affect the end user?

Unclear, depends on drivers' implementations.

How likely is it that this problem or use case will occur?

Unclear, depends on drivers' implementations.

If the problem does occur, what are the consequences and how severe are they?

Unclear, depends on drivers' implementations.

Is this issue urgent?

It will help drivers implement DRIVERS-781 and avoid potential bugs.

Is this ticket required by a downstream team?

No

Is this ticket only for tests?

No



 Comments   
Comment by Githook User [ 13/Jan/22 ]

Author:

{'name': 'Boris', 'email': 'boris.dogadov@mongodb.com', 'username': 'BorisDog'}

Message: DRIVERS-1942: Clarify clearing behaviour for load balanced pools
Branch: master
https://github.com/mongodb/specifications/commit/b4423500b018352227b7df8d21b36681db0ad58a

Generated at Thu Feb 08 08:24:20 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.