

apiconnect-collective-member wlpn-server 和 wlpn-collective 指令
執行 wlpn-server 指令,來啟動或停止解壓縮的 Node.js 應用程式,並壓縮或解壓縮應用程式。執行 wlpn-collective 指令,以便加入 Node.js 應用程式,成為 Liberty 群體的成員,或將 Node.js 群體成員從群體移除。從 ${wlpn.usr.dir} 目錄(預設為 /home/user_name/wlpn) 來執行 apiconnect-collective-member 指令。
雖然您執行 wlpn-server 指令,來啟動和停止解壓縮的 Node.js 應用程式,以及執行 wlpn-collective 指令,使其成為 Node.js 群體成員,但 Node.js 應用程式並不是伺服器。它是應用程式。不過,Node.js 應用程式會解壓縮到 群體控制器已知的 wlpn 使用者目錄,且控制器會將它當成群體成員伺服器來管理。在本說明文件中,Node.js 群體成員有時稱為 Node.js server。
wlpn-server 指令語法
wlpn-server 指令的語法如下:
wlpn-server action variable | variable
- help
- 顯示 wlpn-server 指令的相關資訊。
wlpn-server help
- start
- 啟動解壓縮的 Node.js 應用程式。對於 server_name,請在指令中指定要啟動之解壓縮 Node.js 應用程式的名稱。
wlpn-server start server_name
此指令會啟動伺服器處理程序,並將 PID 檔寫到伺服器目錄中,預設為 /home/user_name/wlpn/server_name。
- stop
- 停止解壓縮的 Node.js 應用程式。對於 server_name,請在指令中指定要停止之解壓縮 Node.js 應用程式的名稱。
wlpn-server stop server_name
此指令會停止伺服器處理程序,並將 PID 檔從伺服器目錄移除。
- pack
- 使用 .tgz 副檔名來建立壓縮 TAR 保存檔,以便在檔案系統上部署應用程式。請在指令中指定要壓縮的目錄。
wlpn-server pack directory_to_pack
此指令會壓縮指定的目錄,並在現行目錄中建立 .tgz 檔。
下列程序說明如何準備和壓縮目錄:
- 建立 Node.js 應用程式。
- 您可以選擇性地建立 server.json 檔,並將它放在
package.json 檔的相同目錄中。server.json 檔內容類似下列範例:
{ "clusterName": "cluster name", "contextRoot": "context root", "appPort":"integer", "adminPort":"integer" }
- cluster name 預設為 server name。
- context root 為選用的,且預設為 server name。
- 對於 appPort,integer 是應用程式流量的埠,預設為 9080。
- 對於 adminPort,integer 是管理資料流量的埠,預設為 9443。
- 如果要包含相依關係,請在應用程式目錄中執行 npm install 指令。
- 如果要壓縮目錄,請執行 wlpn-server pack 指令。
- unpack
- 將應用程式解壓縮至磁碟,以建立伺服器目錄。請在指令中指定要建立之伺服器的名稱,以及要解壓縮的 TAR 檔名。
wlpn-server unpack server_name tgz_file_name
此指令會將 .tgz 檔展開於 ${wlpn.usr.dir}/server_name,其預設為 /home/user_name/wlpn 目錄。如果 wlpn 目錄不存在,指令會建立 wlpn 目錄。
用法
下列範例示範正確的語法:
wlpn-server help
wlpn-server start myServer
wlpn-server stop myServer
wlpn-server pack example-app
wlpn-server unpack myServer example-app.tgz
wlpn-collective 指令語法
wlpn-collective 指令的語法如下:
wlpn-collective action server_name [options]
- help
- 顯示 wlpn-collective 指令的相關資訊。
wlpn-collective help
- join
- 將解壓縮的 Node.js 應用程式加入至 Liberty 群體,以成為成員。請在指令中指定解壓縮之 Node.js 應用程式的名稱、群體控制器主機、埠、使用者和密碼,以及金鑰儲存庫密碼。
wlpn-collective join server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --keystorePassword=generatedKeystorePassword
此外,請視需要指定下列一或多個選用參數:- --autoAcceptCertificates
- 自動信任任何 SSL 憑證。
- --sshPrivateKey
- wlpn-collective
join 指令會產生唯一 SSH 金鑰組,以便接受所指定主機之 SSH 伺服器的鑑別。如果您正在登錄已產生 SSH 金鑰組的遠端主機,您可以指定 SSH 私密金鑰檔的路徑。下列指令假設 SSH 私密金鑰儲存在本端控制器電腦上的
/home/user1/.ssh/id_rsa。SSH 金鑰組中的另一個檔案是位於遠端目標主機上的
/home/user1/.ssh/authorized_keys 公開金鑰檔。
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --sshPrivateKey=/home/user1/.ssh/id_rsa
- --genDeployVariables
- 將解壓縮的 Node.js 應用程式加入至 Liberty 群體成為成員時,配置部署變數(埠)。genDeployVariables 選項會將部署變數登錄到群體儲存庫,並產生部署變數給成員。 關於在控制器 server.xml 檔中用來定義部署變數的 deployVariable 陳述式範例,請參閱使用部署 REST API 來部署 Node.js 伺服器中的步驟 3。
此指令會將 Node.js 應用程式加入至群體,並在從中執行指令的檔案系統上建立 SSL 配置檔。指令也會在檔案系統的 ${wlpn.usr.dir}/server_name 目錄中建立 join.json 檔。 join.json 檔不同於 server.json,是用於群體。join.json 檔含有控制器主機名稱、埠號以及活動訊號間隔。
- remove
- 將 Node.js 群體成員伺服器從 Liberty 群體移除。請在指令中指定 Node.js 伺服器的名稱、群體控制器主機、埠、使用者和密碼,以及 --autoAcceptCertificates 參數。
wlpn-collective remove server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --autoAcceptCertificates
此指令會將 Node.js 伺服器從群體移除,並刪除 SSL 配置和 join.json 檔。
- registerHost
- 向群體控制器登錄您要在其中安裝 Node.js 伺服器的主機。請在指令中指定目標主機的名稱、群體控制器主機、埠、使用者和密碼,以及 --autoAcceptCertificates 參數。
wlpn-collective registerHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
此指令可讓群體控制器存取主機上的檔案、指令和其他資源。
- updateHost
- 變更 Node.js 伺服器所在主機的主機登錄參數值。請在指令中指定目標主機的名稱、群體控制器主機、埠、使用者和密碼,以及 --autoAcceptCertificates 參數。
wlpn-collective updateHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
此指令會更新主機登錄。
用法
下列範例示範正確的語法:
wlpn-collective help
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates
wlpn-collective remove myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates