Skip to content

Commit 86555b5

Browse files
author
Sam Kleinman
committed
DOCS-93 tutorial work and edits
1 parent 14e12ac commit 86555b5

File tree

4 files changed

+42
-7
lines changed

4 files changed

+42
-7
lines changed

draft/administration/sharding.txt

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,8 @@ cluster` from scratch, use the following procedure as a starting point:
3434

3535
#. Provision the required hardware.
3636

37-
The ":ref:`sharding-requirements`" describes what you'll need to get started.
37+
The ":ref:`sharding-requirements`" section describes what you'll
38+
need to get started.
3839

3940
#. On all three (3) config server instances, issue the following
4041
command to start the :program:`mongod` process:
@@ -53,7 +54,7 @@ cluster` from scratch, use the following procedure as a starting point:
5354

5455
.. code-block:: sh
5556

56-
mongos --configdb config0.mongodb.example.net,config1.mongodb.example.net,config3.mongodb.example.net --port 27017
57+
mongos --configdb config0.mongodb.example.net,config1.mongodb.example.net,config2.mongodb.example.net --port 27017
5758

5859
#. Access the :program:`mongos` instance using the :program:`mongo`
5960
shell.

draft/core/sharding-internals.txt

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -183,8 +183,6 @@ from every shard before it can merge the results and return data. If
183183
you require high performance sorted queries, ensure that the sort key
184184
is a component of the shard key.
185185

186-
TODO fact check
187-
188186
Operations and Reliability
189187
~~~~~~~~~~~~~~~~~~~~~~~~~~
190188

@@ -352,6 +350,4 @@ command.
352350

353351
TODO how does a system balance shards if one shard can only hold 60% of the chunks of the others?
354352

355-
TODO how does the system handle
356-
357353
.. seealso:: ":doc:`/administration/monitoring`."

draft/core/sharding.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ the corresponding shard keys.
125125
overcapacity to enable sharding.
126126

127127
.. index:: sharding; requirements
128-
.. _sharding-requirements:
128+
.. _sharding-requirements-infrastructure:
129129

130130
Requirements
131131
------------
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,41 @@
11
======================
22
Deploy a Shard Cluster
33
======================
4+
5+
.. default-domain:: mongodb
6+
7+
Synopsis
8+
--------
9+
10+
This document outlines the full procedure for deploying a
11+
:term:`sharded cluster <shard cluster>` in MongoDB. Use the
12+
":doc:`/tutorial/convert-replica-set-to-replicated-shard-cluster`"
13+
procedure if you have an existing replica set. If you have a
14+
standalone :program:`mongod` instance you can use this tutorial to
15+
deploy a sharded cluster.
16+
17+
Requirements
18+
------------
19+
20+
See the ":ref:`Requirements for Shard Clusters
21+
<sharding-requirements`" section for more information about potential
22+
requirements for sharded cluster.
23+
24+
Procedure
25+
---------
26+
27+
Initiate Config Database Instances
28+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
29+
30+
Start ``mongos`` Instances
31+
~~~~~~~~~~~~~~~~~~~~~~~~~~
32+
33+
Add Shards to the Cluster
34+
~~~~~~~~~~~~~~~~~~~~~~~~~
35+
36+
Enable Sharding for Databases
37+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38+
39+
Enable Sharding for Collections
40+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41+

0 commit comments

Comments
 (0)