From a3335efebec5c8276d247fe98b2b3eab94d8cd62 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 09:10:04 -0400 Subject: [PATCH 1/7] DOCSP-39027: Add CMAP diagram to FAQ page --- source/faq.txt | 6 +++++- source/includes/figures/CMAP_diagram.svg | 4 ++++ 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 source/includes/figures/CMAP_diagram.svg diff --git a/source/faq.txt b/source/faq.txt index 5c519e5a..9be3f800 100644 --- a/source/faq.txt +++ b/source/faq.txt @@ -44,7 +44,11 @@ support concurrent MongoDB operations in your multi-threaded application. The maximum size of each connection pool is set by the ``MaxConnectionPoolSize`` option, which defaults to ``100``. If the number of in-use connections to a server reaches the value of ``MaxConnectionPoolSize``, the next request to that server will wait -until a connection becomes available. +until a connection becomes available. The following diagram illustrates a high-level view +of the ``MongoClient``'s connection pool functionality. + +.. figure:: /includes/figures/CMAP_diagram.svg + :alt: CMAP diagram In addition to the sockets needed to support your application's threads, each ``MongoClient`` instance opens two additional sockets per server diff --git a/source/includes/figures/CMAP_diagram.svg b/source/includes/figures/CMAP_diagram.svg new file mode 100644 index 00000000..9239d47e --- /dev/null +++ b/source/includes/figures/CMAP_diagram.svg @@ -0,0 +1,4 @@ + + + +
Connection
Pool
(default size = 100)
Database
connections
Implements
Client
Application
MongoClient
Database
 \ No newline at end of file From 5175aab561f55d16407df0b94fc4d3d87bfeb498 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 09:43:59 -0400 Subject: [PATCH 2/7] Fix --- source/faq.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/faq.txt b/source/faq.txt index 9be3f800..0515859c 100644 --- a/source/faq.txt +++ b/source/faq.txt @@ -45,7 +45,7 @@ The maximum size of each connection pool is set by the ``MaxConnectionPoolSize`` defaults to ``100``. If the number of in-use connections to a server reaches the value of ``MaxConnectionPoolSize``, the next request to that server will wait until a connection becomes available. The following diagram illustrates a high-level view -of the ``MongoClient``'s connection pool functionality. +of the ``MongoClient``'s connection pool functionality: .. figure:: /includes/figures/CMAP_diagram.svg :alt: CMAP diagram From 9e1387bb0b01c60aebb19d9ed94460aeb026b271 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 12:39:24 -0400 Subject: [PATCH 3/7] Update diagram icons --- source/includes/figures/CMAP_diagram.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/figures/CMAP_diagram.svg b/source/includes/figures/CMAP_diagram.svg index 9239d47e..22726853 100644 --- a/source/includes/figures/CMAP_diagram.svg +++ b/source/includes/figures/CMAP_diagram.svg @@ -1,4 +1,4 @@ -
Connection
Pool
(default size = 100)
Database
connections
Implements
Client
Application
MongoClient
Database
 \ No newline at end of file +
Connection
Pool
(default size = 100)
Database
connections
Implements
Database
Client
Application
MongoClient
 \ No newline at end of file From 034c250b84c550e2e878008b86b9ed879ac4d700 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 12:40:57 -0400 Subject: [PATCH 4/7] Fix wording --- source/faq.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/faq.txt b/source/faq.txt index 0515859c..4cd9c184 100644 --- a/source/faq.txt +++ b/source/faq.txt @@ -45,7 +45,7 @@ The maximum size of each connection pool is set by the ``MaxConnectionPoolSize`` defaults to ``100``. If the number of in-use connections to a server reaches the value of ``MaxConnectionPoolSize``, the next request to that server will wait until a connection becomes available. The following diagram illustrates a high-level view -of the ``MongoClient``'s connection pool functionality: +of how the ``MongoClient`` manages a connection pool: .. figure:: /includes/figures/CMAP_diagram.svg :alt: CMAP diagram From 34a29f5568aa9e82b777e1c3abd0940d2f52ce42 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 13:19:11 -0400 Subject: [PATCH 5/7] Add extra wording to diagram --- source/includes/figures/CMAP_diagram.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/figures/CMAP_diagram.svg b/source/includes/figures/CMAP_diagram.svg index 22726853..13a007c3 100644 --- a/source/includes/figures/CMAP_diagram.svg +++ b/source/includes/figures/CMAP_diagram.svg @@ -1,4 +1,4 @@ -
Connection
Pool
(default size = 100)
Database
connections
Implements
Database
Client
Application
MongoClient
 \ No newline at end of file +
Connection
Pool
(default size = 100)
Database
connections
Implements
Database
Client
Application
MongoClient
Maintains
 \ No newline at end of file From b52a8239e741ae95edd1885cb9903414e5f40fe2 Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Wed, 8 May 2024 14:15:39 -0400 Subject: [PATCH 6/7] Further diagram modifications --- source/includes/figures/CMAP_diagram.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/figures/CMAP_diagram.svg b/source/includes/figures/CMAP_diagram.svg index 13a007c3..79ac54a2 100644 --- a/source/includes/figures/CMAP_diagram.svg +++ b/source/includes/figures/CMAP_diagram.svg @@ -1,4 +1,4 @@ -
Connection
Pool
(default size = 100)
Database
connections
Implements
Database
Client
Application
MongoClient
Maintains
 \ No newline at end of file +
Implements
Database
Client
Application
MongoClient











Connection Pool
(default size = 100)







Connection
Connection
Connection
 \ No newline at end of file From 88da7d40797cb584e45c6ff39b5621f3b51bb8de Mon Sep 17 00:00:00 2001 From: Michael Morisi Date: Thu, 9 May 2024 15:25:04 -0400 Subject: [PATCH 7/7] Address Rishit's feedback on diagram --- source/includes/figures/CMAP_diagram.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/includes/figures/CMAP_diagram.svg b/source/includes/figures/CMAP_diagram.svg index 79ac54a2..ba552c58 100644 --- a/source/includes/figures/CMAP_diagram.svg +++ b/source/includes/figures/CMAP_diagram.svg @@ -1,4 +1,4 @@ -
Implements
Database
Client
Application
MongoClient











Connection Pool
(default size = 100)







Connection
Connection
Connection
 \ No newline at end of file +
Implements
Database
Application
MongoClient











Connection Pool
(default size = 100)







Connection
Connection
Connection
 \ No newline at end of file