WebSphere Commerce Search Web 服務器自動化部署配置概述功能概述
在 Version 7 Feature Pack 5 之前，用戶在啟動 foundation 功能部件之後需要手動地執行一些配置步驟以完成對 WebSphere Commerce Search Web 服務器的部署和配置工作。以 IBM HTTP Server（IHS） Web 服務器為例，用戶需要手動完成以下對 Search Web 服務器的部署配置工作：創建 Search Web 服務器的 httpd.conf 文件，添加一個監聽 Search 應用程序的虛擬主機端口，並且正確配置 Search Web 服務器 插件。
為了減少用戶花費在手動部署配置工作上的精力 , WebSphere Commerce 從 Version 7 Feature Pack 5 開始向用戶提供了一種對 Search Web 服務器進行自動化部署及配置的功能，使得用戶可以通過在啟動 foundation 功能部件時傳遞額外的參數來完成對 Search Web 服務器的自動部署及配置。需要注意的是，該自動化功能目前只適用於 IHS 服務器，如果用戶使用的是諸如 IIS，SunOne 等非 IHS Web 服務器 ，則不能使用該功能。
使用方法概述
與 WebSphere Commerce V7 信息中心保持一致 , 本文依然使用 [search_server_config] 來代表該新功能提供的 Search Web 服務器自動化配置參數集合。該集合共包含了 13 個可選參數：
清單 1. [search_server_config] 參數集合
autoConfigSearchWebserver isShareWCWebserverProduct searchWebserverHostname searchWebserverOS searchWebserverInstallLocation searchPluginInstallLocation searchRemoteConfigPath searchIsConfigViaFTP searchFtpServerPort searchFtpUserId searchFtpUserPwd searchIsConfigViaNFS searchMappedConfigPath
使用該自動化部署配置功能只需要在運行 foundation 功能部件的啟用命令時額外加入正確的 [search_server_config] 參數即可。本文的主旨即在於幫助用戶針對不同的場景快速准確地構建出相應的 [search_server_config] 參數。
流程圖輔助工具工具的意義
每個用戶的 Commerce 環境都有自己獨特的拓撲結構和配置方式。比如，有的用戶環境中使用本地 Web 服務器，而有的用戶環境中使用遠程 Web 服務器；有的用戶環境中 Commerce 服務器與 Search 服務器共享一個 Web 服務器， 而有的用戶環境中 Commerce 服務器與 Search 服務器都配置了獨立的 Web 服務器；有的用戶環境中選擇使用 FTP 來完成服務器之間的文件傳輸，而另一些用戶環境中選擇使用 NFS 的方式，等等。在這些不同的場景中使用 WebSphere Commerce Search Web 服務器自動化部署及配置功能，需要傳遞不同的 [search_server_config] 參數。對於某個特定的場景，哪些 [search_server_config] 參數是必須的？這些參數又應該如何賦值呢？這些問題都是用戶在使用該功能時的難點所在。
為了更好地幫助用戶理解和使用該自動化功能，本文提出了一個簡單易用的流程圖輔助工具——“[search_server_config] 參數構建流程圖”，如圖 1 所示。該流程圖可以幫助用戶快速地選擇 [search_server_config] 參數並且正確賦值，從而幫助用戶實現對 WebSphere Commerce Search Web 服務器的自動化部署及配置。
[search_server_config] 參數構建流程圖圖 1. [search_server_config] 參數構建流程圖
圖 1 中主要的符號意義如下：
唯一標有“開始”字樣的綠色六邊形代表“開始步驟”，它是整個流程圖的入口。
每一個黃色菱形代表一個“決策步驟”，其中標注了到達該步驟時需要回答的問題。每一個決策步驟都有唯一的數字標識，不同的決策答案將會決定不同的路徑走向。
每一個底邊為曲線的藍色框形代表一個“參數記錄步驟”，其中標明了到達該步驟需要記錄下的參數名稱。每一個參數記錄步驟都有唯一的數字標識。
標有箭頭的藍線代表流程“導向線”，這些導向線指明了在該流程圖中行進的方向。
橙色的橢圓形代表了“停止步驟”。一旦行至“停止步驟”，則應退出該流程圖。
如何通過圖 1 所示的流程圖工具獲得相應場景下需要的 [search_server_config] 參數及參數值呢？方法如圖 2 所示。
圖 2.[search_server_config] 參數構建流程圖工作原理圖
從“開始步驟”出發，沿著“導向線”行進到達一個步驟。如果到達的是“決策步驟”，則按照“決策步驟問題分析及參數賦值方法”中的說明根據實際場景回答該決策步驟中提出的問題從而獲得下一步的行進方向。如果到達的是“參數記錄步驟”，則記錄下該步驟中顯示的各個參數，並按照“決策步驟問題分析及參數賦值方法”中闡述的原理為這些參數賦值。以此類推，繼續沿著相應的導向線行進並且在每一步中正確執行相應操作，直到到達“停止步驟”後結束。結束後將在每一個“參數記錄步驟”中記錄並賦值的參數組合在一起，得到的即是適用於該場景的 [search_server_config] 參數。
決策步驟問題分析及參數賦值方法
這一節將會對圖 1 所示的各個參數記錄步驟和決策步驟做詳細闡述，從而說明如何在這些步驟中做出正確的決策以及如何正確地為相應參數賦值。
決策步驟 (1): 您打算在啟動功能部件的同時自動化部署及配置 Commerce Search Web 服務器嗎？
如果您打算使用 WebSphere Commerce Search Web 服務器自動化部署配置新功能，那麼回答“是”，否則回答“否”。
回答 “是”則到達參數記錄步驟 (1) 將參數“autoConfigSearchWebserver”的值設置為“true”。下一步到達決策步驟 (2) 。
回答 “否”則到達參數記錄步驟 (6) 將參數“autoConfigSearchWebserver”的值設置為“false”，或者不使用該參數，因為該參數的缺省值是”false”。
下一步到達停止步驟，退出該流程圖。
決策步驟 (2): 您打算讓 Search Web 服務器與 Commerce Web 服務器共享同一個 IHS 產品嗎 ?
如果您打算讓 Search Web 服務器與 Commerce Web 服務器共享同一個 IHS 產品，那麼回答“是”，則您不必為 Search Web 服務器另外安裝 IHS。如果您打算讓 Search Web 服務器使用單獨的 IHS 產品，那麼回答“否”，則您需要為 Search Web 服務器另外安裝一份 IHS 產品。
回答 “是”則到達參數記錄步驟 (2) 將參數“isShareWCWebserverProduct” 的值設置為“true”。一旦選擇與 Commerce Web 服務器共享 IHS，對於表 1 中列於 “isShareWCWebserverProduct”之後的所有參數，foundation 特性啟用腳本會自動地從 Commerce 實例配置屬性文件“<WC_installLocation>/instances/<instance_name>/properties/createInstance.properties”中獲得它們的參數值，因此不需要顯式地使用這些參數。需要注意的是，用於傳遞 FTP 用戶密碼的參數”searchFtpUserPwd”是一個例外，詳情請參見關於參數記錄步驟 (3) 的說明。下一步到達決策步驟 (3) 。
回答 “否”則到達參數記錄步驟 (7) 將參數“isShareWCWebserverProduct”的值設置為“false” ，或者不使用該參數，因為該參數的缺省值是“false”。
提供關於 Search Web 服務器單獨使用的 IHS 的如下信息：
將 IHS 所在的主機名賦值給“searchWebserverHostname”參數；
將 IHS 的安裝路徑賦值給“searchWebserverInstallLocation”參數；
將 IHS 插件的安裝路徑賦值給“searchPluginInstallLocation”參數。
下一步到達決策步驟 (6) 。
決策步驟 (3): 您的 Search Web 服務器是遠程服務器嗎 ?
如果共享使用的 IHS 沒有安裝在打算用於部署 Search 應用服務器的機器上，那麼回答“是”。否則回答“否”。
回答 “是”則到達決策步驟 (4)
回答 “否”則到達停止步驟，退出該流程圖。
決策步驟 (4): 您打算自動傳輸 Search Web 服務器部署配置所需的文件嗎 ?
如果您打算讓該功能幫助您自動地將所有配置文件拷貝到遠程 IHS 機器上，那麼回答“是”；如果您打算手動地完成文件拷貝工作，那麼回答“否”。
回答 “是”則到達決策步驟 (5)
回答 “否”則到達參數記錄步驟 (5)
將“searchIsConfigViaFTP”和“searchIsConfigViaNFS”參數的值設置為“false”, 或者不使用這兩個參數，因為它們的缺省值是“false”。
下一步到達停止步驟，退出該流程圖。
決策步驟 (5): 您打算使用 FTP 還是 NFS 來完成文件自動傳輸？
這裡的文件傳輸方式應該與創建 Commerce 實例時使用的文件傳輸方式保持一致，您可以在 Commerce 實例配置屬性文件“<WC_installLocation>/instance/<instance_name>/properties/createInstance.properties”中查到相關信息。
回答 “使用 FTP”則到達參數記錄步驟 (3) 對於共享的 IHS，腳本會自動從“createInstance.properties”屬性文件中獲取“searchIsConfigViaFTP”, “searchFtpServerPort”, “searchFtpUserId”, “searchRemoteConfigPath”參數的值，因此您不需要顯式地使用這些參數。其中，“searchRemoteConfigPath”參數代表著您打算在遠程 IHS 機器上存放 Search Web 服務器配置文件的路徑；同時，這個值還會被用於定義 Search Web 服務器的 httpd.conf 文件中的屬性值，比如 document root 以及 log file location 等。默認地，腳本會使用“createInstance.properties”屬性文件中的“RemoteConfigPath”屬性值用做“searchRemoteConfigPath”的參數值。當然，您可以通過顯式地在命令行中使用“searchRemoteConfigPath”參數來重寫該參數值，由於命令行中的參數值與 Commerce 實例屬性文件中的值相比具有更高的優先級，因此您在命令行中指定的參數值會最終生效。需要注意的是，賦給“searchRemoteConfigPath”參數的路徑必須是一個存在的路徑並且具有正確的 FTP 讀寫權限，如果您指定的是一個新路徑，請務必保證在運行功能啟用腳本之前在遠程機器上創建該路徑並賦予正確的 FTP 權限。為了避免出錯，我們推薦您不要在命令行中顯式使用該參數，而是讓腳本直接從“createInstance.properties”文件中讀取“RemoteConfigPath”默認值。這樣的方法是安全的，因為“RemoteConfigPath”路徑在您創建 Commerce 實例的過程中已經被驗證過，必定是一個合法值。另外，出於安全策略考慮，FTP 密碼信息不會在創建 Commerce 時被存儲在屬性文件中。因此，您必須要將 FTP 用戶密碼賦值給“searchFtpUserPwd”參數。下一步到達停止步驟，退出該流程圖。
回答 “使用 NFS”則到達參數記錄步驟 (4) 腳本會默認使用“createInstance.properties”屬性文件中的“mappedConfigPath”屬性值用做“searchMappedConfigPath”的參數值。因此您只需要檢查並確定屬性文件中“mappedConfigPath”指定的路徑，也即是您在創建 Commerce 實例時掛載的 NFS 路徑仍然可以正常工作即可。
下一步到達停止步驟，退出該流程圖。
決策步驟 (6): 您的 Search Web 服務器是遠程服務器嗎 ?
如果 Search Web 服務器單獨使用的 IHS 沒有安裝在打算用於部署 Search 應用服務器的機器上，那麼回答“是”。否則回答“否”。
回答 “是”則到達參數記錄步驟 (8) 必須提供“searchRemoteConfigPath”參數值，從而自動腳本可以利用該值來構建 Search Web 服務器的 httpd.conf 文件，同時將 Search Web 服務器的配置文件傳輸保存在該指定路徑下。關於“searchRemoteConfigPath”參數的注意事項請參見上文關於參數記錄步驟 (3) 的描述。下一步到達決策步驟 (7) 。
回答 “否”則到達停止步驟，退出該流程圖
決策步驟 (7): 您的 Search Web 服務器主機和 Commerce Web 服務器主機使用的是相同的操作系統嗎 ?
回答 “是”則到達決策步驟 (8) 腳本會自動從“config.properties”文件中讀取 Commerce Web 服務器主機操作系統的值 (“webserverOS”屬性值 ) 作為“searchWebserverOS”的參數值。
回答 “否”則到達參數記錄步驟 (9) 需要將 Search Web 服務器主機的操作系統類型賦值給“searchWebserverOS”參數。可接受的值有 : aix, linux, os400, solaris, windows，需要注意的是這些值都是大小寫敏感的。
下一步到達決策步驟 (8) 。
決策步驟 (8): 您打算自動傳輸 Search Web 服務器部署配置所需的文件嗎 ?
該問題的決策方式與決策步驟 (4) 一致。
回答 “是”則到達決策步驟 (9)
回答 “否”則到達參數記錄步驟 (5)
參數記錄步驟 (5) 的相應操作已在決策步驟 (4) 的“否”分支操作中闡述過。
決策步驟 (9): 您打算使用 FTP 還是 NFS 來完成文件自動傳輸？
您可以自由選擇文件傳輸方式，而後進行相應的操作。
回答 “使用 FTP”則到達參數記錄步驟 (10) 首先需要在 Search 應用服務器主機和遠程 Search Web 服務器主機之間部署配置 FTP 服務，保證遠程主機上存在“searchRemoteConfigPath”路徑並賦予其正確的 FTP 權限，而後向腳本提供如下的 FTP 信息：將“searchIsConfigViaFTP”參數的值設置為“true”；將 FTP 端口號賦值給“searchFtpServerPort”參數；將 FTP 用戶名賦值給“searchFtpUserId”參數；將 FTP 用戶密碼賦值給“searchFtpUserPwd”參數。下一步到達停止步驟，退出該流程圖。
回答 “使用 NFS”則到達參數記錄步驟 (11) 首先需要在 Search 應用服務器主機和遠程 Search Web 服務器主機之間部署配置 NFS 服務，在遠程 Search Web 服務器上選取一個路徑 A 作為您存放 Search Web 服務器配置文件的路徑，通過 NFS 將遠程路徑 A 掛載到本機的某個路徑 B 上，而後向腳本提供如下的 NFS 信息：
將“searchIsConfigViaNFS”參數的值設置為“true”；
將路徑 B 賦值給“searchMappedConfigPath”參數。
下一步到達停止步驟，退出該流程圖。
場景實例
本節將會展示適用於不同場景的 WebSphere Commerce Search Web 服務器自動化部署配置命令實例。這些命令都是通過使用本文中提出的流程圖分析得到的，針對每一個場景，本文會從以下三方面進行闡述 :
路徑——使用 [search_server_config] 流程圖對該場景進行分析得到的完整流程路徑。
參數集——在完整流程路徑行進中記錄下來的 [search_server_config] 參數及參數值。讀者可以簡單地將 [search_server_config] 參數集值附加到 foundation 特性啟用命令後，便可獲得適用於相應場景的完整自動化部署命令。
結果—— WebSphere Commerce Search Web 服務器自動化部署配置的結果。
Search 與 Commerce 共享 IHS 產品
共有路徑：開始步驟 - 決策步驟 (1)- 參數記錄步驟 (1) - 決策步驟 (2) - 參數記錄步驟 (2)
共享本地的 IHS
路徑：
參數記錄步驟 (2) - 決策步驟 (3)- 停止步驟
參數集
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=true
：
結果：
<WC_installLocation>/instances/<instance_name>/search/solr/home/httpconf/httpd.conf 和 <Plugins_installLocation>/config/solrWebserver/plugin-cfg.xml 文件將會在運行命令的本機上自動生成。
共享遠程的 IHS
不使用自動化傳輸配置文件功能
路徑：
參數記錄步驟 (2) - 決策步驟 (3)- 決策步驟 (4) - 參數記錄步驟 (5) - 停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=true
-DSearchIsConfigViaFTP=false
-DSearchIsConfigViaNFS=false
“searchIsConfigViaFTP”和“searchIsConfigViaNFS”參數的默認值是 false, 因此在此場景下也可以省略這兩個參數。
結果：
<WC_installLocation>/components/foundation/subcomponents/search/deploy/ihsconf/demo_solr/httpd.conf 和 <WAS_installLocation>/profiles/<instance_name>_solr/config/cells/<instance_name>_search_cell/nodes/<remoteWebServerHostname>-node/servers/solrWebserver/plugin-cfg.xml 文件將會在運行命令的本機上自動生成。
使用 FTP 自動化傳輸文件
路徑：
參數記錄步驟 (2) - 決策步驟 (3) - 決策步驟 (4) - 決策步驟 (5) - 參數記錄步驟 (3) - 停止步驟
參數集：
參數集 (1)：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=true
-DsearchFtpUserPwd=<FTP 用戶密碼 >
參數集 (2)：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=true
-DsearchFtpUserPwd=<FTP 用戶密碼 >
-DsearchRemoteConfigPath=<Search IHS 配置文件將被存放的路徑 >
本文推薦您使用參數集 (1)；您也可以選擇參數集 (2) 來指定 searchRemoteConfigPath參數值，注意事項請參見“決策步驟問題分析及參數賦值方法”部分關於“參數“記錄步驟 (3)”的詳述。
結果 :
Search Web 服務器的 httpd.conf 和 plugin-cfg.xml 文件會被自動地生成並且通過 FTP 傳輸到遠程 IHS 機器上的 <remoteConfigPath>/demo_solr/httpconf 路徑下。
如果您使用的是參數集 (1)，那麼 <remoteConfigPath> 的值是就是 “createInstance.properties” 文件裡“remoteConfigPath”屬性的值。如果您使用的是參數集 (2)，那麼 <remoteConfigPath> 的值是就是您在命令行中顯式賦予“searchRemoteConfigPath”參數的值。
使用 NFS 自動化傳輸文件
路徑：
參數記錄步驟 (2) - 決策步驟 (3) - 決策步驟 (4) - 決策步驟 (5) - 參數記錄步驟 (4) - 停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=true
結果 :
在 NFS 路徑“mappedConfigPath”可以正常工作的前提下，Search Web 服務器的“httpd.conf ”和“plugin-cfg.xml ”文件會被自動地生成並且通過 NFS 傳輸到遠程 IHS 機器的 < mappedConfigPath >/demo_solr/httpconf 路徑下。
<mappedConfigPath> 的值即是“createInstance.properties” 文件裡“mappedConfigPath”屬性的值。
Search 使用獨立的 IHS 產品
共有路徑：開始步驟 - 決策步驟 (1) - 參數記錄步驟 (1) - 決策步驟 (2) - 參數記錄步驟 (7)
使用本地獨立的 IHS
路徑：
參數記錄步驟 (7)-決策步驟 (6)-停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=false
-DsearchWebserverHostname=<Search 使用的 IHS 所在的主機名 >
-DsearchWebserverInstallLocation=<Search 使用的 IHS 的安裝路徑 >
-DsearchPluginInstallLocation=<Search 使用的 IHS 插件的安裝路徑 >
結果 :
<WC_installLocation>/instances/<instance_name>/search/solr/home/httpconf/httpd.conf 和 <Plugins_installLocation>/config/solrWebserver/plugin-cfg.xml 文件將會在運行命令的本機上自動生成。
使用遠程的獨立的 IHS
不使用自動化傳輸配置文件功能>
路徑：
參數記錄步驟 (7)- 決策步驟 (6)- 參數記錄步驟 (8)- 決策步驟 (7)- 參數記錄步驟 (9) - 決策步驟 (8)- 參數記錄步驟 (5)- 停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=false
-DsearchWebserverHostname=<Search 使用的 IHS 所在的主機名 >
-DsearchWebserverInstallLocation=<Search 使用的 IHS 的安裝路徑 >
-DsearchPluginInstallLocation=<Search 使用的 IHS 插件的安裝路徑 >
-DsearchRemoteConfigPath=<Search IHS 配置文件將被存放的路徑 >
-DsearchWebServerOS=<Search 使用的 IHS 所在主機的操作系統類型 >
-DSearchIsConfigViaFTP=false
-DSearchIsConfigViaNFS=false
“searchIsConfigViaFTP”和“searchIsConfigViaNFS”參數的默認值是 false, 因此在此場景下也可以省略這兩個參數。
如果 Search 的 IHS 主機和 Commerce 的 IHS 主機使用的操作類型一致，則不會途經參數記錄步驟 (9)，即不必使用“searchWebserverOS”參數。
結果 :
<WC_installLocation>/components/foundation/subcomponents/search/deploy/ihsconf/demo_solr/httpd.conf 和 <WAS_installLocation>/profiles/<instance_name>_solr/config/cells/<instance_name>_search_cell/nodes/<remoteWebServerHostname>-node/servers/solrWebserver/plugin-cfg.xml 文件將會在運行命令的本機上自動生成。
使用 FTP 自動化傳輸文件
路徑：
參數記錄步驟 (7)- 決策步驟 (6)- 參數記錄步驟 (8)- 決策步驟 (7)- 參數記錄步驟 (9) - 決策步驟 (8)- 決策步驟 (9)- 參數記錄步驟 (10)- 停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=false
-DsearchWebserverHostname=<Search 使用的 IHS 所在的主機名 >
-DsearchWebserverInstallLocation=<Search 使用的 IHS 的安裝路徑 >
-DsearchPluginInstallLocation=<Search 使用的 IHS 插件的安裝路徑 >
-DsearchRemoteConfigPath=<Search IHS 配置文件將被存放的路徑 >
-DsearchWebServerOS=<Search 使用的 IHS 所在主機的操作系統類型 >
-DSearchIsConfigViaFTP=true
-DsearchFtpServerPort=<FTP 服務器端口 >
-DsearchFtpUserId=<FTP 用戶名 >
-DsearchFtpUserPwd=<FTP 用戶密碼 >
結果 :
在保證 searchRemoteConfigPath路徑存在且具有正確的 FTP 權限的前提下，Search Web 服務器的 httpd.conf 和 plugin-cfg.xml 文件會被自動地生成並且通過 FTP 傳輸到遠程 IHS 機器上的 <searchRemoteConfigPath>/demo_solr/httpconf 路徑下。
使用 NFS 自動化傳輸文件
路徑：
參數記錄步驟 (7)- 決策步驟 (6)- 參數記錄步驟 (8)- 決策步驟 (7)- 參數記錄步驟 (9)- 決策步驟 (8)- 決策步驟 (9)- 參數記錄步驟 (11)- 停止步驟
參數集：
-DautoConfigSearchWebserver=true
-DisShareWCWebserverProduct=false
-DsearchWebserverHostname=<Search 使用的 IHS 所在的主機名 >
-DsearchWebserverInstallLocation=<Search 使用的 IHS 的安裝路徑 >
-DsearchPluginInstallLocation=<Search 使用的 IHS 插件的安裝路徑 >
-DsearchRemoteConfigPath=<Search IHS 配置文件將被存放的路徑 >
-DsearchWebServerOS=<Search 使用的 IHS 所在主機的操作系統類型 >
-DSearchIsConfigViaNFS=true
-DsearchMappedConfigPath=<Search IHS 配置文件遠程存放路徑在本機上的映射路徑 >
結果 :
在保證 searchMappedConfigPath映射路徑可以正常工作的前提下，Search Web 服務器的 httpd.conf 和 plugin-cfg.xml 文件會被自動地生成並且通過 NFS 傳輸到遠程 IHS 機器上的 <searchMappedConfigPath>/demo_solr/httpconf 路徑下。
總結
本文提出了一個簡單易用的參數選擇流程圖，以更加清晰易懂的方式向用戶展示了 WebSphere Commerce Search Web 服務器自動化部署配置新功能的使用方法，可以幫助用戶快速地選擇 [search_server_config] 參數並且正確賦值。同時，本文還展示了詳盡的場景使用實例，為用戶針對不同應用場景的 WebSphere Commerce Search Web 服務器自動化部署工作提供了參考價值。
