early draft

Author: Bob Grabar

source/administration/sharding.txt

@@ -200,11 +200,44 @@ Cluster Management
 
 Once you have a running sharded cluster, you will need to maintain it.
 This section describes common maintenance procedure, including: how to
-add and remove nodes, how to manually split chunks, and how to disable
+add and remove shards, how to manually split chunks, and how to disable
 the balancer for backups.
 
-List all Shards
-~~~~~~~~~~~~~~~
+List Databases with Sharding Enabled
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To list the databases for which sharding is enabled, query the
+``databases`` collection in the :ref:`config database
+<config-database>`. The databases with the ``partitioned`` field set to
+``true`` have sharding enabled.
+
+.. example:: Run this sequence of commands to open the :ref:`config
+   database <config-database>` and query the ``databases`` collection.
+
+   .. code-block:: javascript
+
+      use config
+
+      db.databases.find()
+
+   Given the following example output:
+
+   .. code-block:: javascript
+
+      { "_id" : "admin", "partitioned" : false, "primary" : "config" }
+
+      { "_id" : "foo", "partitioned" : true, "primary" : "example1.com:30001" }
+
+      { "_id" : "baz", "partitioned" : false, "primary" : "example2.com:27017" }
+
+   Only the database `foo` has sharding enabled because only `foo` has
+   the ``partitioned`` field set to ``true``.
+
+.. note:: If a database in a sharded environment does not have sharding
+   enabled, all its data is on the first shard of the cluster.
+
+List Shards
+~~~~~~~~~~~
 
 To list the current set of configured shards and verify that all shards
 have been committed to the system, run the :dbcommand:`listShards`
@@ -216,6 +249,32 @@ command:
 
 .. _sharding-procedure-add-shard:
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 Add a Shard to a Cluster
 ~~~~~~~~~~~~~~~~~~~~~~~~
 

source/reference/glossary.txt

@@ -881,3 +881,5 @@ Glossary
    primary shard
       For a database in which :term:`sharding` is enabled, the primary
       shard holds all un-sharded collections.
+
+      .. seealso:: :ref:`sharding-sharded-and-unsharded-data`