从2.6降级MongoDB_MonogDB 中文网

MongoDB 中文手册

参考 > 发行说明 > MongoDB 2.6发行说明 > 从2.6降级MongoDB

在本页面

降级建议和清单
降级2.6用户授权模型
降级更新的索引
降级MongoDB进程
降级程序

在尝试任何降级之前，请熟悉本文档的内容，尤其是《降级建议和清单》以及降级群集的过程。

降级建议和清单¶

降级时，请考虑以下因素：

降级路径¶

升级到MongoDB 2.6后，您将无法降级到MongoDB 2.4之前的任何版本。如果您在运行2.6时创建text或创建2dsphere索引，则只能降级到MongoDB 2.4.10或更高版本。

防范¶

在将MongoDB 2.6降级到2.4之前，请删除或降级版本2的文本索引。
在将MongoDB 2.6降级到2.4之前，请删除或降级版本2 2dsphere索引。
降级2.6用户授权模型。如果已升级到2.6用户授权模型，则必须先将用户模型降级为2.4，然后再将MongoDB 2.6降级为2.4。

程序¶

请遵循降级过程：

要降级分片群集，请参阅降级2.6分片群集。
要降级副本集，请参阅降级2.6副本集。
要降级独立MongoDB实例，请参阅降级2.6独立mongod实例。

降级2.6用户授权模型¶

如果已升级到2.6用户授权模型，则必须先将用户授权模型降级为2.4，然后再将MongoDB 2.6降级为2.4。

注意事项¶

对于副本集，只需要在主数据库上运行降级过程，因为更改将自动复制到辅助数据库。
对于分片群集，尽管此过程首先列出了该群集的授权数据的降级，但是您可以首先降级该群集或分片的授权数据。
你必须有admin.system.backup_users和 admin.system.new_users在升级过程中创建的集合。
重要的。降级过程将用户数据返回到升级到2.6授权模型之前的状态。使用2.6用户模型对用户/角色数据所做的任何更改都将丢失。

访问控制先决条件¶

要降级授权模型，必须以具有以下特权的用户身份进行连接：

复制

{ resource: { db: "admin", collection: "system.new_users" }, actions: [ "find", "insert", "update" ] }
{ resource: { db: "admin", collection: "system.backup_users" }, actions: [  "find" ] }
{ resource: { db: "admin", collection: "system.users" }, actions: [ "find", "remove", "insert"] }
{ resource: { db: "admin", collection: "system.version" }, actions: [ "find", "update" ] }

如果不存在具有适当特权的用户，请创建一个授权模型降级用户：

1个

以具有特权的用户身份连接来管理用户和角色。¶

使用进行用户连接并进行身份验证 userAdminAnyDatabase。

创建具有所需特权的角色。¶

使用该db.createRole方法，创建具有所需特权的角色。

复制

use admin
db.createRole(
  {
    role: "downgradeAuthRole",
    privileges: [
      { resource: { db: "admin", collection: "system.new_users" }, actions: [ "find", "insert", "update" ] },
      { resource: { db: "admin", collection: "system.backup_users" }, actions: [  "find" ] },
      { resource: { db: "admin", collection: "system.users" }, actions: [ "find", "remove", "insert"] },
      { resource: { db: "admin", collection: "system.version" }, actions: [ "find", "update" ] }
    ],
    roles: [ ]
  }
)

创建一个具有新角色的用户。¶

创建一个用户并为该用户分配downgradeRole。

复制

use admin
db.createUser(
   {
     user: "downgradeAuthUser",
     pwd: "somePass123",
     roles: [ { role: "downgradeAuthRole", db: "admin" } ]
   }
)

注意

除了创建新用户，您还可以将角色授予现有用户。参见db.grantRolesToUser()方法。

验证为新用户。¶

验证为新创建的用户。

复制

use admin
db.auth( "downgradeAuthUser", "somePass123" )

该方法1在身份验证成功后返回。

程序¶

以下降级过程要求<database>.system.users 使用版本2.4中的集合。对于非admin 数据库完整无缺。

1个

连接并验证MongoDB实例。¶

mongod对于单个部署或mongos具有适当特权的分片群集，请连接到实例并进行身份验证。有关详细信息，请参见访问控制先决条件。

创建2.6 `admin.system.users`集合的备份。¶

将admin.system.users集合中的所有文档复制到admin.system.new_users集合中：

复制

db.getSiblingDB("admin").system.users.find().forEach( function(userDoc) {
    status = db.getSiblingDB("admin").system.new_users.save( userDoc );
    if (status.hasWriteError()) {
        print(status.writeError);
    }
  }
);

更新的版本文档`authSchema`。¶

复制

db.getSiblingDB("admin").system.version.update(
   { _id: "authSchema" },
   { $set: { currentVersion: 2 } }
);

该方法返回具有WriteResult操作状态的对象。成功更新后，WriteResult对象应"nModified"等于1。

从`admin.system.users`集合中删除现有文档。¶

复制

db.getSiblingDB("admin").system.users.remove( {} )

该方法返回一个WriteResult对象，该对象具有在该"nRemoved"字段中删除的文档数。

复制`admin.system.backup_users`集合中的文档。¶

将admin.system.backup_users2.6升级期间创建的的所有文档复制到admin.system.users。

复制

db.getSiblingDB("admin").system.backup_users.find().forEach(
   function (userDoc) {
      status = db.getSiblingDB("admin").system.users.insert( userDoc );
      if (status.hasWriteError()) {
          print(status.writeError);
      }
   }
);

更新的版本文档`authSchema`。¶

复制

db.getSiblingDB("admin").system.version.update(
   { _id: "authSchema" },
   { $set: { currentVersion: 1 } }
)

对于分片群集，通过连接到每个分片的主副本集成员来重复降级过程。

注意

集群mongos实例将无法检测到授权模型降级，直到刷新用户缓存为止。您可以invalidateUserCache在每个mongos 实例上运行以立即刷新，也可以等到缓存在末尾自动刷新。要运行，您必须具有操作特权，该特权由和角色授予。user cache invalidation intervalinvalidateUserCacheinvalidateUserCacheuserAdminAnyDatabasehostManager

结果¶

降级过程将用户数据返回到升级到2.6授权模型之前的状态。使用2.6用户模型对用户/角色数据所做的任何更改都将丢失。

降级更新的索引¶

文本索引版本检查¶

如果您具有版本2文本索引（即MongoDB 2.6中文本索引的默认版本），请在降级MongoDB之前删除版本2文本索引。降级后，启用文本搜索并重新创建删除的文本索引。

要确定text索引的版本，请运行 db.collection.getIndexes()以查看索引规格。对于文本索引，该方法在字段中返回版本信息 textIndexVersion。例如，以下显示 text了quotes集合上的索引是版本2。

复制

{
   "v" : 1,
   "key" : {
      "_fts" : "text",
      "_ftsx" : 1
   },
   "name" : "quote_text_translation.quote_text",
   "ns" : "test.quotes",
   "weights" : {
      "quote" : 1,
      "translation.quote" : 1
   },
   "default_language" : "english",
   "language_override" : "language",
   "textIndexVersion" : 2
}

`2dsphere`索引版本检查¶

如果您具有版本2 2dsphere索引（即2dsphereMongoDB 2.6中索引的默认版本），请在降级MongoDB之前删除版本2 2dsphere索引。降级后，重新创建2dsphere索引。

要确定2dsphere索引的版本，请运行 db.collection.getIndexes()以查看索引规格。对于 2dsphere索引，该方法在字段中返回版本信息 2dsphereIndexVersion。例如，以下显示 2dsphere了locations集合上的索引是版本2。

复制

{
   "v" : 1,
   "key" : {
      "geo" : "2dsphere"
   },
   "name" : "geo_2dsphere",
   "ns" : "test.locations",
   "sparse" : true,
   "2dsphereIndexVersion" : 2
}

降级MongoDB进程¶

降级2.6独立`mongod`实例¶

以下步骤概述了将独立mongod版本从2.6 降级到2.4的过程。

从MongoDB下载页面下载 2.4系列最新版本的二进制文件。有关更多信息，请参阅安装MongoDB。
关闭您的mongod实例。将现有的二进制文件替换为2.4 mongod二进制文件，然后重新启动 mongod。

降级2.6副本集¶

以下步骤概述了副本集的“滚动”降级过程。“滚动”降级过程通过在其他成员可用时分别对成员进行降级来最大程度地减少停机时间：

1个

降级每个辅助成员，一次降级。¶

对于副本集中的每个辅助节点：

替换并重新启动辅助`mongod`实例。¶

首先，关闭mongod，然后将这些二进制文件替换为2.4二进制文件并重新启动mongod。有关安全终止进程的说明，请参阅停止mongod进程 mongod。

允许辅助恢复。¶

等待成员恢复SECONDARY状态，然后再升级下一个辅助节点。

要检查成员的状态，请使用外壳程序中的rs.status() 方法mongo。

降级主要。¶

rs.stepDown()在mongo外壳程序中使用以降低主要服务器并强制执行正常的故障转移过程。

复制

rs.stepDown()

rs.stepDown() 加快故障转移过程，并且: 最好直接关闭主数据库。

替换并重新启动以前的primary `mongod`。¶

当rs.status()显示主节点已退出并且另一个成员已PRIMARY进入状态时，请关闭先前的主节点，并用mongod2.4二进制文件替换二进制文件并启动新实例。

副本集故障转移不是即时的，但将导致该集不可用于写入和中断读取，直到故障转移过程完成为止。通常，这需要10秒钟或更长时间。您可能希望在预定的维护时段内计划降级。

降级2.6分片群集¶

要求¶

在降级过程中，您无法更改集合元数据。例如，降级过程中，千万不能做任何以下内容：

sh.enableSharding()
sh.shardCollection()
sh.addShard()
db.createCollection()
db.collection.drop()
db.dropDatabase()
创建数据库的任何操作
以任何方式修改集群元数据的任何其他操作。有关分片命令的完整列表，请参见分片参考。但是请注意，并非“分片参考”页面上的所有命令都会修改集群元数据。

程序¶

分片群集的降级过程将逆转升级过程的顺序。

关闭平衡器的分片集群中，如在禁用平衡器。
降级每个碎片，一次降级。对于每个分片，
1. 降级mongod次级之前降级的主。
2. 要降级主数据库，请运行replSetStepDown并降级。
降级所有3个mongod配置服务器实例，在参数中将第一个系统降级为last。mongos --configdb
一次降级并重新启动每个mongos。降级过程是二进制的直接替代。
如启用平衡器中所述打开平衡器。

降级程序¶

升级到MongoDB 2.6后，您将无法降级到MongoDB 2.4之前的任何版本。如果有text或2dsphere索引，则只能降级到MongoDB 2.4.10或更高版本。

除非本页中有描述，否则在2.4和2.6之间移动是一种直接替代：

1个

停止现有`mongod`实例。¶

例如，在Linux上，mongod使用以下 --shutdown选项运行2.6 ：

复制

mongod --dbpath /var/mongod/data --shutdown

/var/mongod/data用您的MongoDB 替换dbPath。另请参见Stop mongod进程，以了解停止mongod实例的替代方法。

启动新`mongod`实例。¶

确保mongod以相同的方式启动2.4 dbPath：

复制

mongod --dbpath /var/mongod/data

/var/mongod/data用您的MongoDB 替换dbPath。

MongoDB 中文手册

从2.6降级MongoDB

降级建议和清单¶

降级路径¶

防范¶

程序¶

降级2.6用户授权模型¶

注意事项¶

访问控制先决条件¶

以具有特权的用户身份连接来管理用户和角色。¶

创建具有所需特权的角色。¶

创建一个具有新角色的用户。¶

验证为新用户。¶

程序¶

连接并验证MongoDB实例。¶

创建2.6 admin.system.users集合的备份。¶

更新的版本文档authSchema。¶

从admin.system.users集合中删除现有文档。¶

复制admin.system.backup_users集合中的文档。¶

更新的版本文档authSchema。¶

结果¶

降级更新的索引¶

文本索引版本检查¶

2dsphere索引版本检查¶

降级MongoDB进程¶

降级2.6独立mongod实例¶

降级2.6副本集¶

降级每个辅助成员，一次降级。¶

替换并重新启动辅助mongod实例。¶

允许辅助恢复。¶

降级主要。¶

替换并重新启动以前的primary mongod。¶

降级2.6分片群集¶

要求¶

程序¶

降级程序¶

停止现有mongod实例。¶

启动新mongod实例。¶

创建2.6 `admin.system.users`集合的备份。¶

更新的版本文档`authSchema`。¶

从`admin.system.users`集合中删除现有文档。¶

复制`admin.system.backup_users`集合中的文档。¶

更新的版本文档`authSchema`。¶

`2dsphere`索引版本检查¶

降级2.6独立`mongod`实例¶

替换并重新启动辅助`mongod`实例。¶

替换并重新启动以前的primary `mongod`。¶

停止现有`mongod`实例。¶

启动新`mongod`实例。¶