在CentOS下安裝Solr5.3

前言

Solr現在是一個獨立的服務器。

從Solr5.0開始，Solr不再發布為在任何Servlet容器中部署的“war”Web應用程序包（Web Application Archive）。Solr現在部署為一個獨立的java服務器應用程序，包含在Unix和Windows平臺上可以使用的啟動和停止腳本，以及將Solr作為服務安裝到類Unix平臺的/etc/init.d下的安裝腳本。

本質上，Solr仍然以Servlet APIs實現，并在Jetty上運行，但只是作為一個實現。部署為“webapp”到其他的Servlet容器（或其他Jetty實例）上不被支持，可能在未來的Solr 5.x版本不會工作。而可能會帶來Solr的其他改變，事實上是利用自定義網絡協議棧功能。

安裝JRE

1. 需要Java Runtime Environment(JRE) 1.7或更高版本，先驗證。

   # java -version

2. 安裝可參考《在CentOS下安裝JDK8》，包含JRE。
   

安裝Solr5.3

1. 去http://www.apache.org/dyn/closer.lua/lucene/solr/5.3.0下載Solr安裝文件solr-5.3.0.tgz。

2. 將solr-5.3.0.tgz文件放到/tmp目錄下，執行如下腳本：    
   

   # cd /tmp    
   # tar -zxvf solr-5.3.0.tgz // 解壓壓縮包

3. 創建應用程序和數據目錄

   # mkdir -p /data/solr /usr/local/solr

4. 創建運行solr的用戶并賦權

   # groupadd solr    
   # useradd -g solr solr    
   # chown -R solr.solr /data/solr /usr/local/solr

5. 安裝solr服務

   # solr-5.3.0/bin/install_solr_service.sh solr-5.3.0.tgz -d /data/solr -i /usr/local/solr

6. 檢查服務狀態  
   

   # service solr status

   將會看到如下輸出：  
   

   Solr process 29692 running on port 8983    
   {    
     "solr_home":"/data/solr/data/",    
     "version":"5.3.0 1696229 - noble - 2015-08-17 17:10:43",    
     "startTime":"2015-09-16T01:32:03.919Z",    
     "uptime":"0 days, 0 hours, 3 minutes, 6 seconds",    
     "memory":"89.8 MB (%18.3) of 490.7 MB"}

   
   

   
   

   
   

solr命令用法

1. 定位到solr應用程序目錄 
   

   # cd /usr/local/solr/solr

   
   

2. 查看solr命令選項

   # ./bin/solr

Usage: solr COMMAND OPTIONS          where COMMAND is one of: start, stop, restart, status, healthcheck, create, create_core, create_collection, delete
  Standalone server example (start Solr running in the background on port 8984):
    ./solr start -p 8984
  SolrCloud example (start Solr running in SolrCloud mode using localhost:2181 to connect to ZooKeeper, with 1g max heap size and remote Java debug options enabled):
    ./solr start -c -m 1g -z localhost:2181 -a "-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=1044"
Pass -help after any COMMAND to see command-specific usage information,     such as:    ./solr start -help or ./solr stop -help

# ./bin/solr start -help

Usage: solr start [-f] [-c] [-h hostname] [-p port] [-d directory] [-z zkHost] [-m memory] [-e example] [-s solr.solr.home] [-a "additional-options"] [-V]
  -f            Start Solr in foreground; default starts Solr in the background                     and sends stdout / stderr to solr-PORT-console.log
  -c or -cloud  Start Solr in SolrCloud mode; if -z not supplied, an embedded ZooKeeper                     instance is started on Solr port+1000, such as 9983 if Solr is bound to 8983
  -h <host>     Specify the hostname for this Solr instance
  -p <port>     Specify the port to start the Solr HTTP listener on; default is 8983                     The specified port (SOLR_PORT) will also be used to determine the stop port                      STOP_PORT=($SOLR_PORT-1000) and JMX RMI listen port RMI_PORT=(1$SOLR_PORT).                       For instance, if you set -p 8985, then the STOP_PORT=7985 and RMI_PORT=18985
  -d <dir>      Specify the Solr server directory; defaults to server
  -z <zkHost>   ZooKeeper connection string; only used when running in SolrCloud mode using -c                      To launch an embedded ZooKeeper instance, don't pass this parameter.
  -m <memory>   Sets the min (-Xms) and max (-Xmx) heap size for the JVM, such as: -m 4g                     results in: -Xms4g -Xmx4g; by default, this script sets the heap size to 512m
  -s <dir>      Sets the solr.solr.home system property; Solr will create core directories under                     this directory. This allows you to run multiple Solr instances on the same host                      while reusing the same server directory set using the -d parameter. If set, the                      specified directory should contain a solr.xml file, unless solr.xml exists in ZooKeeper.                      This parameter is ignored when running examples (-e), as the solr.solr.home depends                      on which example is run. The default value is server/solr.
  -e <example>  Name of the example to run; available examples:         cloud:         SolrCloud example          techproducts:  Comprehensive example illustrating many of Solr's core capabilities          dih:           Data Import Handler          schemaless:    Schema-less example
  -a            Additional parameters to pass to the JVM when starting Solr, such as to setup                     Java debug options. For example, to enable a Java debugger to attach to the Solr JVM                      you could pass: -a "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=18983"                      In most cases, you should wrap the additional parameters in double quotes.
  -noprompt     Don't prompt for input; accept all defaults when running examples that accept user input
  -V            Verbose messages from this script

# ./bin/solr create -help

Usage: solr create [-c name] [-d confdir] [-n configName] [-shards #] [-replicationFactor #] [-p port]
  Create a core or collection depending on whether Solr is running in standalone (core) or SolrCloud     mode (collection). In other words, this action detects which mode Solr is running in, and then takes      the appropriate action (either create_core or create_collection). For detailed usage instructions, do:
    bin/solr create_core -help
       or
    bin/solr create_collection –help

安裝solr服務腳本用法

1. 運行安裝腳本

   # /tmp/solr-5.3.0/bin/install_solr_service.sh

ERROR: Must specify the path to the Solr installation archive, such as solr-5.0.0.tgz
Usage: install_solr_service.sh path_to_solr_distribution_archive OPTIONS
  The first argument to the script must be a path to a Solr distribution archive, such as solr-5.0.0.tgz       (only .tgz or .zip are supported formats for the archive)
  Supported OPTIONS include:
    -d     Directory for live / writable Solr files, such as logs, pid files, and index data; defaults to /var/solr
    -i     Directory to extract the Solr installation archive; defaults to /opt/                The specified path must exist prior to using this script.
    -p     Port Solr should bind to; default is 8983
    -s     Service name; defaults to solr
    -u     User to own the Solr files and run the Solr process as; defaults to solr                This script will create the specified user account if it does not exist.
NOTE: Must be run as the root user

創建集合

在這個部分，我們創建一個簡單的Solr集合。

Solr可以有多個集合，但在這個示例，我們只使用一個。使用如下命令，創建一個新的集合。我們以solr用戶運行以避免任何權限錯誤。

# su - solr -c "/usr/local/solr/solr/bin/solr create -c gettingstarted -n data_driven_schema_configs"

在這個命令中，gettingstarted是集合的名字，-n指定配置集合。Solr默認提供了3個配置集合。這里我們使用的是schemaless，意思是可以提供任意名字的任意列，類型將會被猜測。

Setup new core instance directory:   /data/solr/data/gettingstarted
Creating new core 'gettingstarted' using command:   http://localhost:8983/solr/admin/cores?action=CREATE&name=gettingstarted&instanceDir=gettingstarted
{     "responseHeader":{        "status":0,        "QTime":3247},      "core":"gettingstarted"}

你現在已經創建了集合，并可以開始添加數據。默認的架構只需要提供一列：id。沒有其他默認列，只有動態列。

添加和查詢文檔

在這個部分，我們將瀏覽Solr Web界面，添加一些文檔到集合中。

問你使用Web瀏覽器訪問http://your_server_ip:8983/solr，Solr Web界面將會顯示為：

這個Web界面包含大量的有用信息，可以被用于調試在使用中產生的任何問題。

集合被劃分為核，這就是為什么在Web界面中有大量的對核的參照?，F在，gettingstarted只包含一個核，名為gettingstarted。在左手邊，可以看到“Core Selector”下拉菜單，我們可以選擇gettingstarted看到更多信息。

在選擇gettingstarted核之后，選擇“Documents”。文檔存儲可被Solr搜索的真實數據。因為我們使用了一個無模式的配置，我們可以使用任何列。我使用如下的JSON示例添加了一個單一文檔，通過拷貝以下到“Documents(s)”列：

{   
    "number": 1,    
    "president": "George Washington",    
    "birth_year": 1732,    
    "death_year": 1799,    
    "took_office": "1789-04-30",    
    "left_office": "1797-03-04",    
    "party": "No Party"    
}

點擊“Submit document”添加文檔到索引。過一會，你會看到如下信息：

添加文檔后的輸出：

Status: success   
Response:    
{    
  "responseHeader": {    
    "status": 0,    
    "QTime": 290    
  }    
}

你可以使用一個類似的或完全不同的結構添加更多文檔，但你也可以只使用一個文檔繼續。

現在，選擇左邊的“Query”去查詢我們剛剛添加的文檔。保持屏幕中的默認值，在點擊“Execute Query”之后，你最多看到10個文檔，依賴于你添加了多少：

查詢輸出

{   
  "responseHeader": {    
    "status": 0,    
    "QTime": 39,    
    "params": {    
      "q": "*:*",    
      "indent": "true",    
      "wt": "json",    
      "_": "1442371884598"    
    }    
  },    
  "response": {    
    "numFound": 1,    
    "start": 0,    
    "docs": [    
      {    
        "number": [    
          1    
        ],    
        "president": [    
          "George Washington"    
        ],    
        "birth_year": [    
          1732    
        ],    
        "death_year": [    
          1799    
        ],    
        "took_office": [    
          "1789-04-30T00:00:00Z"    
        ],    
        "left_office": [    
          "1797-03-04T00:00:00Z"    
        ],    
        "party": [    
          "No Party"    
        ],    
        "id": "b9b294c1-4b68-4d96-adc2-f6fb77f60932",    
        "_version_": 1512437472611532800    
      }    
    ]    
  }    
}

參考：http://lucene.apache.org/solr/quickstart.html