您可以向 Liberty 群體控制器登錄主機、更新主機資訊或取消登錄主機。
登錄會使群體控制器能夠存取主機上的應用程式、指令檔及其他資源。
已登錄的主機是群體的成員。
關於這項作業
主機不需要安裝任何 WebSphere Application Server 產品。除了作業系統,主機沒有其他軟體需求。
主機可以是安裝產品的電腦,或是另一部電腦。
如果要向群體控制器登錄主機、更新主機資訊或取消登錄主機,請使用
registerHost、
updateHost 和
unregisterHost 指令。
請以下列格式之一,指定主機名稱:
- 完整的網域名稱伺服器 (DNS) 主機名稱字串,例如 xmachine.ibm.com
- 預設簡短 DNS 主機名稱字串,例如 xmachine
- 數值 IP 位址,例如 127.1.255.3
註: 當 Liberty 伺服器加入群體時,如果相關聯的主機尚未登錄,則會自動向群體控制器登錄。
主機可以用不同的名稱登錄到群體中。
請確定 registerHost、updateHost 和 unregisterHost 所指定的主機名稱,與登錄的群體成員所用的主機名稱一致。
已登錄的伺服器成員,其 server.xml 檔中的 defaultHostName 變數用來控制伺服器認為自己所屬的主機名稱。
- 向群體控制器登錄主機。
如果要登錄現行主機(群體控制器主機和遠端目標主機都是同一部電腦),請在群體公用程式 Script 上,執行不含明確主機目標的
registerHost 指令。請指定群體控制器的主機名稱、埠及管理使用者名稱和密碼。例如:
wlp/bin/collective registerHost --host=controllerHost --port=controllerHTTPSPort
--user=controllerAdmin --password=controllerAdminPassword
這個範例指令會產生唯一的 SSH 金鑰組,用來接受所指定主機之 SSH 伺服器的鑑別。如果您正在登錄已產生 SSH 金鑰組的遠端主機,您可以指定 SSH 私密金鑰檔的路徑。下列
registerHost 指令假設 SSH 私密金鑰儲存在本端控制器電腦的
/home/user1/.ssh/id_rsa 中。SSH 金鑰組中的另一個檔案是位於遠端目標主機上的
/home/user1/.ssh/authorized_keys 公開金鑰檔。
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--sshPrivateKey=/home/user1/.ssh/id_rsa
如果遠端目標主機不支援 SSH,或者您不想使用 SSH 金鑰,您可以針對
rpcUser 指定作業系統登入使用者,針對
rpcUserPassword 指定登入密碼。如果您包含
rpcUser 與
rpcUserPassword,請勿包含
sshPrivateKey。用來指定作業系統登入使用者和密碼的指令類似如下:
wlp/bin/collective registerHost remotehost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUserForRemoteHost --rpcUserPassword=osUserPasswordForRemoteHost
如果要與主機往來傳送檔案,您必須指定主機讀取和寫入路徑。除非
registerHost 指令指定路徑,否則您無法將 Liberty 保存檔部署到主機。
hostReadPath 指定群體控制器可讀取的目錄。
hostWritePath 指定群體控制器可寫入的目錄。
hostWritePath 指定的路徑也可供讀取。例如,如果要將保存檔上傳至
/opt/wlp,您必須指定
--hostWritePath=/opt。若有多個路徑,則要多次指定參數。
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/opt --hostWritePath=/dir1 --hostWritePath=/dir2
如果要使用「WebSphere Liberty 管理中心」(簡稱「管理中心」)的「部署」工具,您必須將
hostWritePath 設為要將伺服器套件部署到的路徑。如果要傳送檔案至多個目錄,請在指令中包含多個
hostWritePath 參數實例。例如:
wlp/bin/collective registerHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin
--password=controllerAdminPassword --rpcUser=osUser --rpcUserPassword=osUserPassword--hostWritePath=c:\was\liberty\brokerageAppTest --hostWritePath=c:\wlp_backup
在利用「管理中心」的「部署」工具來部署伺服器套件之前,請完成設定 Liberty 群體作業的 RXA中適用於您的主機作業系統的步驟。
請選擇性地利用 -hostJavaHome 參數來指定主機 Java 起始目錄的路徑。
例如:-hostJavaHome=c:\java\jre
- 更新已登錄的主機鑑別資訊。
在群體公用程式 Script 上執行 updateHost 指令來變更已登錄主機的鑑別資訊。
比方說,如果使用者密碼有了改變,下列指令會更新群體所用的主機密碼:
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=newOsUserPassword
- 更新已登錄主機的讀取或寫入路徑。
在群體公用程式 Script 上執行 updateHost 指令,以變更主機讀取和寫入路徑。此指令中的路徑會置換先前為 hostReadPath 和 hostWritePath 設定的路徑,而且不會新增至現有的路徑。
wlp/bin/collective updateHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
--rpcUser=osUser --rpcUserPassword=osUserPassword
--hostReadPath=/optNew --hostWritePath=/opt --hostWritePath=/home/osUser
- 從群體控制器中,將主機取消登錄。
在群體公用程式 Script 上執行 unregisterHost 指令;例如:
wlp/bin/collective unregisterHost myHost.ibm.com --host=controllerHost
--port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword
取消登錄某主機,會移除這部主機上所有已登錄的伺服器,以及群體控制器中任何其他基於主機的資訊。
下一步
如需 registerHost、updateHost 和 unregisterHost 指令的所有參數的相關資訊,請參閱 CollectiveRegistration MBean 的 API 文件。