Server : Ubuntu 16.04
Java Version : 1.8
Solr Version : 7.4.0

Solr 下載與安裝

首先，到 http://lucene.apache.org/solr/downloads.html 獲取 Solr 的下載地址，然後使用 wget 命令下載到伺服器上。

wget http://mirror.bit.edu.cn/apache/lucene/solr/7.4.0/solr-7.4.0.tgz

下載完成後解壓檔案。

tar -zxvf solr-7.4.0.tgz

檢視當前目錄，發現 Solr 已安裝到本地。

[email protected]:/usr/local/java# ls
activemq  hadoop  jdk1.8.0_161  kafka  solr-7.4.0  zookeeper
 

Solr 的啟動

為了啟動 Solr，我們需要到 Solr 安裝檔案下的 bin 目錄裡執行啟動指令碼，如下所示：

cd /usr/local/java/solr-7.4.0/bin/
./solr start -e cloud

該命令會在本地啟動 Solr 叢集。

不過，輸入該命令後，Solr 不會馬上啟動，還有幾個步驟需要完成。

1. 設定節點數

執行啟動命令後，Solr 首先會顯示提示語：

Welcome to the SolrCloud example!

This interactive session will help you launch a SolrCloud cluster on your local workstation.
To begin, how many Solr nodes would you like to run in your local cluster? (specify 1-4 nodes) [2]:
 

這邊要求我們設定啟動節點數，預設是 2。這裡我們直接按 ENTER 鍵選擇預設選項。

2.設定埠號

接著，Solr 提示我們設定埠號：

Ok, let's start up 2 Solr nodes for your example SolrCloud cluster.
Please enter the port for node1 [8983]:

如果 Solr 預設埠沒有被佔用且我們沒有特殊需求，直接按 ENTER 選擇預設埠即可。

此時，Solr 會為我們的兩個節點分別分配預設埠號 8983 和 7857，並在兩個節點上初始化例項。此外，Solr 還會啟動內建的 Zookeeper，並將以上兩個節點註冊到 Zookeeper 上。成功執行的資訊如下：

Starting up Solr on port 8983 using command:
"/usr/local/java/solr-7.4.0/bin/solr" start -cloud -p 8983 -s "/usr/local/java/solr-7.4.0/example/cloud/node1/solr"

Waiting up to 180 seconds to see Solr running on port 8983 [\]  
Started Solr server on port 8983 (pid=1898). Happy searching!
      
Starting up Solr on port 7574 using command:
"/usr/local/java/solr-7.4.0/bin/solr" start -cloud -p 7574 -s "/usr/local/java/solr-7.4.0/example/cloud/node2/solr" -z localhost:9983

Waiting up to 180 seconds to see Solr running on port 7574 [\]  
Started Solr server on port 7574 (pid=2105). Happy searching!

- 2018-08-10 17:05:06.693; org.apache.solr.client.solrj.impl.ZkClientClusterStateProvider; Cluster at localhost:9983 ready

3.建立集合

啟動成功後，Solr 會提示你建立集合，這裡我們輸入 testCollection 並按 ENTER 鍵確認。

Now let's create a new collection for indexing documents in your 2-node cluster.
Please provide a name for your new collection: [gettingstarted] 
testCollection

接著，Solr 會提示你設定分片數和副本數，這裡直接都按預設處理。

4.指定配置

建立集合後，Solr 會要求你指定配置檔案集。

Please choose a configuration for the testCollection collection, available options are:
_default or sample_techproducts_configs [_default]

關於這個配置檔案集，官網給的說明是這樣：

A collection must have a configSet, which at a minimum includes the two main configuration files for Solr: the schema file (named either managed-schema or schema.xml), and solrconfig.xml.

意思就是，每個集合必須指定一個 configSet，且這個 configSet 至少要包含兩個主要的配置檔案： schema 檔案和 solrconfig.xml 檔案。

這裡我們注意到，Solr 提示我們目前有兩個可用的配置檔案集選項，分別是 _default 和 sample_techproducts_configs。這兩者實際上是 Solr 預設好的配置檔案集，使用者可以直接使用。由於後續示例需要，這裡我們選擇 sample_techproducts_configs，按 ENTER 鍵確認。

至此，Solr 啟動成功，我們可以看到如下資訊輸出：

Created collection 'testCollection' with 2 shard(s), 2 replica(s) with config-set 'testCollection'

Enabling auto soft-commits with maxTime 3 secs using the Config API

POSTing request to Config API: http://localhost:8983/solr/testCollection/config
{"set-property":{"updateHandler.autoSoftCommit.maxTime":"3000"}}
Successfully set-property updateHandler.autoSoftCommit.maxTime to 3000


SolrCloud example running, please visit: http://localhost:8983/solr

現在，我們可以通過 http://localhost:8983/solr 訪問 Solr 的 Web 管理頁面了！

注：啟動過程中遇到 N 個問題，均記錄在文章底部。

Solr 的關閉與重啟

關閉 Solr 是一件比較簡單的事情，只需執行以下命令即可：

[email protected]:/usr/local/java/solr-7.4.0/bin# ./solr stop -all
Sending stop command to Solr running on port 8983 ... waiting up to 180 seconds to allow Jetty process 1898 to stop gracefully.
Sending stop command to Solr running on port 7574 ... waiting up to 180 seconds to allow Jetty process 2105 to stop gracefully.

如果想針對某埠進行關閉，只需加入埠引數與埠號：

solr stop -p 8983

但是，Solr 的重啟和我們的初次啟動略有不同。

首先，我們要啟動第一個節點：

[email protected]:/usr/local/java/solr-7.4.0/bin$ ./solr start -c -p 8983 -s ../example/cloud/node1/solr
Waiting up to 180 seconds to see Solr running on port 8983 [\]  
Started Solr server on port 8983 (pid=16514). Happy searching!

第一個節點啟動成功後，我們開始啟動第二個節點，並告訴它如何連線 Zookeeper：

panda:/usr/local/java/solr-7.4.0/bin$ ./solr start -c -p 7574 -s ../example/cloud/node2/solr -z localhost:9983
Waiting up to 180 seconds to see Solr running on port 7574 [\]  
Started Solr server on port 7574 (pid=16735). Happy searching!

現在，我們可以繼續使用 Solr 了！

遇到的問題

問題1：Max Processes Limit

筆者用的伺服器是阿里雲的超低配版本，預設的最大限制使用者程序數是 7857，因此在啟動 Solr 時就馬上看到警告：

*** [WARN] ***  Your Max Processes Limit is currently 7857. 
 It should be set to 65000 to avoid operational disruption. 
 If you no longer wish to see this warning, set SOLR_ULIMIT_CHECKS to false in your profile or solr.in.sh

原本想只是一個警告罷了，忽略就好，結果還是 GG 了。

ERROR: Failed to start Solr using command: "/usr/local/java/solr-7.4.0/bin/solr" start -cloud -p 8983 -s "/usr/local/java/solr-7.4.0/example/cloud/node1/solr" Exception : org.apache.commons.exec.ExecuteException: Process exited with an error: 1 (Exit value: 1)

既然這樣，那就只能正視問題了。

首先，檢視一下系統限制的最大使用者程序數：

[email protected]:/# ulimit -u
7857

確認是 7857 沒錯了。

那麼現在，我們需要解決的就是更改這個預設值。在筆者的環境中，max user processes 可以在 /etc/security/limits.conf 檔案中進行設定，格式為<domain> <type> <item> <value>，詳情如下：

root soft nproc 65535
root hard nproc 65535
* soft nproc 65535
* hard nproc 65535

儲存後重啟會話，發現該值已經變成 65535 了。

[email protected]:~# ulimit -u
65535

注：CentOS 的配置檔案似乎在 /etc/security/limits.d 資料夾下。

問題2：不能使用 root 使用者

解決了上一個問題後，筆者歡快地重新嘗試啟動 Solr：

WARNING: Starting Solr as the root user is a security risk and not considered best practice. Exiting.
         Please consult the Reference Guide. To override this check, start with argument '-force'

ERROR: Failed to start Solr using command: "/usr/local/java/solr-7.4.0/bin/solr" start -cloud -p 8983 -s "/usr/local/java/solr-7.4.0/example/cloud/node1/solr" Exception : org.apache.commons.exec.ExecuteException: Process exited with an error: 1 (Exit value: 1)

orz，結果告訴筆者不能用 root 使用者啟動 Solr。當然，可以使用 -force 引數強行跳過這個檢測，但既然官方說這樣做不好，那就乖乖聽話吧。（換使用者就換使用者，您開心就好。）

su panda

問題3：檔案讀寫許可權

筆者又滿心歡喜地重新嘗試啟動 Solr：

ERROR: Logs directory /usr/local/java/solr-7.4.0/example/cloud/node1/solr/../logs could not be created. Exiting

ERROR: Failed to start Solr using command: "/usr/local/java/solr-7.4.0/bin/solr" start -cloud -p 8983 -s "/usr/local/java/solr-7.4.0/example/cloud/node1/solr" Exception : org.apache.commons.exec.ExecuteException: Process exited with an error: 1 (Exit value: 1)

結果被告知沒有許可權建立日誌檔案。

好吧，才想起來自己現在不是 root 使用者，要先為 Solr 資料夾設定檔案讀寫許可權。

[email protected]:/usr/local/java# chmod -R 777 solr-7.4.0/

OK，至此所有問題都解決啦！