Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-12012

Atlas "Connect via..." Documentation Updates for Multi-tenant Instances

    • Type: Icon: Improvement Improvement
    • Resolution: Fixed
    • Priority: Icon: Major - P3 Major - P3
    • None
    • Affects Version/s: None
    • Component/s: Atlas
    • Labels:

      Description

      For the mongo shell, driver, and Compass documentation, the following copy is used under the "Prerequisites" section:

      Clients must have support for the SNI TLS extension to connect to an Atlas M0 Free Tier or M2/M5 shared starter cluster.

      Currently, I cannot find anywhere in the documentation for what versions of the shell/drivers/Compass this is referring to. This can cause confusion for those who are able to successfully connect to a dedicated Atlas cluster with a lower version but not their multi-tenant host because the documentation is unclear (because M10+ do not require SNI in order to connect). To rectify this:

      • For the mongo shell: this means version 3.4 of the mongo shell and up, as 3.2 and below do not support the SNI TLS extension.
      • For the drivers: I haven't tested on all of them, but I imagine we can use the Driver Compatibility Matrix to determine which ones support the SNI TLS extension via their support for 3.4 and above.
      • For Compass: I'm not sure when SNI was supported so that Compass could connect to multi-tenant hosts, but I imagine it came after whatever version of the NodeJS driver supported it as well.

      Additionally, focusing on the SNI TLS extension for the mongo shell in particular, we can tell from experimentation that support for this came in version 3.4. However, I couldn't find this anywhere in the release notes.

      Scope of changes

      Impact to Other Docs

      MVP (Work and Date)

      Resources (Scope or Design Docs, Invision, etc.)

            Assignee:
            jeffrey.allen@mongodb.com Jeffrey Allen
            Reporter:
            julian.torres@mongodb.com Julian Torres
            Votes:
            1 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved:
              5 years, 31 weeks, 2 days ago