docs: Known issue added to SupportForRDSMultiAzDBCluster.md (#417)

Author: joyc-bq

common/lib/host_list_provider/monitoring/cluster_topology_monitor.ts

@@ -282,7 +282,7 @@ export class ClusterTopologyMonitorImpl implements ClusterTopologyMonitor {
 
           if (this.hostMonitors.size === 0) {
             // Initialize host tasks.
-            logger.info(Messages.get("ClusterTopologyMonitor.startingHostMonitors"));
+            logger.debug(Messages.get("ClusterTopologyMonitor.startingHostMonitors"));
             this.hostMonitorsStop = false;
             if (this.hostMonitorsReaderClient !== null) {
               await this.closeConnection(this.hostMonitorsReaderClient);

docs/using-the-nodejs-wrapper/SupportForRDSMultiAzDBCluster.md

@@ -42,3 +42,8 @@ The following plugins have been tested and confirmed to work with Amazon RDS Mul
 
 The compatibility of other plugins has not been tested at this time. They may function as expected or potentially result in unhandled behavior.
 Use at your own discretion.
+
+## Known Issues
+
+When using the AWS Advanced NodeJS Wrapper with Amazon RDS Multi-AZ DB Cluster deployments, the failover process may fail to complete due to the stale topology returning the incorrect writer instance. This causes the wrapper to throw a FailoverFailedError with the message:
+`"The new writer was identified to be 'instance endpoint', but querying the instance for its role returned a reader."`

tests/integration/container/tests/aurora_failover.test.ts

@@ -36,7 +36,8 @@ const itIf =
     ? it
     : it.skip;
 const itIfTwoInstance = instanceCount == 2 ? itIf : it.skip;
-const itIfThreeInstance = instanceCount == 3 ? it : it.skip;
+const itIfThreeInstanceAuroraCluster =
+  instanceCount == 3 && !features.includes(TestEnvironmentFeatures.RDS_MULTI_AZ_CLUSTER_SUPPORTED) ? it : it.skip;
 
 let env: TestEnvironment;
 let driver;
@@ -115,7 +116,7 @@ describe("aurora failover", () => {
     logger.info(`Test finished: ${expect.getState().currentTestName}`);
   }, 1320000);
 
-  itIfThreeInstance(
+  itIfThreeInstanceAuroraCluster(
     "writer failover efm",
     async () => {
       // Connect to writer instance.

tests/integration/container/tests/custom_endpoint.test.ts

@@ -37,7 +37,6 @@ import { PluginManager } from "../../../../common/lib";
 import { TestDriver } from "./utils/test_driver";
 import { DatabaseEngineDeployment } from "./utils/database_engine_deployment";
 
-
 const itIf =
   features.includes(TestEnvironmentFeatures.FAILOVER_SUPPORTED) &&
   !features.includes(TestEnvironmentFeatures.PERFORMANCE) &&