

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 应用程序不是服务器。它是应用程序。然而,集合体控制器可以将解包到它已知的 wlpn 用户目录的 Node.js 应用程序作为集合体成员服务器来管理。在本文档中,Node.js 集合体成员有时称为 Node.js 服务器。
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
此命令展开 ${wlpn.usr.dir}/server_name(该目录缺省为 /home/user_name/wlpn)中的 .tgz 文件。如果 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
- 从 Liberty 集合体中移除 Node.js 集合体成员服务器。请在命令中指定 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