SolrCloud迁移咨询：从Solr 4.7.2单机多核心升级实现跨核心搜索

嘿，我来帮你梳理从Solr 4.7.2单机多核心迁移到SolrCloud的完整实施步骤，刚好之前处理过类似的升级迁移场景，一步步来很稳：

咱们的核心目标是：保留原有单核心（现在对应SolrCloud的Collection）的搜索能力+新增跨多Collection搜索，同时把LDAP组权限适配到SolrCloud的权限体系里。SolrCloud是现在Solr推荐的分布式架构，完全能替代旧的分布式搜索方案，而且扩展性更好。

1. 前期准备 #

• 备份旧数据与配置：先把Solr 4.7.2下每个核心的data目录（索引数据）和conf目录（schema.xml、solrconfig.xml等）完整备份，避免迁移出问题回滚无门。
• 确认新版Solr与ZooKeeper环境：SolrCloud依赖ZooKeeper来管理集群状态，如果你是单机测试过渡，可以用Solr自带的嵌入式ZK；生产环境建议单独部署ZK集群（至少3节点）。启动ZK后，确保新版Solr能正常连接。
• 适配旧配置到新版Solr：
  • 把旧核心的schema.xml转换成新版的managed-schema（Solr 6+默认用managed schema，也可以继续用schema.xml，但推荐转成managed），注意字段类型、字段定义的兼容性，比如旧版本的一些过时字段类型要替换成新版的（比如text_general的配置可能有变化）。
  • 调整solrconfig.xml：移除旧版本的遗留配置（比如过时的requestHandler、分布式相关的旧配置），添加SolrCloud需要的配置，比如<shardHandlerFactory>，还有确保DataImportHandler（如果用的话）的配置正确。

2. 搭建SolrCloud集群 #

• 初始化ZK配置集：把适配好的每个核心的配置上传到ZK，用命令：

  bin/solr zk upconfig -n core1-config -d /path/to/your/adapted/core1/conf -z zk-host:port
  

  每个核心对应一个ZK配置集，方便后续创建Collection时指定。
• 创建SolrCloud Collection：对应旧的每个核心，创建一个Collection（先从单shard单replica开始，后续再扩展）：

  bin/solr create -c core1 -n core1-config -shards 1 -replicationFactor 1 -z zk-host:port
  

  重复这个命令创建所有需要的Collection。

3. 导入旧数据 #

• 方式一：备份恢复：如果旧版本的备份能兼容新版，先在旧Solr里执行备份：

  curl "http://old-solr-host:8983/solr/core1/replication?command=backup&location=/path/to/backup"
  

  然后把备份文件放到新版Solr的指定目录，执行恢复：

  curl "http://new-solr-host:8983/solr/core1/replication?command=restore&location=/path/to/backup"
  

• 方式二：重新索引：如果备份兼容性有问题，就用旧数据源重新索引到新版Solr的对应Collection里，比如用DataImportHandler或者bin/post工具批量导入。

4. 配置跨Collection搜索 #

SolrCloud实现跨多Collection搜索很简单，有两种常用方式：

• 直接指定多个Collection查询：在搜索请求里用collection参数指定多个Collection，比如：

  http://new-solr-host:8983/solr/select?q=*:*&collection=core1,core2,core3
  

• 创建Collection别名：如果不想每次都写多个Collection名字，可以创建一个别名，把需要跨搜的Collection都加进去：

  bin/solr create alias cross-collection -c core1,core2,core3 -z zk-host:port
  

  之后直接查询这个别名就能实现跨搜：

  http://new-solr-host:8983/solr/cross-collection/select?q=*:*
  

5. 适配LDAP组权限控制 #

原来每个核心由LDAP组保护，现在要映射到SolrCloud的权限体系里，用Solr的Security Plugin来实现：

• 启用Security Plugin：先启用Solr的安全框架：

  curl -X POST -H 'Content-type:application/json' --data-binary '{"set-property": {"authentication": "SolrLdapAuthenticationPlugin"}}' http://new-solr-host:8983/solr/admin/security
  

• 配置LDAP认证：设置LDAP服务器地址、用户搜索DN等参数：

  curl -X POST -H 'Content-type:application/json' --data-binary '{
    "set-property": {
      "authentication.ldap.url": "ldap://your-ldap-host:389",
      "authentication.ldap.userBaseDn": "ou=users,dc=example,dc=com",
      "authentication.ldap.userSearchFilter": "(uid={0})"
    }
  }' http://new-solr-host:8983/solr/admin/security
  

• 配置基于LDAP组的授权：创建角色，对应LDAP组，然后给角色分配对应Collection的权限：
  比如给LDAP组core1-users创建角色core1-role，并赋予core1Collection的读写权限：

  # 创建角色
  curl -X POST -H 'Content-type:application/json' --data-binary '{"create-role": {"role-name": "core1-role"}}' http://new-solr-host:8983/solr/admin/security
  # 映射LDAP组到角色
  curl -X POST -H 'Content-type:application/json' --data-binary '{"set-user-role": {"username": "*", "role": "core1-role", "group": "cn=core1-users,ou=groups,dc=example,dc=com"}}' http://new-solr-host:8983/solr/admin/security
  # 给角色分配权限
  curl -X POST -H 'Content-type:application/json' --data-binary '{"set-permission": {"name": "core1-read-write", "path": "/solr/core1/*", "role": "core1-role", "permission": "read,write"}}' http://new-solr-host:8983/solr/admin/security
  

  同理配置其他LDAP组对应的角色和权限，跨Collection搜索的权限可以给对应的LDAP组分配所有需要的Collection的权限，或者给跨Collection别名配置权限。

• 验证单Collection搜索：用对应LDAP组的用户登录，搜索指定Collection，确认数据正确、权限生效（非授权用户无法访问）。
• 验证跨Collection搜索：用有权限的用户查询跨搜别名或多个Collection，确认能返回所有匹配的结果。
• 验证集群状态：访问http://new-solr-host:8983/solr/admin/collections?action=CLUSTERSTATUS，确认所有Collection状态正常。

内容的提问来源于stack exchange，提问作者LBK