DOCSP-17383 localhost connection (#751)

* DOCSP-17383: workshop localhost connection instructions

Author: Chris Cho

source/c.txt

@@ -42,6 +42,8 @@ See `Installing the MongoDB C Driver (libmongoc) and BSON library (libbson)
 <http://mongoc.org/libmongoc/current/installing.html>`__.
 
 
+.. _connect-atlas-c-driver:
+
 Connect to MongoDB Atlas
 ------------------------
 
@@ -107,11 +109,15 @@ client instance, specifying a version of the Versioned API:
    api = mongoc_server_api_new (MONGOC_SERVER_API_V1);
    mongoc_client_set_server_api (client, api, &error);
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-c-driver>` code 
+example and run it.
+
 Compatibility
 -------------
 

source/csharp.txt

@@ -49,6 +49,7 @@ all new projects.
 
 For more information, see `Installation <https://mongodb.github.io/mongo-csharp-driver/2.12/getting_started/installation/>`__.
 
+.. _connect-atlas-csharp-driver:
 
 Connect to MongoDB Atlas
 ------------------------
@@ -59,7 +60,7 @@ Connect to MongoDB Atlas
 
    using MongoDB.Bson;
    using MongoDB.Driver;
-   
+
    // Replace the uri string with your MongoDB deployment's connection string.
    var client = new MongoClient(
        "mongodb+srv://<username>:<password>@<cluster-address>/test?w=majority"
@@ -86,16 +87,20 @@ client instance, specifying a version of the Versioned API:
 
    // Replace <connection string> with your MongoDB deployment's connection string.
    var settings = MongoClientSettings.FromConnectionString("<connection string>");
-   
+
    // Set the version of the Versioned API on the client.
    settings.ServerApi = new ServerApi(ServerApiVersion.V1);
    var client = new MongoClient(settings);
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-csharp-driver>`
+code example and run it.
+
 Compatibility
 -------------
 

source/cxx.txt

@@ -36,6 +36,8 @@ Installation
 
 See `Installing the mongocxx driver <http://mongocxx.org/mongocxx-v3/installation/>`__.
 
+.. _connect-atlas-cxx-driver:
+
 Connect to MongoDB Atlas
 ------------------------
 
@@ -58,11 +60,15 @@ Connect to MongoDB Atlas
 
 .. include:: /includes/serverless-compatibility.rst
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-cxx-driver>` code
+example and run it.
+
 Compatibility
 -------------
 

source/go.txt

@@ -45,6 +45,8 @@ The recommended way to get started using the MongoDB Go driver is by using
 See `Installation <https://github.com/mongodb/mongo-go-driver#installation>`__
 for additional ways to add the driver to your project.
 
+.. _connect-atlas-go-driver:
+
 Connect to MongoDB Atlas
 ------------------------
 
@@ -82,11 +84,15 @@ client instance, specifying a version of the Versioned API:
 
    client, err := mongo.Connect(ctx, clientOptions)
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-go-driver>` code
+example and run it.
+
 Compatibility
 -------------
 

source/includes/localhost-connection.rst

@@ -1,10 +1,27 @@
-To connect to a database running locally on its default port, change the
-connection string to ``"mongodb://localhost"``. 
+If you need to run a MongoDB server on your local machine for development
+purposes instead of using an Atlas cluster, you need to complete the following:
 
-To connect to a database running locally, change the connection string
-to ``"mongodb://localhost:<port>"``.
+1. Download the `Community <https://www.mongodb.com/try/download/community>`__
+   or `Enterprise <https://www.mongodb.com/try/download/enterprise>`__ version
+   of MongoDB Server.
 
-Your ``mongod`` instance must be running to successfully connect to your
-database. For information on how to start your ``mongod`` instance,
-see the :manual:`Manage mongod Processes
-</tutorial/manage-mongodb-processes/#start-mongod-processes>` Server Manual Entry.
+#. `Install and configure <https://docs.mongodb.com/manual/installation/>`__
+   MongoDB Server.
+
+#. Start the server.
+
+.. important::
+
+   Always secure your MongoDB server from malicious attacks. See our
+   :manual:`Security Checklist </administration/security-checklist/>` for a
+   list of security recommendations.
+
+After you successfully start your MongoDB server, specify your connection
+string in your driver connection code.
+
+If your MongoDB Server is running locally, you can use the connection string
+``"mongodb://localhost:<port>"`` where ``<port>`` is the port number you
+configured your server to listen for incoming connections.
+
+If you need to specify a different hostname or IP address, see our Server
+Manual entry on :manual:`Connection Strings </reference/connection-string/>`.

source/motor.txt

@@ -64,6 +64,8 @@ For more information on requirements and other methods of installation,
 see the `Motor Installation <https://motor.readthedocs.io/en/stable/installation.html>`__
 documentation.
 
+.. _connect-atlas-motor-driver:
+
 Connect to MongoDB Atlas
 ------------------------
 
@@ -131,11 +133,15 @@ If the connection fails, you should see the following message:
 For more information on the connection string, see the MongoDB Server
 Manual entry on :manual:`Connection String URI Format </reference/connection-string/>`.
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-motor-driver>` code
+example and run it.
+
 Compatibility
 -------------
 

source/php.txt

@@ -95,6 +95,7 @@ The preferred method of installing the PHP library is with
 Additional installation instructions may be found in the
 `library documentation <https://docs.mongodb.com/php-library/current/tutorial/install-php-library/>`_.
 
+.. _connect-atlas-php-driver:
 
 Connect to MongoDB Atlas
 ------------------------
@@ -113,11 +114,15 @@ Connect to MongoDB Atlas
 
 .. include:: /includes/serverless-compatibility.rst
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-php-driver>` code
+example and run it.
+
 Compatibility
 -------------
 

source/pymongo.txt

@@ -65,6 +65,7 @@ version, use the following ``pip`` command:
 See `Installation <https://pymongo.readthedocs.io/en/stable/installation.html>`__
 for more ways to install PyMongo.
 
+.. _connect-atlas-pymongo-driver:
 
 Connect to MongoDB Atlas
 ------------------------
@@ -104,21 +105,25 @@ Manual entry on :manual:`Connection String URI Format </reference/connection-str
 Versioned API
 -------------
 
-You can use the `Versioned API <https://docs.mongodb.com/v5.0/reference/versioned-api/>`__ 
+You can use the `Versioned API <https://docs.mongodb.com/v5.0/reference/versioned-api/>`__
 feature starting with MongoDB Server version 5.0 and PyMongo Driver
-version 3.12. When you use the Versioned API feature, you can update your 
-driver or server without worrying about backward compatibility issues with any 
-commands covered by the Versioned API. To use this feature, construct a 
+version 3.12. When you use the Versioned API feature, you can update your
+driver or server without worrying about backward compatibility issues with any
+commands covered by the Versioned API. To use this feature, construct a
 MongoDB client instance, specifying a version of the Versioned API:
 
 .. literalinclude:: /includes/versioned-api-snippets/pymongo-client.py
    :language: python
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-pymongo-driver>`
+code example and run it.
+
 Compatibility
 -------------
 

source/reactive-streams.txt

@@ -36,6 +36,8 @@ a dependency management system.
 See the :java-docs:`Installation Guide <driver-reactive/getting-started/installation/>`
 for more information.
 
+.. _connect-atlas-reactive-streams-driver:
+
 Connect to MongoDB Atlas
 ------------------------
 
@@ -80,11 +82,15 @@ MongoDB client instance, specifying a version of the Versioned API:
 .. literalinclude:: /includes/versioned-api-snippets/java-rs-client.java
    :language: java
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-reactive-streams-driver>`
+code example and run it.
+
 Compatibility
 -------------
 

source/rust.txt

@@ -33,6 +33,7 @@ Installation
 
 See `Installation <https://github.com/mongodb/mongo-rust-driver#Installation>`__
 
+.. _connect-atlas-rust-driver:
 
 Connect to MongoDB Atlas
 ------------------------
@@ -114,11 +115,15 @@ corresponding connection code samples.
 
 .. include:: /includes/serverless-compatibility.rst
 
-Connect to ``localhost``
-------------------------
+Connect to a MongoDB Server on Your Local Machine
+-------------------------------------------------
 
 .. include:: /includes/localhost-connection.rst
 
+To test whether you can connect to your server, replace the connection
+string in the :ref:`Connect to MongoDB Atlas <connect-atlas-rust-driver>` code
+example and run it.
+
 Compatibility
 -------------