Merge "Document multi-cluster support"

7 files changed, 79 insertions, 0 deletions

diff --git a/docs/architecture/architecture.rst b/docs/architecture/architecture.rst
index 7edf9e07..9e999e3b 100644
--- a/docs/architecture/architecture.rst
+++ b/docs/architecture/architecture.rst
@@ -701,6 +701,79 @@ APIs. Some example PEPs are: DCAE, OOF, and SDNC.
 See Section 3.4 of the :ref:`Policy Design and Development <design-label>`
 for more information on the Decision APIs.
 
+2.3.8 Multi-Cluster Support
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Multi-cluster support was added to the Policy Framework during the Istanbul release,
+enabling redundancy, load-sharing, and inter-site failover.
+
+**Note:** *multi-cluster support has only been minimally tested, and is thus still
+experimental.*
+
+2.3.8.1 Shared DB
+"""""""""""""""""
+
+Multi-cluster support requires a shared DB.  Rather than spinning up a
+separate DB for each cluster, all of the clusters are pointed to a common DB.
+Policy-API adds policy types and policies, while Policy-PAP manages PDP Groups and
+Subgroups, as well as policy deployments.  The information in these tables is not
+segregated, but is, instead, shared across the API and PAP components across all of
+the clusters.
+
+.. image:: images/MCSharedDB.svg
+
+2.3.8.2 DMaaP Arrangement
+"""""""""""""""""""""""""
+
+As in prior releases, communication between the PAPs and PDPs still takes place via
+DMaaP.  Two arrangements, described below, are supported.
+
+2.3.8.2.1 Local DMaaP
+~~~~~~~~~~~~~~~~~~~~~
+
+In this arrangement, each cluster is associated with its own, local
+DMaaP, and communication only happens between PAPs and PDPs within the same cluster.
+
+.. image:: images/MCLocalDmaap.svg
+
+The one
+limitation with this approach is that, when a PAP in cluster A deploys a policy, PAP
+is only able to inform the PDPs in the local cluster; the PDPs in the other clusters
+are not made aware of the new deployment until they generate a heartbeat, at which
+point, their local PAP will inform them of the new deployment.  The same is true of
+changes made to the state of a PDP Group; changes only propagate to PDPs in other
+clusters in response to heartbeats generated by the PDPs.
+
+.. image:: images/MCLocalHB.svg
+
+2.3.8.2.2 Shared DMaaP
+~~~~~~~~~~~~~~~~~~~~~~
+
+In this arrangement, the PAPs and PDPs in all of the clusters are
+pointed to a common DMaaP.  Because the PAP and PDPs all communicate via the same
+DMaaP, when a PAP deploys a policy, all PDPs are made aware, rather than having to
+wait for a heartbeat.
+
+.. image:: images/MCSharedDmaap.svg
+
+2.3.8.3 Missed Heartbeat
+""""""""""""""""""""""""
+
+To manage the removal of terminated PDPs from the DB, a record, containing a
+"last-updated" timestamp, is maintained within the DB for each PDP.  Whether using a
+local or shared DMaaP, any PAP receiving a message from a PDP will update the timestamp
+in the associated record, thus keeping the records “current”.
+
+.. image:: images/MCSharedHB.svg
+
+Periodically, each PAP will sweep the DB of PDP records whose timestamp has not been
+updated recently.  The frequency with which it is checked is based on the value of
+the "heartbeatMs" configuration parameter, with a record considered expired if no
+heartbeat has been received for three cycles.
+
+.. image:: images/MCMissedHB.svg
+
+
 3. APIs Provided by the Policy Framework
 ========================================
 
diff --git a/docs/architecture/images/MCLocalDmaap.svg b/docs/architecture/images/MCLocalDmaap.svg
new file mode 100644
index 00000000..1b851223
--- /dev/null
+++ b/docs/architecture/images/MCLocalDmaap.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><rect x="133.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(207.541 198)">PAP</text><rect x="133.5" y="245.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(155.331 280)">DMaaP<tspan font-size="24" x="76.1667" y="0">Queue</tspan></text><rect x="133.5" y="485.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.114 520)">PDP A1</text><rect x="133.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.114 593)">PDP A2<tspan fill="#000000" font-size="24" x="-7.94304" y="-456">Cluster A</tspan><tspan fill="#000000" font-size="24" x="820.657" y="-456">Cluster B</tspan></text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 198)">PdpSubgroup</text><rect x="544.5" y="322.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 356)">PDP A1</text><rect x="544.5" y="390.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 424)">PDP A2</text><rect x="544.5" y="458.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 493)">PDP B1<tspan fill="#000000" font-size="24" x="-15.5099" y="-356">Shared DB</tspan></text><rect x="544.5" y="530.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 564)">PDP B2</text><rect x="133.5" y="299.5" width="185" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.081 326)">PDP A1</text><rect x="133.5" y="338.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.151 364)">PDP A2</text><rect x="133.5" y="376.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#F4B183"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(154.984 403)">PDP B1 <tspan font-size="19" x="75.6667" y="0">(discard)</tspan></text><rect x="133.5" y="414.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#F4B183"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(154.984 441)">PDP B2 <tspan font-size="19" x="75.6667" y="0">(discard)</tspan></text><path d="M327.49 190 533.184 190 533.184 191 327.49 191ZM335.238 195.599 326.498 190.5 335.238 185.401C335.477 185.262 335.783 185.343 335.922 185.581 336.061 185.82 335.981 186.126 335.742 186.265L327.742 190.932 327.742 190.068 335.742 194.735C335.981 194.874 336.061 195.18 335.922 195.419 335.783 195.657 335.477 195.738 335.238 195.599ZM525.435 185.402 534.176 190.5 525.435 195.599C525.197 195.738 524.891 195.657 524.752 195.419 524.613 195.18 524.693 194.874 524.932 194.735L532.932 190.068 532.932 190.932 524.932 186.265C524.693 186.126 524.613 185.82 524.752 185.582 524.891 185.343 525.197 185.262 525.435 185.402Z" fill="#4472C4"/><path d="M327.545 206.882 514.265 405.505 513.536 406.19 326.817 207.567ZM328.77 216.359 326.498 206.498 336.2 209.374C336.465 209.453 336.616 209.731 336.537 209.996 336.459 210.261 336.18 210.412 335.916 210.333L327.036 207.701 327.665 207.109 329.745 216.134C329.807 216.403 329.639 216.672 329.37 216.734 329.101 216.796 328.832 216.628 328.77 216.359ZM512.311 396.713 514.583 406.574 504.882 403.698C504.617 403.619 504.466 403.341 504.545 403.076 504.623 402.811 504.901 402.66 505.166 402.739L514.046 405.371 513.416 405.963 511.337 396.938C511.275 396.669 511.443 396.4 511.712 396.338 511.981 396.276 512.25 396.444 512.311 396.713Z" fill="#4472C4"/><path d="M133.184 190.5 81.5001 190.5" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M81.5001 190.5 81.5002 434" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M83.5001 318.167 126.172 318.167 126.172 318.833 83.5001 318.833ZM124.839 314.5 132.839 318.5 124.839 322.5Z" fill="#4472C4"/><path d="M369.5 319.5 369.5 584.573" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="24" transform="translate(572.277 38)">Local <tspan font-size="24" x="56.0266" y="0">DMaaP</tspan><tspan font-weight="400" font-size="24" x="-52.6201" y="29">Deploy/</tspan><tspan font-weight="400" font-size="24" x="25.0866" y="29">Undeploy</tspan><tspan font-weight="400" font-size="24" x="124.793" y="29">Policy</tspan></text><path d="M117.766 120.298 147.04 158.855 146.509 159.258 117.235 120.702ZM149.154 155.576 150.806 164.366 142.783 160.413Z" fill="#4472C4"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(85.7548 108)">Request</text><rect x="960.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1034.96 198)">PAP</text><rect x="961.5" y="245.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(982.754 280)">DMaaP<tspan font-size="24" x="76.1666" y="0">Queue</tspan></text><rect x="960.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1017.95 593)">PDP B2</text><rect x="960.5" y="299.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.06 326)">PDP B2</text><rect x="960.5" y="338.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1017.95 364)">PDP B2</text><path d="M0 0.333333-50.4489 0.333333-50.1156 0-50.1156 127.756-50.4489 127.423-6.48283 127.423-6.48283 128.09-50.7823 128.09-50.7823-0.333333 0-0.333333ZM-7.81617 123.756 0.183832 127.756-7.81617 131.756Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 960.5 314.256)"/><path d="M0 0.333333-52.4081 0.333333-52.0747 0-52.0747 267.644-52.4081 267.31-6.55673 267.31-6.55673 267.977-52.7414 267.977-52.7414-0.333333 0-0.333333ZM-7.89008 263.644 0.109921 267.644-7.89008 271.644Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 962.5 592.144)"/><path d="M0 0 47.8739 0.000104987" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(1 0 0 -1 1146.5 190.5)"/><path d="M1194.5 190.5 1194.5 348.812" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M7.26538e-07-0.333333 41.501-0.333243 41.501 0.333424-7.26538e-07 0.333333ZM40.1677-3.99991 48.1677 0.000104987 40.1677 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 1194.67 349.5)"/><path d="M0 0 47.8739 0.000104987" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(1 0 0 -1 1146.5 360.5)"/><path d="M1194.5 360.5 1194.5 592.497" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M7.26538e-07-0.333333 41.501-0.333243 41.501 0.333424-7.26538e-07 0.333333ZM40.1677-3.99991 48.1677 0.000104987 40.1677 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 1195.67 592.5)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(825.81 460)">Heartbeat<tspan font-size="15" x="-787.174" y="-2">PDP</tspan><tspan font-size="15" x="-763.174" y="-2">-</tspan><tspan font-size="15" x="-758.674" y="-2">UPDATE</tspan></text><path d="M82.5001 359.167 125.172 359.167 125.172 359.833 82.5001 359.833ZM123.839 355.5 131.839 359.5 123.839 363.5Z" fill="#4472C4"/><path d="M83.5001 398.167 126.172 398.167 126.172 398.833 83.5001 398.833ZM124.839 394.5 132.839 398.5 124.839 402.5Z" fill="#4472C4"/><path d="M81.5001 434.167 124.172 434.167 124.172 434.833 81.5001 434.833ZM122.839 430.5 130.839 434.5 122.839 438.5Z" fill="#4472C4"/><path d="M320.5 319.167 363.172 319.167 363.172 319.833 320.5 319.833ZM361.839 315.5 369.839 319.5 361.839 323.5Z" fill="#4472C4"/><path d="M320.5 358.167 363.172 358.167 363.172 358.833 320.5 358.833ZM361.839 354.5 369.839 358.5 361.839 362.5Z" fill="#4472C4"/><path d="M7.09291e-07-0.333333 42.6722-0.333243 42.6722 0.333424-7.09291e-07 0.333333ZM41.3389-3.99991 49.3389 0.000104987 41.3389 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 369.839 512.5)"/><path d="M7.09291e-07-0.333333 42.6722-0.333243 42.6722 0.333424-7.09291e-07 0.333333ZM41.3389-3.99991 49.3389 0.000104987 41.3389 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 369.839 584.5)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(825.81 264)">Heartbeat</text><path d="M743.5 206 950.184 206 950.184 207 743.5 207ZM942.435 201.402 951.176 206.5 942.435 211.599C942.197 211.738 941.891 211.657 941.752 211.419 941.613 211.18 941.693 210.874 941.932 210.735L949.932 206.068 949.932 206.932 941.932 202.265C941.693 202.126 941.613 201.82 941.752 201.582 941.891 201.343 942.197 201.262 942.435 201.402Z" fill="#4472C4"/><path d="M0.971386 0.492708 222.777 308.27 221.965 308.854 0.16011 1.07737ZM0.972428 10.0699-0.00135483-0.00188002 9.24514 4.1081C9.49747 4.22026 9.61111 4.51575 9.49895 4.76808 9.38679 5.02042 9.0913 5.13406 8.83896 5.02189L0.375725 1.26006 1.07649 0.755049 1.96779 9.97369C1.99436 10.2486 1.79309 10.4929 1.51822 10.5195 1.24336 10.5461 0.999002 10.3448 0.972428 10.0699ZM221.975 299.291 222.948 309.363 213.702 305.253C213.45 305.141 213.336 304.846 213.448 304.593 213.56 304.341 213.856 304.227 214.108 304.339L222.571 308.101 221.871 308.606 220.979 299.388C220.953 299.113 221.154 298.868 221.429 298.842 221.704 298.815 221.948 299.016 221.975 299.291Z" fill="#4472C4" transform="matrix(-1 0 0 1 954.447 224.5)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="15" transform="translate(373.58 442)">PDP-UPDATE<tspan font-size="15" x="734.675" y="30">PDP</tspan>-UPDATE<tspan font-size="15" x="733.901" y="-205">PDP</tspan>-UPDATE</text></g></svg>
\ No newline at end of file
diff --git a/docs/architecture/images/MCLocalHB.svg b/docs/architecture/images/MCLocalHB.svg
new file mode 100644
index 00000000..ae26672c
--- /dev/null
+++ b/docs/architecture/images/MCLocalHB.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1010.77 137)">Cluster B</text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 198)">PdpSubgroup</text><rect x="544.5" y="322.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 356)">PDP A1</text><rect x="544.5" y="390.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 424)">PDP A2</text><rect x="544.5" y="458.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 493)">PDP B1<tspan fill="#000000" font-size="24" x="-15.5099" y="-356">Shared DB</tspan></text><rect x="544.5" y="530.5" width="186" height="78" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 565)">PDP B2<tspan font-size="19" x="-28.9266" y="24">(timestamp UTC)</tspan><tspan fill="#000000" font-weight="700" font-size="24" x="-29.2628" y="-527">Local </tspan><tspan fill="#000000" font-weight="700" font-size="24" x="26.7639" y="-527">DMaaP</tspan><tspan fill="#000000" font-size="24" x="-14.3028" y="-498">Heartbeat</tspan></text><rect x="960.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1034.96 198)">PAP</text><rect x="961.5" y="245.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(982.754 280)">DMaaP<tspan font-size="24" x="76.1666" y="0">Queue</tspan></text><rect x="960.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1017.95 593)">PDP B2</text><rect x="962.5" y="299.5" width="184" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.93 326)">PDP B2</text><path d="M0 0.333333-50.4489 0.333333-50.1156 0-50.1156 127.756-50.4489 127.423-6.48283 127.423-6.48283 128.09-50.7823 128.09-50.7823-0.333333 0-0.333333ZM-7.81617 123.756 0.183832 127.756-7.81617 131.756Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 960.5 314.256)"/><path d="M0 0.333333-52.4081 0.333333-52.0747 0-52.0747 267.644-52.4081 267.31-6.55673 267.31-6.55673 267.977-52.7414 267.977-52.7414-0.333333 0-0.333333ZM-7.89008 263.644 0.109921 267.644-7.89008 271.644Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 962.5 592.144)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(825.81 460)">Heartbeat<tspan font-size="19" x="0" y="-196">Heartbeat</tspan></text><path d="M743.5 206 950.184 206 950.184 207 743.5 207ZM942.435 201.402 951.176 206.5 942.435 211.599C942.197 211.738 941.891 211.657 941.752 211.419 941.613 211.18 941.693 210.874 941.932 210.735L949.932 206.068 949.932 206.932 941.932 202.265C941.693 202.126 941.613 201.82 941.752 201.582 941.891 201.343 942.197 201.262 942.435 201.402Z" fill="#4472C4"/><path d="M0.971386 0.492708 222.777 308.27 221.965 308.854 0.16011 1.07737ZM0.972428 10.0699-0.00135483-0.00188002 9.24514 4.1081C9.49747 4.22026 9.61111 4.51575 9.49895 4.76808 9.38679 5.02042 9.0913 5.13406 8.83896 5.02189L0.375725 1.26006 1.07649 0.755049 1.96779 9.97369C1.99436 10.2486 1.79309 10.4929 1.51822 10.5195 1.24336 10.5461 0.999002 10.3448 0.972428 10.0699ZM221.975 299.291 222.948 309.363 213.702 305.253C213.45 305.141 213.336 304.846 213.448 304.593 213.56 304.341 213.856 304.227 214.108 304.339L222.571 308.101 221.871 308.606 220.979 299.388C220.953 299.113 221.154 298.868 221.429 298.842 221.704 298.815 221.948 299.016 221.975 299.291Z" fill="#4472C4" transform="matrix(-1 0 0 1 954.447 224.5)"/><rect x="962.5" y="337.5" width="184" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.93 363)">PDP B2</text><path d="M0 0.333333-49.4694 0.333333-49.1361 0-49.1361 165.302-49.4694 164.968-6.37281 164.968-6.37281 165.635-49.8027 165.635-49.8027-0.333333 0-0.333333ZM-7.70614 161.302 0.293858 165.302-7.70614 169.302Z" fill="#C00000" transform="matrix(-1 0 0 1 1145.79 182.5)"/><path d="M0 0 48.9974 0.208714" stroke="#C00000" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(1 0 0 -1 1145.5 365.709)"/><path d="M1194.5 365.5 1195.38 586.052" stroke="#C00000" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M7.14236e-07-0.333333 42.3306-0.333243 42.3306 0.333424-7.14236e-07 0.333333ZM40.9973-3.99991 48.9973 0.000104987 40.9973 4.00009Z" fill="#C00000" transform="matrix(-1 0 0 1 1195.5 586.5)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="15" transform="translate(1108.25 472)">PDP-UPDATE<tspan font-size="15" x="-0.773315" y="-235">PDP</tspan>-UPDATE</text></g></svg>
\ No newline at end of file
diff --git a/docs/architecture/images/MCMissedHB.svg b/docs/architecture/images/MCMissedHB.svg
new file mode 100644
index 00000000..d5b39b88
--- /dev/null
+++ b/docs/architecture/images/MCMissedHB.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1010.77 137)">Cluster B</text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 198)">PdpSubgroup</text><rect x="544.5" y="322.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#F4B183"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(568.607 356)">PDP A1 <tspan font-size="19" x="76.5" y="0">(delete)</tspan></text><rect x="544.5" y="390.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 424)">PDP A2</text><rect x="544.5" y="458.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 493)">PDP B1<tspan fill="#000000" font-size="24" x="-15.5099" y="-356">Shared DB</tspan><tspan fill="#000000" font-weight="700" font-size="24" x="-79.9627" y="-455">Local or Shared </tspan><tspan fill="#000000" font-weight="700" font-size="24" x="77.4639" y="-455">DMaaP</tspan><tspan fill="#000000" font-size="24" x="-51.7227" y="-426">Missed Heartbeat</tspan></text><rect x="960.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1034.96 198)">PAP</text><path d="M744.49 206 950.184 206 950.184 207 744.49 207ZM752.238 211.599 743.498 206.5 752.238 201.401C752.477 201.262 752.783 201.343 752.922 201.581 753.061 201.82 752.981 202.126 752.742 202.265L744.742 206.932 744.742 206.068 752.742 210.735C752.981 210.874 753.061 211.18 752.922 211.419 752.783 211.657 752.477 211.738 752.238 211.599ZM942.435 201.402 951.176 206.5 942.435 211.599C942.197 211.738 941.891 211.657 941.752 211.419 941.613 211.18 941.693 210.874 941.932 210.735L949.932 206.068 949.932 206.932 941.932 202.265C941.693 202.126 941.613 201.82 941.752 201.582 941.891 201.343 942.197 201.262 942.435 201.402Z" fill="#4472C4"/><path d="M1.10425-0.039017 210.673 97.1566 210.252 98.0638 0.683514 0.868164ZM5.78184 8.30177-0.00210251-0.00097505 10.0722-0.948858C10.3471-0.974726 10.5909-0.772822 10.6168-0.497894 10.6427-0.222966 10.4408 0.0208771 10.1659 0.0467449L0.944947 0.914334 1.30837 0.13073 6.60237 7.73016C6.76021 7.95675 6.70449 8.26839 6.47791 8.42623 6.25132 8.58407 5.93968 8.52835 5.78184 8.30177ZM205.583 89.7267 211.367 98.0294 201.292 98.9773C201.017 99.0032 200.774 98.8013 200.748 98.5264 200.722 98.2514 200.924 98.0076 201.199 97.9817L210.42 97.1141 210.056 97.8977 204.762 90.2983C204.604 90.0717 204.66 89.7601 204.887 89.6022 205.113 89.4444 205.425 89.5001 205.583 89.7267Z" fill="#4472C4" transform="matrix(-1 0 0 1 954.865 224.5)"/><path d="M0.265481-0.201572 29.5402 38.3547 29.0092 38.7579-0.265481 0.201572ZM31.6542 35.0755 33.3061 43.8659 25.2827 39.9133Z" fill="#4472C4" transform="matrix(-1 0 0 1 1179.81 116.5)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(1157.47 89)">Timer <tspan font-size="19" x="-0.666748" y="23">Check</tspan></text><rect x="544.5" y="530.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 564)">PDP B2</text></g></svg>
\ No newline at end of file
diff --git a/docs/architecture/images/MCSharedDB.svg b/docs/architecture/images/MCSharedDB.svg
new file mode 100644
index 00000000..6d6126db
--- /dev/null
+++ b/docs/architecture/images/MCSharedDB.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><path d="M93.5001 134.667C93.5001 110.274 113.274 90.5001 137.667 90.5001L314.333 90.5001C338.726 90.5001 358.5 110.274 358.5 134.667L358.5 513.333C358.5 537.726 338.726 557.5 314.333 557.5L137.667 557.5C113.274 557.5 93.5001 537.726 93.5001 513.333Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="133.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(209.825 198)">API</text><rect x="133.5" y="240.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(207.541 275)">PAP<tspan fill="#000000" font-size="24" x="-25.37" y="-138">Cluster A</tspan></text><path d="M922.5 134.667C922.5 110.274 942.274 90.5001 966.667 90.5001L1143.33 90.5001C1167.73 90.5001 1187.5 110.274 1187.5 134.667L1187.5 513.333C1187.5 537.726 1167.73 557.5 1143.33 557.5L966.667 557.5C942.274 557.5 922.5 537.726 922.5 513.333Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="961.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1038.01 198)">API</text><rect x="961.5" y="240.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1035.72 275)">PAP<tspan fill="#000000" font-size="24" x="-24.9534" y="-138">Cluster B</tspan></text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(582.574 198)">Policy Type</text><rect x="544.5" y="240.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(608.363 275)">Policy<tspan fill="#000000" font-size="24" x="-22.3333" y="-138">Shared DB</tspan></text><rect x="544.5" y="391.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(587.433 426)">PdpGroup</text><rect x="544.5" y="468.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 503)">PdpSubgroup</text><path d="M327.49 190 533.184 190 533.184 191 327.49 191ZM335.238 195.599 326.498 190.5 335.238 185.401C335.477 185.262 335.783 185.343 335.922 185.581 336.061 185.82 335.981 186.126 335.742 186.265L327.742 190.932 327.742 190.068 335.742 194.735C335.981 194.874 336.061 195.18 335.922 195.419 335.783 195.657 335.477 195.738 335.238 195.599ZM525.435 185.402 534.176 190.5 525.435 195.599C525.197 195.738 524.891 195.657 524.752 195.419 524.613 195.18 524.693 194.874 524.932 194.735L532.932 190.068 532.932 190.932 524.932 186.265C524.693 186.126 524.613 185.82 524.752 185.582 524.891 185.343 525.197 185.262 525.435 185.402Z" fill="#4472C4"/><path d="M327.591 206.3 533.367 266.988 533.084 267.947 327.308 207.26ZM333.439 213.862 326.498 206.499 336.323 204.081C336.592 204.016 336.862 204.179 336.928 204.448 336.994 204.716 336.831 204.987 336.562 205.053L327.569 207.266 327.813 206.437 334.167 213.176C334.356 213.377 334.347 213.694 334.146 213.883 333.945 214.072 333.628 214.063 333.439 213.862ZM527.235 260.385 534.176 267.748 524.35 270.166C524.082 270.232 523.811 270.068 523.745 269.8 523.679 269.532 523.843 269.261 524.111 269.195L533.104 266.982 532.86 267.81 526.507 261.071C526.318 260.87 526.327 260.554 526.528 260.364 526.729 260.175 527.045 260.184 527.235 260.385Z" fill="#4472C4"/><path d="M0.989698-0.499999 206.684-0.499896 206.684 0.500104 0.989698 0.5ZM8.73806 5.09856-0.0023173-1.30829e-08 8.73807-5.09855C8.97659-5.23769 9.28275-5.15712 9.42189-4.9186 9.56103-4.68007 9.48046-4.37391 9.24194-4.23477L1.24194 0.43189 1.24194-0.431889 9.24193 4.23478C9.48046 4.37392 9.56103 4.68008 9.42189 4.91861 9.28275 5.15713 8.97659 5.2377 8.73806 5.09856ZM198.935-5.09846 207.676 0.000104863 198.935 5.09866C198.697 5.2378 198.391 5.15723 198.252 4.9187 198.112 4.68018 198.193 4.37402 198.432 4.23488L206.432-0.431785 206.432 0.431994 198.432-4.23468C198.193-4.37382 198.112-4.67998 198.252-4.9185 198.391-5.15703 198.697-5.2376 198.935-5.09846Z" fill="#4472C4" transform="matrix(-1 0 0 1 950.174 189.5)"/><path d="M1.09072-0.199618 206.867 60.488 206.584 61.4472 0.807841 0.759539ZM6.93893 7.36209-0.00222267-0.000655553 9.82343-2.41854C10.0916-2.48453 10.3624-2.32065 10.4284-2.0525 10.4944-1.78436 10.3305-1.5135 10.0624-1.44751L1.06904 0.765561 1.31338-0.0629385 7.66656 6.67612C7.85598 6.87705 7.84666 7.1935 7.64573 7.38292 7.4448 7.57234 7.12835 7.56302 6.93893 7.36209ZM200.735 53.8851 207.676 61.2478 197.85 63.6657C197.582 63.7317 197.311 63.5678 197.245 63.2997 197.179 63.0315 197.343 62.7607 197.611 62.6947L206.604 60.4816 206.36 61.3101 200.007 54.571C199.817 54.3701 199.827 54.0537 200.028 53.8642 200.229 53.6748 200.545 53.6841 200.735 53.8851Z" fill="#4472C4" transform="matrix(-1 0 0 1 950.174 205.5)"/><path d="M1.68513e-07-0.333333 201.007-0.333232 201.007 0.333435-1.68513e-07 0.333333ZM199.673-3.9999 207.673 0.000104987 199.673 4.0001Z" fill="#4472C4" transform="matrix(-1 0 0 1 534.174 284.5)"/><path d="M742.5 281.167 943.507 281.167 943.507 281.833 742.5 281.833ZM942.174 277.5 950.174 281.5 942.174 285.5Z" fill="#4472C4"/><path d="M0.0942916-0.319719 201.373 59.0416 201.185 59.681-0.0942916 0.319719ZM201.132 55.1475 207.673 61.2471 198.869 62.8208Z" fill="#4472C4" transform="matrix(-1 0 0 1 534.174 207.5)"/><path d="M742.594 204.18 943.873 263.542 943.685 264.181 742.406 204.82ZM943.632 259.648 950.174 265.747 941.369 267.321Z" fill="#4472C4"/><path d="M320.615 302.496 533.875 408.388 533.43 409.284 320.171 303.391ZM325.059 310.953 319.498 302.499 329.594 301.82C329.869 301.801 330.108 302.009 330.126 302.285 330.145 302.56 329.937 302.799 329.661 302.817L320.42 303.439 320.805 302.666 325.894 310.403C326.046 310.634 325.982 310.944 325.751 311.096 325.521 311.247 325.211 311.183 325.059 310.953ZM528.979 400.823 534.539 409.277 524.444 409.956C524.168 409.974 523.93 409.766 523.911 409.491 523.893 409.215 524.101 408.977 524.376 408.958L533.617 408.336 533.233 409.11 528.143 401.372C527.991 401.142 528.055 400.832 528.286 400.68 528.517 400.528 528.827 400.592 528.979 400.823Z" fill="#4472C4"/><path d="M1.11531-0.00445179 214.375 105.888 213.93 106.784 0.670572 0.89121ZM5.55888 8.45269-0.00207544-0.00103059 10.0939-0.680496C10.3694-0.699039 10.6078-0.490718 10.6263-0.215199 10.6448 0.0603198 10.4365 0.298704 10.161 0.317247L0.920282 0.939156 1.30443 0.165501 6.39433 7.90312C6.54608 8.13382 6.48209 8.44387 6.25138 8.59563 6.02068 8.74739 5.71064 8.68339 5.55888 8.45269ZM209.479 98.3227 215.039 106.776 204.944 107.456C204.668 107.474 204.43 107.266 204.411 106.991 204.393 106.715 204.601 106.477 204.876 106.458L214.117 105.836 213.733 106.61 208.643 98.8723C208.491 98.6416 208.555 98.3315 208.786 98.1798 209.017 98.028 209.327 98.092 209.479 98.3227Z" fill="#4472C4" transform="matrix(-1 0 0 1 954.537 301.5)"/><path d="M312.593 316.696 533.385 482.558 532.784 483.358 311.992 317.495ZM315.424 325.825 311.498 316.499 321.549 317.672C321.823 317.704 322.019 317.952 321.987 318.226 321.955 318.501 321.707 318.697 321.433 318.665L312.234 317.591 312.752 316.901 316.346 325.437C316.453 325.691 316.333 325.984 316.079 326.092 315.824 326.199 315.531 326.079 315.424 325.825ZM529.953 474.228 533.879 483.555 523.829 482.381C523.554 482.349 523.358 482.101 523.39 481.827 523.422 481.553 523.67 481.356 523.945 481.388L533.144 482.462 532.625 483.153 529.031 474.616C528.924 474.362 529.044 474.069 529.298 473.962 529.553 473.854 529.846 473.974 529.953 474.228Z" fill="#4472C4"/><path d="M1.09278 0.195548 221.885 166.058 221.284 166.858 0.492156 0.995082ZM3.92406 9.32474-0.0018528-0.0013919 10.0487 1.17182C10.323 1.20383 10.5193 1.45214 10.4873 1.72642 10.4553 2.0007 10.207 2.19709 9.93273 2.16507L0.733565 1.09124 1.25237 0.400625 4.84573 8.93676C4.95286 9.19127 4.83339 9.48444 4.57888 9.59158 4.32437 9.69872 4.0312 9.57925 3.92406 9.32474ZM218.453 157.728 222.379 167.055 212.329 165.881C212.054 165.849 211.858 165.601 211.89 165.327 211.922 165.053 212.17 164.856 212.444 164.888L221.644 165.962 221.125 166.652 217.531 158.116C217.424 157.862 217.544 157.569 217.798 157.462 218.053 157.354 218.346 157.474 218.453 157.728Z" fill="#4472C4" transform="matrix(-1 0 0 1 961.877 315.5)"/></g></svg>
diff --git a/docs/architecture/images/MCSharedDmaap.svg b/docs/architecture/images/MCSharedDmaap.svg
new file mode 100644
index 00000000..2a906abb
--- /dev/null
+++ b/docs/architecture/images/MCSharedDmaap.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><rect x="133.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(207.541 198)">PAP</text><rect x="133.5" y="229.5" width="186" height="70" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(155.331 260)">DMaaP<tspan font-size="24" x="76.1667" y="0">Queue</tspan><tspan font-size="19" x="39.3733" y="24">(shared)</tspan></text><rect x="133.5" y="485.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.114 520)">PDP A1</text><rect x="133.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.114 593)">PDP A2<tspan fill="#000000" font-size="24" x="-7.94304" y="-456">Cluster A</tspan><tspan fill="#000000" font-size="24" x="820.657" y="-456">Cluster B</tspan></text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 198)">PdpSubgroup</text><rect x="544.5" y="322.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 356)">PDP A1</text><rect x="544.5" y="390.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 424)">PDP A2</text><rect x="544.5" y="458.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 493)">PDP B1<tspan fill="#000000" font-size="24" x="-15.5099" y="-356">Shared DB</tspan></text><rect x="544.5" y="530.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 564)">PDP B2</text><rect x="133.5" y="299.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.224 326)">PDP A1</text><rect x="133.5" y="338.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.151 364)">PDP A2</text><rect x="133.5" y="376.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.531 403)">PDP B1</text><rect x="133.5" y="414.5" width="186" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(190.531 441)">PDP B2</text><path d="M327.49 190 533.184 190 533.184 191 327.49 191ZM335.238 195.599 326.498 190.5 335.238 185.401C335.477 185.262 335.783 185.343 335.922 185.581 336.061 185.82 335.981 186.126 335.742 186.265L327.742 190.932 327.742 190.068 335.742 194.735C335.981 194.874 336.061 195.18 335.922 195.419 335.783 195.657 335.477 195.738 335.238 195.599ZM525.435 185.402 534.176 190.5 525.435 195.599C525.197 195.738 524.891 195.657 524.752 195.419 524.613 195.18 524.693 194.874 524.932 194.735L532.932 190.068 532.932 190.932 524.932 186.265C524.693 186.126 524.613 185.82 524.752 185.582 524.891 185.343 525.197 185.262 525.435 185.402Z" fill="#4472C4"/><path d="M327.545 206.882 514.265 405.505 513.536 406.19 326.817 207.567ZM328.77 216.359 326.498 206.498 336.2 209.374C336.465 209.453 336.616 209.731 336.537 209.996 336.459 210.261 336.18 210.412 335.916 210.333L327.036 207.701 327.665 207.109 329.745 216.134C329.807 216.403 329.639 216.672 329.37 216.734 329.101 216.796 328.832 216.628 328.77 216.359ZM512.311 396.713 514.583 406.574 504.882 403.698C504.617 403.619 504.466 403.341 504.545 403.076 504.623 402.811 504.901 402.66 505.166 402.739L514.046 405.371 513.416 405.963 511.337 396.938C511.275 396.669 511.443 396.4 511.712 396.338 511.981 396.276 512.25 396.444 512.311 396.713Z" fill="#4472C4"/><path d="M133.184 190.5 81.5001 190.5" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M81.5001 190.5 81.5002 434" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M83.5001 318.167 126.172 318.167 126.172 318.833 83.5001 318.833ZM124.839 314.5 132.839 318.5 124.839 322.5Z" fill="#4472C4"/><path d="M369.5 319.5 369.5 584.573" stroke="#4472C4" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="700" font-size="24" transform="translate(563.011 38)">Shared <tspan font-size="24" x="74.5667" y="0">DMaaP</tspan><tspan font-weight="400" font-size="24" x="-43.3533" y="29">Deploy/</tspan><tspan font-weight="400" font-size="24" x="34.3533" y="29">Undeploy</tspan><tspan font-weight="400" font-size="24" x="134.06" y="29">Policy</tspan></text><path d="M117.766 120.298 147.04 158.855 146.509 159.258 117.235 120.702ZM149.154 155.576 150.806 164.366 142.783 160.413Z" fill="#4472C4"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(85.7548 108)">Request</text><path d="M82.5001 359.167 125.172 359.167 125.172 359.833 82.5001 359.833ZM123.839 355.5 131.839 359.5 123.839 363.5Z" fill="#4472C4"/><path d="M83.5001 398.167 126.172 398.167 126.172 398.833 83.5001 398.833ZM124.839 394.5 132.839 398.5 124.839 402.5Z" fill="#4472C4"/><path d="M81.5001 434.167 124.172 434.167 124.172 434.833 81.5001 434.833ZM122.839 430.5 130.839 434.5 122.839 438.5Z" fill="#4472C4"/><path d="M320.5 319.167 363.172 319.167 363.172 319.833 320.5 319.833ZM361.839 315.5 369.839 319.5 361.839 323.5Z" fill="#4472C4"/><path d="M320.5 358.167 363.172 358.167 363.172 358.833 320.5 358.833ZM361.839 354.5 369.839 358.5 361.839 362.5Z" fill="#4472C4"/><path d="M7.09291e-07-0.333333 42.6722-0.333243 42.6722 0.333424-7.09291e-07 0.333333ZM41.3389-3.99991 49.3389 0.000104987 41.3389 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 369.839 512.5)"/><path d="M7.09291e-07-0.333333 42.6722-0.333243 42.6722 0.333424-7.09291e-07 0.333333ZM41.3389-3.99991 49.3389 0.000104987 41.3389 4.00009Z" fill="#4472C4" transform="matrix(-1 0 0 1 369.839 584.5)"/><rect x="961.5" y="485.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1019.01 520)">PDP B1</text><rect x="961.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1019.01 593)">PDP B2</text><path d="M319.5 395.167 851.767 395.167 851.767 512.884 851.434 512.551 955.475 512.551 955.475 513.218 851.101 513.218 851.101 395.5 851.434 395.833 319.5 395.833ZM954.142 508.884 962.142 512.884 954.142 516.884Z" fill="#4472C4"/><path d="M319.5 433.167 476.58 433.167 476.58 586.219 476.247 585.886 955.475 585.886 955.475 586.553 475.913 586.553 475.913 433.5 476.247 433.833 319.5 433.833ZM954.142 582.219 962.142 586.219 954.142 590.219Z" fill="#4472C4"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="15" transform="translate(38.6359 458)">PDP-<tspan font-size="15" x="28.5" y="0">UPDATE</tspan><tspan font-size="15" x="337.751" y="-37">PDP</tspan>-UPDATE<tspan font-size="15" x="820.355" y="96">PDP</tspan>-UPDATE</text></g></svg>
\ No newline at end of file
diff --git a/docs/architecture/images/MCSharedHB.svg b/docs/architecture/images/MCSharedHB.svg
new file mode 100644
index 00000000..74020a12
--- /dev/null
+++ b/docs/architecture/images/MCSharedHB.svg
@@ -0,0 +1 @@
+<svg width="1280" height="720" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" overflow="hidden"><defs><clipPath id="clip0"><rect x="0" y="0" width="1280" height="720"/></clipPath></defs><g clip-path="url(#clip0)"><rect x="0" y="0" width="1280" height="720" fill="#FFFFFF"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1010.77 137)">Cluster B</text><path d="M504.5 134.668C504.5 110.275 524.275 90.5001 548.668 90.5001L725.332 90.5001C749.726 90.5001 769.5 110.275 769.5 134.668L769.5 652.332C769.5 676.725 749.726 696.5 725.332 696.5L548.668 696.5C524.275 696.5 504.5 676.725 504.5 652.332Z" stroke="#2F528F" stroke-width="1.33333" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><rect x="544.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(571.183 198)">PdpSubgroup</text><rect x="544.5" y="322.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 356)">PDP A1</text><rect x="544.5" y="390.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.124 424)">PDP A2</text><rect x="544.5" y="458.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 493)">PDP B1<tspan fill="#000000" font-size="24" x="-15.5099" y="-356">Shared DB</tspan><tspan fill="#000000" font-weight="700" font-size="24" x="-38.5328" y="-455">Shared </tspan><tspan fill="#000000" font-weight="700" font-size="24" x="36.0339" y="-455">DMaaP</tspan><tspan fill="#000000" font-size="24" x="-14.3061" y="-426">Heartbeat</tspan></text><rect x="960.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1034.96 198)">PAP</text><rect x="960.5" y="559.5" width="186" height="54" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1017.95 593)">PDP B2</text><rect x="961.5" y="299.5" width="185" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.54 326)">PDP B2</text><path d="M0 0.333333-50.4489 0.333333-50.1156 0-50.1156 127.756-50.4489 127.423-6.48283 127.423-6.48283 128.09-50.7823 128.09-50.7823-0.333333 0-0.333333ZM-7.81617 123.756 0.183832 127.756-7.81617 131.756Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 960.5 305.256)"/><path d="M0 0.333333-52.4081 0.333333-52.0747 0-52.0747 267.644-52.4081 267.31-6.55673 267.31-6.55673 267.977-52.7414 267.977-52.7414-0.333333 0-0.333333ZM-7.89008 263.644 0.109921 267.644-7.89008 271.644Z" fill="#4472C4" transform="matrix(1 -1.22465e-16 -1.22465e-16 -1 962.5 595.144)"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(825.81 460)">Heartbeat<tspan font-size="19" x="0" y="-196">Heartbeat</tspan></text><path d="M739.5 195 946.184 195 946.184 196 739.5 196ZM938.435 190.402 947.176 195.5 938.435 200.599C938.197 200.738 937.891 200.657 937.752 200.419 937.613 200.18 937.693 199.874 937.932 199.735L945.932 195.068 945.932 195.932 937.932 191.265C937.693 191.126 937.613 190.82 937.752 190.582 937.891 190.343 938.197 190.262 938.435 190.402Z" fill="#4472C4"/><path d="M0.971386 0.492708 222.777 308.27 221.965 308.854 0.16011 1.07737ZM0.972428 10.0699-0.00135483-0.00188002 9.24514 4.1081C9.49747 4.22026 9.61111 4.51575 9.49895 4.76808 9.38679 5.02042 9.0913 5.13406 8.83896 5.02189L0.375725 1.26006 1.07649 0.755049 1.96779 9.97369C1.99436 10.2486 1.79309 10.4929 1.51822 10.5195 1.24336 10.5461 0.999002 10.3448 0.972428 10.0699ZM221.975 299.291 222.948 309.363 213.702 305.253C213.45 305.141 213.336 304.846 213.448 304.593 213.56 304.341 213.856 304.227 214.108 304.339L222.571 308.101 221.871 308.606 220.979 299.388C220.953 299.113 221.154 298.868 221.429 298.842 221.704 298.815 221.948 299.016 221.975 299.291Z" fill="#4472C4" transform="matrix(-1 0 0 1 954.447 224.5)"/><rect x="133.5" y="163.5" width="186" height="55" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(207.541 198)">PAP<tspan fill="#000000" font-size="24" x="-25.3701" y="-61">Cluster A</tspan></text><path d="M961.766 319.507 226.167 319.507 226.167 225.167 226.833 225.167 226.833 319.174 226.5 318.841 961.766 318.841ZM222.5 226.5 226.5 218.5 230.5 226.5Z" fill="#4472C4"/><text font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="19" transform="translate(235.141 264)">Heartbeat</text><path d="M321.477 225.016 539.22 532.759 538.404 533.336 320.661 225.593ZM321.385 234.578 320.499 224.498 329.709 228.688C329.961 228.803 330.072 229.099 329.957 229.35 329.843 229.602 329.546 229.713 329.295 229.599L320.865 225.763 321.57 225.264 322.381 234.49C322.405 234.766 322.202 235.008 321.927 235.032 321.652 235.057 321.409 234.853 321.385 234.578ZM538.503 523.783 539.389 533.863 530.179 529.673C529.928 529.559 529.817 529.262 529.931 529.011 530.045 528.76 530.342 528.648 530.593 528.763L539.023 532.598 538.318 533.097 537.507 523.871C537.483 523.596 537.686 523.353 537.961 523.329 538.236 523.305 538.479 523.508 538.503 523.783Z" fill="#4472C4"/><path d="M2.52769e-07-0.5 206.684-0.499896 206.684 0.500104-2.52769e-07 0.5ZM198.935-5.09846 207.676 0.000104863 198.935 5.09866C198.697 5.2378 198.391 5.15723 198.252 4.9187 198.112 4.68018 198.193 4.37402 198.432 4.23488L206.432-0.431785 206.432 0.431994 198.432-4.23468C198.193-4.37382 198.112-4.67998 198.252-4.9185 198.391-5.15703 198.697-5.2376 198.935-5.09846Z" fill="#4472C4" transform="matrix(-1 0 0 1 531.174 195.5)"/><rect x="961.5" y="337.5" width="185" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.19 363)">PDP B2</text><rect x="961.5" y="374.5" width="185" height="38" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#8FAADC"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(1018.72 400)">PDP B2</text><path d="M194.5 218.833 187.341 218.833 187.674 218.5 187.674 393.643 187.341 393.309 955.233 393.309 955.233 393.976 187.007 393.976 187.007 218.167 194.5 218.167ZM953.899 389.643 961.899 393.643 953.899 397.643Z" fill="#C00000"/><path d="M0 0.333333-49.4694 0.333333-49.1361 0-49.1361 165.302-49.4694 164.968-6.37281 164.968-6.37281 165.635-49.8027 165.635-49.8027-0.333333 0-0.333333ZM-7.70614 161.302 0.293858 165.302-7.70614 169.302Z" fill="#C00000" transform="matrix(-1 0 0 1 1145.79 182.5)"/><path d="M0.333329-0.00173333 1.06444 140.594 0.397779 140.598-0.333329 0.00173333ZM4.72412 139.242 0.765774 147.262-3.27577 139.283Z" fill="#C00000" transform="matrix(-1 0 0 1 992.266 412.5)"/><path d="M0 0 48.9974 0.208714" stroke="#C00000" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd" transform="matrix(1 0 0 -1 1145.5 365.709)"/><path d="M1194.5 365.5 1195.38 586.052" stroke="#C00000" stroke-width="0.666667" stroke-miterlimit="8" fill="none" fill-rule="evenodd"/><path d="M7.14236e-07-0.333333 42.3306-0.333243 42.3306 0.333424-7.14236e-07 0.333333ZM40.9973-3.99991 48.9973 0.000104987 40.9973 4.00009Z" fill="#C00000" transform="matrix(-1 0 0 1 1195.5 586.5)"/><rect x="544.5" y="530.5" width="186" height="78" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(601.54 565)">PDP B2<tspan font-size="19" x="-28.9266" y="24">(timestamp UTC)</tspan><tspan fill="#000000" font-size="15" x="-400.307" y="-187">PDP</tspan><tspan fill="#000000" font-size="15" x="-376.307" y="-187">-</tspan><tspan fill="#000000" font-size="15" x="-371.807" y="-187">UPDATE</tspan><tspan fill="#000000" font-size="15" x="401.071" y="-119">PDP</tspan><tspan fill="#000000" font-size="15" x="425.071" y="-119">-</tspan><tspan fill="#000000" font-size="15" x="429.571" y="-119">UPDATE</tspan><tspan fill="#000000" font-size="15" x="506.715" y="-93">PDP</tspan><tspan fill="#000000" font-size="15" x="530.715" y="-93">-</tspan><tspan fill="#000000" font-size="15" x="535.215" y="-93">UPDATE</tspan><tspan fill="#000000" font-size="15" x="561.135" y="-395">PDP</tspan><tspan fill="#000000" font-size="15" x="585.135" y="-395">-</tspan><tspan fill="#000000" font-size="15" x="589.635" y="-395">UPDATE</tspan></text><rect x="960.5" y="230.5" width="186" height="70" stroke="#41719C" stroke-width="1.33333" stroke-miterlimit="8" fill="#5B9BD5"/><text fill="#FFFFFF" font-family="Calibri,Calibri_MSFontService,sans-serif" font-weight="400" font-size="24" transform="translate(982.314 261)">DMaaP<tspan font-size="24" x="76.1667" y="0">Queue</tspan><tspan font-size="19" x="39.3734" y="24">(shared)</tspan></text></g></svg>
\ No newline at end of file