DOCSP-2575 - Adding note about firewall reqs

Author: jeff-allen-mongo

source/faq.txt

@@ -119,6 +119,27 @@ or 60 seconds), but the schema analysis of the documents takes longer
 than expected (due to complex, large documents), Compass gives you the
 option to abort the analysis step and show the partial results.
 
+Why are some features of |compass| not working?
+-----------------------------------------------
+
+If you can connect to your MongoDB instance using |compass| but
+some features do not work as expected, your system firewall may be
+blocking network requests required by |compass|. |compass| features
+which require incoming connections from external sources include:
+
+- Third party mapping services such as Mapbox
+
+- Intercom
+
+- Bugsnag for error reporting
+
+To fix this issue, configure your system firewall to allow incoming
+connections for |compass|. Ensure ports ``80`` and ``443`` are open
+between |compass| and the host for the MongoDB Instance to which
+Compass connects.
+
+.. include:: /includes/fact-isolated-edition-firewall.rst
+
 .. _faq-privacy-settings:
 
 How do I view and modify my Privacy Settings?
@@ -148,3 +169,4 @@ selected, |compass| is allowed to make requests to a third-party
 mapping service.
 
 .. include:: /includes/fact-isolated-ver-third-party-mapping.rst
+

source/includes/fact-isolated-edition-firewall.rst

@@ -0,0 +1,9 @@
+.. note::
+
+   :ref:`Compass Isolated Edition <compass-isolated>` restricts network
+   requests to :abbr:`TLS (Transport Layer Security)`-encrypted
+   :abbr:`TCP (Transmission Control Protocol)` connections to the server
+   chosen on the :ref:`Connect <connect-run-compass>` screen. All other
+   outbound connections are not permitted in this edition, meaning no
+   additional firewall configuration is required when running Compass
+   Isolated Edition.

source/install.txt

@@ -120,3 +120,20 @@ To download and install on Red Hat Enterprise Linux:
    .. code-block:: sh
 
       sudo DEBUG=* mongodb-compass;
+
+Compass Firewall Requirements
+-----------------------------
+
+Certain features of |compass|, such as third-party mapping services and
+Intercom, require inbound connections from external sources to
+function. In some instances, users have reported issues with their
+system firewall blocking these network requests and thereby limiting
+|compass| functionalities. To fix this issue, configure your system
+firewall to allow incoming connections for |compass|.
+
+.. important::
+
+   Ensure ports ``80`` and ``443`` are open between |compass| and the
+   host for the MongoDB Instance to which Compass connects.
+
+.. include:: /includes/fact-isolated-edition-firewall.rst