For LINUX platformsFor Windows platforms

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
其中 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

此命令展开 ${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]
其中 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
从 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

用于指示主题类型的图标 参考主题

文件名:rwlp_command_nodejs.html