replSetInitiate (database command数据库命令)

Definition定义

replSetInitiate

The replSetInitiate command initializes a new replica set.replSetInitiate命令初始化新的副本集。

Tip

In mongosh, this command can also be run through the rs.initiate() helper method.在mongosh中，此命令也可以通过rs.initiate()辅助方法运行。

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.助手方法对mongosh用户来说很方便，但它们可能不会返回与数据库命令相同级别的信息。如果不需要便利性或需要额外的返回字段，请使用数据库命令。

To run replSetInitiate, use the db.runCommand( { <command> } ) method.要运行replSetInitiate，请使用db.runCommand( { <command> } )方法。

Note

Run the command on only one of the mongod instances for the replica set.仅在副本集的一个mongod实例上运行该命令。

Compatibility兼容性

This command is available in deployments hosted in the following environments:此命令在以下环境中托管的部署中可用：

• MongoDB Enterprise: The subscription-based, self-managed version of MongoDB：MongoDB的基于订阅的自我管理版本
• MongoDB Community: The source-available, free-to-use, and self-managed version of MongoDB：MongoDB的源代码可用、免费使用和自我管理版本

Syntax语法

The command has the following syntax:该命令具有以下语法：

db.runCommand(
   {
     replSetInitiate : <config_document>
   }
)

The <config_document> is a document that specifies the replica set's configuration. For instance, here's a config document for creating a simple 3-member replica set:<config.docu>是一个指定副本集配置的文档。例如，这里有一个配置文档，用于创建一个简单的3成员副本集：

{
    _id : <setname>,
     members : [
         {_id : 0, host : <host0>},
         {_id : 1, host : <host1>},
         {_id : 2, host : <host2>},
     ]
}

IP BindingIP绑定

MongoDB binaries, mongod and mongos, bind to localhost by default. MongoDB二进制文件mongod和mongos默认绑定到localhost。If the net.ipv6 configuration file setting or the --ipv6 command line option is set for the binary, the binary additionally binds to the localhost IPv6 address.如果为二进制文件设置了net.ipv6配置文件设置或--ipv6命令行选项，则该二进制文件还会绑定到localhost ipv6地址。

By default mongod and mongos that are bound to localhost only accept connections from clients that are running on the same computer. 默认情况下，绑定到localhost的mongod和mongos只接受来自在同一台计算机上运行的客户端的连接。This binding behavior includes mongosh and other members of your replica set or sharded cluster. Remote clients cannot connect to binaries that are bound only to localhost.此绑定行为包括mongosh和副本集或分片集群的其他成员。远程客户端无法连接到仅绑定到localhost的二进制文件。

To override the default binding and bind to other IP addresses, use the net.bindIp configuration file setting or the --bind_ip command-line option to specify a list of hostnames or IP addresses.要覆盖默认绑定并绑定到其他IP地址，请使用net.bindIp配置文件设置或--bind_ip命令行选项指定主机名或IP地址列表。

For example, the following mongod instance binds to both the localhost and the hostname My-Example-Associated-Hostname, which is associated with the IP address 198.51.100.1:例如，以下mongod实例绑定到localhost和主机名My-Example-Associated-Hostname，后者与IP地址198.51.100.1相关联：

mongod --bind_ip localhost,My-Example-Associated-Hostname

In order to connect to this instance, remote clients must specify the hostname or its associated IP address 198.51.100.1:为了连接到此实例，远程客户端必须指定主机名或其关联的IP地址198.51.100.1：

mongosh --host My-Example-Associated-Hostname

mongosh --host 198.51.100.1

Example示例

Assign a config document to a variable and then to pass the document to the rs.initiate() helper:将配置文档分配给变量，然后将文档传递给rs.initiate()帮助程序：

config = {
    _id : "my_replica_set",
     members : [
         {_id : 0, host : "rs1.example.net:27017"},
         {_id : 1, host : "rs2.example.net:27017"},
         {_id : 2, host : "rs3.example.net", arbiterOnly: true},
     ]
}

rs.initiate(config)

Notice that omitting the port cause the host to use the default port of 27017. Notice also that you can specify other options in the config documents such as the arbiterOnly setting in this example.请注意，省略端口会导致主机使用默认端口27017。还请注意，您可以在配置文档中指定其他选项，例如本例中的arbiterOnly设置。