solr 5.0.0 bin/start脚本详细解析

参考文档：https://cwiki.apache.org/confluence/display/solr/Solr+Start+Script+Reference#SolrStartScriptReference-SolrCloudMode

 

环境：

CentOS 6.5, JRE 1.7, Solr 5.0.0, ZooKeeper 3.6

 

一、启动、停止操作

1. 启动、重启

./bin/solr start [options]

./bin/solr start -help

./bin/solr restart [options]

./bin/solr restart -help

 

 

1.1 命令可选项

参数

描述

样例

-a "<string>"    

启动Solr时，添加额外的JVM参数                    
[html] view plain copy
 
  1. bin/solr start -a   
  2. "-Xdebug -Xrunjdwp:transport=dt_socket,   
  3. server=y,suspend=n,address=1044"  










-cloud




以SolrCloud模式启动Solr


简短写法：-c


 


 ./bin/solr start -c




-d <dir>


定义server目录，默认是server ( $SOLR_HOME/server)，


一般不会重置这个目录


./bin/solr start -d newServerDir




-e <name>


以样例配置启动Solr


可选项为：


    

  • cloud
    • 

  • techproducts
    • 

  • dih
    • 

  • schemaless
    • 





./bin/solr start -e schemaless






-f


前端方式启动Solr服务，


运行样例时不可以此方式启动


./bin/solr start -f




-h <hostname>


启动时， 为Solr服务指定hostname, 默认为'localhost'


 


./bin/solr start -h search.mysolr.com




-m <memory>


启动时， 为JVM指定最小（-Xms）和最大（-Xmx）堆大小


 


 ./bin/solr start -m 1g




-noprompt


启动时，接受一切默认设置，不需要交互确认


 


./bin/solr start -e cloud -noprompt




-p <port>


在指定的端口启动Solr服务，默认为'8983'


 


./bin/solr start -p 8655




-s <dir>


设置solr.solr.home系统属性，默认server/solr.


 


./bin/solr start -s newHome




-V


启动Solr服务时， 显示冗余信息


 


 ./bin/solr start -V




-z <zkHost>


以ZooKeeper连接串启动Solr服务，本选项只在SolrCloud运行模型下使用；


如果不指定本选项，则启动Solr内嵌的ZooKeeper 实例


./bin/solr start -c -z server1:2181,server2:2181






 


启动时，默认设置如何，以下两个启动命令效果一样：


./bin/solr start


./bin/solr start -h localhost -p 8983 -d server -s solr -m 512m


 


1.2 设置JAVA系统属性


bin/solr脚本可以传递任何以'-D'开始的参数到JVM


eg.



./bin/solr start -Dsolr.autoSoftCommit.maxTime=3000


 


 


 


1.3 SolrCloud模式


'-c'和'-cloud'两个选项是等价的：


./bin/solr start -c
./bin/solr start -cloud


 


以SolrCloud模式启动Solr服务时，如果指定了ZooKeeper连接串，（如，-z 192.168.1.4:2181），Solr则会连接到指定的ZooKeeper实例，并加入到集群；如果没有指定'-z', Solr则会启动内嵌的一个ZooKeeper实例，监听在端口——Solr端口+1000，（如，如果Solr端口为8983, 则内嵌ZooKeeper端口为9933）


 


注意：


如果ZooKeeper连接串使用了chroot, （如，localhost:2181/solr）， 那么在加入到SolrCloud之前，你需要引导 /solr  ZooKeeper节点, 使用Solr包自带的zkcli.sh脚本，例如：


 






[html] view plain copy

 










    

  1. server/scripts/cloud-scripts/zkcli.sh -zkhost localhost:2181/solr -cmd bootstrap -solrhome server/solr  
    2. 





 


 


 


 


1.4  运行样例配置


./bin/solr start -e <name>


样例配置方便你快速学习Solr，主要提供提供了以下几种样例：


cloud 本样例在单机上启动了1到4个节点的SolrCloud集群，当你选择以交互式会话的方式启动服务时，它将引导你选择集群的节点数，端口，创建的collection名称


techproducts 本样例在单机上以独立模式启动了Solr服务，使用了为$SOLR_HOME/example/exampledocs 目录中文档设计好的scheme.xml, 配置目录(configset)为$SOLR_HOME/server/solr/configsets/sample_techproducts_configs


dih 本样例在单机上以独立模式启动Solr服务，并且开启了 DataImportHandler (DIH) , 另外，为多种数据类型(如, database contents, email, RSS feeds， 等)提供了预配置好的样例dataconfig.xml


schemaless 本样例在单机上以独立模式启动Solr服务，并且使用了managed schema, 提供了一个最小化的预定义的Scheme. 在索引文档时，Solr会根据提交的文档自动判断字段类型并动态的添加字段到Schem, 对应的配置目录为$SOLR_HOME/server/solr/configsets/data_driven_schema_configs.


 


2. 状态检查


status命令会以JSON格式显示本系统上所有在运行的Solr服务实例， 通过SOLR_PID_DIR环境变量定位Solr服务进程PID的存储文件，进而发现Solr服务实例。 默认SOLR_PID_DIR在bin目录下。


以下是在单机集群上运行status的样例：


 






[html] view plain copy

 










    

  1. Found 2 Solr nodes:   
    2. 

  2.   
    3. 

  3.    
    4. 

  4.   
    5. 

  5. Solr process 39920 running on port 7574  
    6. 

  6.   
    7. 

  7. {  
    8. 

  8.   
    9. 

  9.   "solr_home":"/Applications/Solr/solr-5.0.0/example/cloud/node2/solr/",  
    10. 

  10.   
    11. 

  11.   "version":"5.0.0 1658469 - anshumgupta - 2015-02-09 09:54:36",  
    12. 

  12.   
    13. 

  13.   "startTime":"2015-02-10T17:19:54.739Z",  
    14. 

  14.   
    15. 

  15.   "uptime":"1 days, 23 hours, 55 minutes, 48 seconds",  
    16. 

  16.   
    17. 

  17.   "memory":"77.2 MB (%15.7) of 490.7 MB",  
    18. 

  18.   
    19. 

  19.   "cloud":{  
    20. 

  20.   
    21. 

  21.     "ZooKeeper":"localhost:9865",  
    22. 

  22.   
    23. 

  23.     "liveNodes":"2",  
    24. 

  24.   
    25. 

  25.     "collections":"2"}}  
    26. 

  26.   
    27. 

  27.    
    28. 

  28.   
    29. 

  29. Solr process 39827 running on port 8865  
    30. 

  30.   
    31. 

  31. {  
    32. 

  32.   
    33. 

  33.   "solr_home":"/Applications/Solr/solr-5.0.0/example/cloud/node1/solr/",  
    34. 

  34.   
    35. 

  35.   "version":"5.0.0 1658469 - anshumgupta - 2015-02-09 09:54:36",  
    36. 

  36.   
    37. 

  37.   "startTime":"2015-02-10T17:19:49.057Z",  
    38. 

  38.   
    39. 

  39.   "uptime":"1 days, 23 hours, 55 minutes, 54 seconds",  
    40. 

  40.   
    41. 

  41.   "memory":"94.2 MB (%19.2) of 490.7 MB",  
    42. 

  42.   
    43. 

  43.   "cloud":{  
    44. 

  44.   
    45. 

  45.     "ZooKeeper":"localhost:9865",  
    46. 

  46.   
    47. 

  47.     "liveNodes":"2",  
    48. 

  48.   
    49. 

  49.     "collections":"2"}}  
    50. 





 


 


 


3. 停止


stop命令会发送一个STOP请求到一个运行的Solr节点，请求节点优雅的停止；该命令会等待节点优雅停止，5秒后未停止，则执行强制杀死服务进程(kill -9).


./bin/solr stop [options]

./bin/solr stop -help


 


 


 


3.1 命令可选项






参数
描述


样例












-p


<port>                                         




停止运行在指定端口的服务                                       






[html] view plain copy

 










    

  1. <pre class="html" name="code">./bin/solr stop -p 8983  
    2. 













-k <key>


 


停止KEY, 用于防止Solr意外停止，默认是“solrrocks”






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr stop -k solrrocks  
    2. 











-all


 


停止所有有效PID的Solr服务进程






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr stop -all  
    2. 











4. 健康检查


在SolrCloud模式下，healthcheck会为指定的collection生成一份JSON格式的体检报告；内容为该集合中所有shard的每个replica的状态信息，包括提交的文档数和当前的状态信息。


./bin/solr healthcheck [options]

./bin/solr healthcheck -help


 


 


 


4.1 命令可选项








参数






描述






样例












-c <collection>                 


 




希望体检的collection名称（必须）                                             






[html] view plain copy

 










    

  1. ./bin/solr healthcheck -c gettingstarted  
    2. 







                       		








-z <zkhost>


 




ZooKeeper连接串，默认为Solr端口+1000






[html] view plain copy

 










    

  1. <pre class="html" name="code">./bin/solr healthcheck -z localhost:2181  
    2. 













 


以下是一份2个节点，并且使用内嵌ZooKeeper的体检请求和响应：


 






[html] view plain copy

 






    

  1. $ ./bin/solr healthcheck -c gettingstarted -z localhost:9865  
    2. 

  2.   
    3. 

  3.    
    4. 

  4.   
    5. 

  5. {  
    6. 

  6.   
    7. 

  7.   "collection":"gettingstarted",  
    8. 

  8.   
    9. 

  9.   "status":"healthy",  
    10. 

  10.   
    11. 

  11.   "numDocs":0,  
    12. 

  12.   
    13. 

  13.   "numShards":2,  
    14. 

  14.   
    15. 

  15.   "shards":[  
    16. 

  16.   
    17. 

  17.     {  
    18. 

  18.   
    19. 

  19.       "shard":"shard1",  
    20. 

  20.   
    21. 

  21.       "status":"healthy",  
    22. 

  22.   
    23. 

  23.       "replicas":[  
    24. 

  24.   
    25. 

  25.         {  
    26. 

  26.   
    27. 

  27.           "name":"core_node1",  
    28. 

  28.   
    29. 

  29.           "url":"http://10.0.1.10:8865/solr/gettingstarted_shard1_replica2/",  
    30. 

  30.   
    31. 

  31.           "numDocs":0,  
    32. 

  32.   
    33. 

  33.           "status":"active",  
    34. 

  34.   
    35. 

  35.           "uptime":"2 days, 1 hours, 18 minutes, 48 seconds",  
    36. 

  36.   
    37. 

  37.           "memory":"25.6 MB (%5.2) of 490.7 MB",  
    38. 

  38.   
    39. 

  39.           "leader":true},  
    40. 

  40.   
    41. 

  41.         {  
    42. 

  42.   
    43. 

  43.           "name":"core_node4",  
    44. 

  44.   
    45. 

  45.           "url":"http://10.0.1.10:7574/solr/gettingstarted_shard1_replica1/",  
    46. 

  46.   
    47. 

  47.           "numDocs":0,  
    48. 

  48.   
    49. 

  49.           "status":"active",  
    50. 

  50.   
    51. 

  51.           "uptime":"2 days, 1 hours, 18 minutes, 42 seconds",  
    52. 

  52.   
    53. 

  53.           "memory":"95.3 MB (%19.4) of 490.7 MB"}]},  
    54. 

  54.   
    55. 

  55.     {  
    56. 

  56.   
    57. 

  57.       "shard":"shard2",  
    58. 

  58.   
    59. 

  59.       "status":"healthy",  
    60. 

  60.   
    61. 

  61.       "replicas":[  
    62. 

  62.   
    63. 

  63.         {  
    64. 

  64.   
    65. 

  65.           "name":"core_node2",  
    66. 

  66.   
    67. 

  67.           "url":"http://10.0.1.10:8865/solr/gettingstarted_shard2_replica2/",  
    68. 

  68.   
    69. 

  69.           "numDocs":0,  
    70. 

  70.   
    71. 

  71.           "status":"active",  
    72. 

  72.   
    73. 

  73.           "uptime":"2 days, 1 hours, 18 minutes, 48 seconds",  
    74. 

  74.   
    75. 

  75.           "memory":"25.8 MB (%5.3) of 490.7 MB"},  
    76. 

  76.   
    77. 

  77.         {  
    78. 

  78.   
    79. 

  79.           "name":"core_node3",  
    80. 

  80.   
    81. 

  81.           "url":"http://10.0.1.10:7574/solr/gettingstarted_shard2_replica1/",  
    82. 

  82.   
    83. 

  83.           "numDocs":0,  
    84. 

  84.   
    85. 

  85.           "status":"active",  
    86. 

  86.   
    87. 

  87.           "uptime":"2 days, 1 hours, 18 minutes, 42 seconds",  
    88. 

  88.   
    89. 

  89.           "memory":"95.4 MB (%19.4) of 490.7 MB",  
    90. 

  90.   
    91. 

  91.           "leader":true}]}]}  
    92. 



 


 


 


二、Collection、Core操作


bin/solr脚本也能够帮助你创建collections(运行在SolrCloud模式)或者cores(运行在独立模式), 或者删除collections。


1. 创建


bin/solr create命令自动检测运行模式(SolrCloud或standalone)，然后根据模式执行创建collection还是core.


 


./bin/solr create options

./bin/solr create -help


 


 


 


1.1 命令可选项






参数
描述
样例








-c <name>


 




创建的collection或core的名称（必须）                                             






[html] view plain copy

 










    

  1. <pre class="html" name="code">./bin/solr create -c mycollection  
    2. 













-d <confdir>


配置文件目录，默认为data_driven_schema_configs    






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr create -d basic_configs  
    2. 











-n <configName>


 


配置名称，默认与collection或core相同






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr create -n basic  
    2. 











-p <port>


 


命令发送到的运行实例的端口，默认脚本会根据运行实例自动检测端口






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr create -p 8983  
    2. 











-s <shards>


-shards


collection被切割的shard数，默认为1；此参数只在solrCloud模式下有效






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr create -s 2  
    2. 











-rf <replicas>


-replicationFactor


collection中每篇文档的备份数，默认为1（没有备份）






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr -rf 2  
    2. 











1.2 配置目录和SolrCloud


在SolrCloud中创建collection之前，我们必须把collection用到的配置目录上传到ZooKeeper实例；create命令提供了几种collction与配置目录的工作方案，你最主要考虑是否决定让配置目录在多个collection之间共享。以下讲解几个样例，说明collection与配置目录如何工作的：


首先，如果你不指定-d或者-n选项，则默认的配置($SOLR_HOME/server/solr/configsets/data_driven_schema_configs/conf)会以collection相同的名称上传到ZooKeeper。例如，./bin/solr create -c contacts, 此命令将data_driven_schema_configs配置上传到ZooKeeper的/configs/contacts目录下。


如果你通过命令./bin/solr create -c contacts2，创建另外一个集合contacts2, 则data_driven_schema_configs的另一份拷贝被上传到ZooKeeper的/configs/contacts2目录下；对contacts配置的任何修改都不会影响到contacts2；简言之，创建collection时，默认会为每个新的collection创建一个独立的配置副本。


你可以使用-n选项，为上传到ZooKeeper中的配置命名。例如，命令./bin/solr create -c logs -d basic_configs -n basic会将 server/solr/configsets/basic_configs/conf配置目录上传到ZooKeeper的/configs/basic下。


我们可以使用-d选项指定非默认的配置, solr在server/solr/configsets下提供了一些内建的配置，你也可以通过-d选项指定自己的配置。例如，命令./bin/solr create -c mycoll -d /tmp/myconfigs会上传本地/tmp/myconfigs目录到ZooKeeper的/configs/mycoll，另外，ZooKeeper中的配置名称与collection相同，除非你使用了-n选项重新命名。


别的collections可以通过-n选项指定共享的配置，例如，命令./bin/solr create -c logs2 -n basic将创建logs2集合，并共享basic配置。


1.3 数据驱动的Scheme和共享配置


数据驱动的Scheme(data_driven_schema_configs)会随着索引的数据动态变化，因此，我们不建议你在collection之间共享数据驱动的Scheme,除非你确定各个collection继承共享配置集合中任何一个collection的变化。


2. 删除


delete命令自动检测服务运行模式(SolrCloud或Standalone)，并执行相应的删除collection(SolrCloud模式)或者core(Standalone模式)操作。


 


./bin/solr delete [options]

./bin/solr delete -help


 






[html] view plain copy

 










    

  1. </pre><pre class="html" name="code">如果运行在SolrCloud模式，delete命令会检查待删除collection使用的配置是否被其他collection共享，如果有，则不删除ZooKeeper中对应的配置，否则，直接删除ZooKeeper的配置。  
    2. 





 


 


 


2.1 命令可选项






参数
描述
样例








-c <name>


 




删除的core或collection名称(必须)                                                     






[html] view plain copy

 










    

  1. <pre class="html" name="code">./bin/solr delete -c mycoll  
    2. 













-deleteConfig <true|false>




是否从ZooKeeper中删除配置，默认为true.


如果配置被其它collection共享，则即使true,也不会删除








[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr delete -deleteConfig false  
    2. 











-p <port>


 


命令发送到的本地运行Solr实例端口，默认脚本会根据运行实例检查端口






[html] view plain copy

 






    

  1. <pre class="html" name="code">./bin/solr delete -p 8983  
    2. 











 


 


 


 


 






        

        

            posted on 
2017-12-13 20:54 
cxhfuujust 
阅读(668) 
评论(0) 
编辑 
收藏 
举报

        

    










    
    

    
    

    

        

    

        

            
                
                
            
        

    

    

    

    





            

        

        

            

导航