適用於 LINUX 平台適用於 Windows 平台

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
其中 action 可以採用下列值和變數:
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 檔。

下列程序說明如何準備和壓縮目錄:

  1. 建立 Node.js 應用程式
  2. 您可以選擇性地建立 server.json 檔,並將它放在 package.json 檔的相同目錄中。server.json 檔內容類似下列範例:
    { 
      "clusterName": "cluster name",
      "contextRoot": "context root",
      "appPort":"integer",
      "adminPort":"integer"
    }
    • cluster name 預設為 server name
    • context root 為選用的,且預設為 server name
    • 對於 appPortinteger 是應用程式流量的埠,預設為 9080。
    • 對於 adminPortinteger 是管理資料流量的埠,預設為 9443。
  3. 如果要包含相依關係,請在應用程式目錄中執行 npm install 指令。
  4. 如果要壓縮目錄,請執行 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]
其中 action 可以採用下列值和變數:
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

指示主題類型的圖示 參照主題

檔名:rwlp_command_nodejs.html