Creating a shard cluster with MongoDB commands

You create a shard cluster by adding shard servers with the MongoDB shell command sh.addShard command or the db.runCommand command with the addShard syntax.

Before you begin

The shard servers must be prepared for sharding. See Preparing shard servers.

Procedure

To create a shard cluster from the MongoDB shell:
  1. Run the mongo command to start the MongoDB shell.
  2. Run one of the following commands with the host name and port that is specified for the HCL OneDB™ server that you want to add. The specified port must run the HCL OneDB network-based listener, for example the onsoctcp protocol.
    1. Run the sh.addShard command.
    2. Run the db.runCommand with the addShard command syntax. You can include the fully qualified domain name of the server instead of the host name. You can specify multiple servers.

Results

A shard cluster is created with the specified shard servers. Each shard server is set up with Enterprise Replication and assigned an Enterprise Replication group name in its sqlhosts file. The default Enterprise Replication group name for a database server is the database server name with a suffix of g_. For example, the default Enterprise Replication group name for a database server that is named myserver is g_myserver.

Examples

Add a server to a shard cluster with addShard
The following command adds the database server that is at port 9202 of myhost2.hcl.com to a shard cluster:
> sh.addShard("myhost2.hcl.com:9202")
Add a server to a shard cluster with db.runCommand and addShard
The following command adds the database server that is at port 9204 of myhost4.hcl.com to a shard cluster.
> db.runCommand({"addShard":"myhost4.hcl.com:9204"})
Add multiple servers to a shard cluster
This example adds the database servers that are at port 9205 of myhost5.hcl.com, port 9206 of myhost6.hcl.com, and port 9207 of myhost7.hcl.com to a shard cluster.
> db.runCommand({"addShard":["myhost5.hcl.com:9205",
    "myhost6.hcl.com:9206","myhost7.hcl.com:9207"]})