本頁(yè)介紹如何升級(jí)使用服務(wù)安裝腳本安裝的現(xiàn)有 Solr 集群。

Tip：該頁(yè)面上列出的步驟假定您使用默認(rèn)的服務(wù)名稱 solr。如果您使用備用服務(wù)名稱或 Solr 安裝目錄，則下面提到的一些路徑和命令將必須相應(yīng)地進(jìn)行修改。

規(guī)劃升級(jí)

以下是在開(kāi)始升級(jí)過(guò)程之前需要準(zhǔn)備的事項(xiàng)清單：

1. 檢查 Solr 版本升級(jí)說(shuō)明以確定 Solr 新版本中是否有任何行為改變會(huì)影響您的安裝。
2. 如果不使用復(fù)制（即 replicationFactor 小于1的集合），則應(yīng)對(duì)每個(gè)集合進(jìn)行備份。如果您的所有集合都使用復(fù)制，則在技術(shù)上不需要進(jìn)行備份，因?yàn)槟鷮⒅饌€(gè)升級(jí)和驗(yàn)證每個(gè)節(jié)點(diǎn)。
3. 確定哪個(gè) Solr 節(jié)點(diǎn)當(dāng)前在 SolrCloud 中托管 Overseer leader 進(jìn)程，因?yàn)槟鷳?yīng)該最后升級(jí)該節(jié)點(diǎn)。要確定監(jiān)督，使用監(jiān)督狀態(tài) API，請(qǐng)參閱：集合 API。
4. 如果可能，計(jì)劃在系統(tǒng)維護(hù)時(shí)段內(nèi)執(zhí)行升級(jí)。您將會(huì)對(duì)集群（每個(gè)節(jié)點(diǎn)，一個(gè)接一個(gè)）執(zhí)行滾動(dòng)重新啟動(dòng)，但是我們?nèi)匀唤ㄗh在系統(tǒng)使用率最小的時(shí)候進(jìn)行升級(jí)。
5. 驗(yàn)證集群當(dāng)前是否正常并且所有副本都處于活動(dòng)狀態(tài)，因?yàn)槟粦?yīng)該在降級(jí)的群集上執(zhí)行升級(jí)。
6. 根據(jù)新的 Solr JAR 文件重新生成并測(cè)試所有自定義的服務(wù)器端組件。
7. 確定 Solr 控制腳本使用的以下變量的值：
   • ZK_HOST：您當(dāng)前的 SolrCloud 節(jié)點(diǎn)用于連接到 ZooKeeper 的 ZooKeeper 連接字符串；該值對(duì)于集群中的所有節(jié)點(diǎn)將是相同的。
   • SOLR_HOST：每個(gè) Solr 節(jié)點(diǎn)在加入 SolrCloud 集群時(shí)用于注冊(cè) ZooKeeper 的主機(jī)名；此值將用于在啟動(dòng)新的 Solr 進(jìn)程時(shí)設(shè)置主機(jī) Java系統(tǒng)屬性。
   • SOLR_PORT：每個(gè) Solr 節(jié)點(diǎn)正在監(jiān)聽(tīng)的端口，如 8983。
   • SOLR_HOME：每個(gè) Solr 節(jié)點(diǎn)的 Solr 主目錄的絕對(duì)路徑；這個(gè)目錄必須包含一個(gè) solr.xml 文件。該值將使用 solr.solr.home 系統(tǒng)屬性傳遞給新的 Solr 進(jìn)程。如果您是從 Solr 5.x 或更高版本的安裝中進(jìn)行升級(jí)，則這些值通?？梢栽谌魏?/var/solr/solr.in.sh 或 /etc/default/solr.in.sh 中發(fā)現(xiàn)。

您現(xiàn)在應(yīng)該準(zhǔn)備升級(jí)您的集群。在進(jìn)行生產(chǎn)之前，請(qǐng)?jiān)跍y(cè)試或暫存集群中驗(yàn)證此過(guò)程。

升級(jí)過(guò)程

我們建議的方法是逐個(gè)升級(jí)每個(gè) Solr 節(jié)點(diǎn)。換句話說(shuō)，您需要停止節(jié)點(diǎn)，將其升級(jí)到新版本的 Solr，并在移動(dòng)到下一個(gè)節(jié)點(diǎn)之前重新啟動(dòng)它。這意味著在很短的時(shí)間內(nèi)，將在您的集群中運(yùn)行“舊 Solr”和“新 Solr”節(jié)點(diǎn)。我們還假設(shè)您將把新的 Solr 節(jié)點(diǎn)指向您現(xiàn)有的 Solr 主目錄，在這個(gè)目錄下為節(jié)點(diǎn)上的每個(gè)集合管理 Lucene 索引文件。這意味著你將不需要移動(dòng)任何索引文件來(lái)執(zhí)行升級(jí)。

步驟1：停止 Solr

從停止要升級(jí)的 Solr 節(jié)點(diǎn)開(kāi)始。在停止節(jié)點(diǎn)之后，如果使用復(fù)制（即，具有 replicationFactor 小于1的集合），則驗(yàn)證在關(guān)閉節(jié)點(diǎn)上托管的所有領(lǐng)導(dǎo)者是否已經(jīng)成功遷移到其他副本；您可以通過(guò)訪問(wèn) Solr 管理界面中的云面板來(lái)完成此操作。如果不使用復(fù)制，那么在關(guān)閉的節(jié)點(diǎn)上承載的碎片的任何集合將暫時(shí)脫機(jī)。

步驟2：將 Solr 作為服務(wù)安裝

請(qǐng)按照說(shuō)明將 Solr 作為服務(wù)安裝在 Linux 上，記錄在 Taking Solr to Production。使用該 -n 參數(shù)可避免安裝程序腳本自動(dòng)啟動(dòng) Solr。您需要更新 /etc/default/solr.in.sh，它包含在下一步中完成升級(jí)過(guò)程的文件。

Tip：如果您有一個(gè)/var/solr/solr.in.sh用于現(xiàn)有 Solr 安裝的文件，則運(yùn)行該install_solr_service.sh腳本會(huì)將該文件移動(dòng)到新的位置：/etc/default/solr.in.sh。                     

步驟3：設(shè)置環(huán)境變量覆蓋

用文本編輯器打開(kāi) /etc/default/solr.in.sh，并驗(yàn)證以下變量設(shè)置是否正確，或根據(jù)需要將它們添加到包含文件的底部：

ZK_HOST=SOLR_HOST=SOLR_PORT=SOLR_HOME=

確保您計(jì)劃擁有 Solr 進(jìn)程的用戶是該 SOLR_HOME 目錄的所有者。舉例來(lái)說(shuō)，如果您計(jì)劃將 Solr 作為 “Solr” 用戶并且 SOLR_HOME 作為 /var/solr/data，那么您需要：

sudo chown -R solr: /var/solr/data

步驟4：?jiǎn)?dòng) Solr

您現(xiàn)在準(zhǔn)備通過(guò)執(zhí)行以下操作來(lái)啟動(dòng)升級(jí)后的 Solr 節(jié)點(diǎn)：sudo service solr start。升級(jí)后的實(shí)例將加入現(xiàn)有集群，因?yàn)槟闶褂玫?SOLR_HOME、SOLR_PORT 以及SOLR_HOST 是由舊的 Solr 節(jié)點(diǎn)使用的設(shè)置；因此，新的服務(wù)器將看起來(lái)像舊節(jié)點(diǎn)到正在運(yùn)行的集群。確保查看 /var/solr/logs/solr.log 在啟動(dòng)過(guò)程中記錄的錯(cuò)誤。

步驟5：運(yùn)行 Healthcheck

在繼續(xù)升級(jí)群集中的下一個(gè)節(jié)點(diǎn)之前，應(yīng)該對(duì)已升級(jí)的節(jié)點(diǎn)上承載的所有集合運(yùn)行 Solr healthcheck 命令。例如，如果新升級(jí)的節(jié)點(diǎn)承載 MyDocuments 集合的副本，則可以運(yùn)行以下命令（將 ZK_HOST 替換為 ZooKeeper 連接字符串）：

/opt/solr/bin/solr healthcheck -c MyDocuments -z ZK_HOST

查找有關(guān)該集合的任何副本的任何報(bào)告問(wèn)題。

最后，對(duì)集群中的所有節(jié)點(diǎn)重復(fù)步驟1-5。