zoukankan      html  css  js  c++  java

  • 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. 

    

    
    		

    
    

    



     
    

     
    

     
    

    
    
                
    
                
              
    • 
              
    
              
  • 

                相关阅读:
    
                
                  python基础#1
                    
    shell脚本基础练习题
                    
    shell计算100以内加法
                    
    shell脚本添加用户
                    
    python学习ing
                    
    框架
                    
    前端
                    
    python基础之数据类型-面向对象
                    
    python四种列表的插入方法及其效率
                    
    Charles高阶操作
                    
                        
              
    • 
              
    
              
  • 
                原文地址：https://www.cnblogs.com/cxhfuujust/p/8034853.html
              
    • 

            

          



          
          

            

            

          

        

      

      



      

      

        

          Copyright © 2011-2022 走看看