

![[16.0.0.3 and later]](../ng_v16003plus.gif)
Deploying Node.js servers with Admin Center
You can use the Deploy tool to install Node.js servers as members of a collective. A Node.js collective member is called a Node.js server in this documentation.
Before you begin
- Create a Liberty collective that includes the hosts to which you plan to install the Node.js server. See the Before you begin section of Deploying resources with Admin Center and the Configuring a Liberty collective topic.
- Complete the Before you begin section and steps 1-4 in Deploying Node.js servers using deployment REST APIs. You do not need to complete step 2b unless the Node.js application is on the collective controller.
For versions prior to 17.0.0.2, if you want to upload the Node.js application from your browser system to the collective controller on the Deployment Parameters panel in step 3, add to the controller server.xml file a remoteFileAccess statement that enables write access to the location; for example:
For versions prior to 17.0.0.2, this statement is required even if you specify host write paths with --hostWritePath in the registerHost or updateHost command on the controller host.<remoteFileAccess writeDir="/home/uploadDir/>
- In version 17.0.0.2 and earlier, you can upload a maximum of 200 MB for server and application packages. Use a file that is already on the collective controller option to avoid this limitation. Starting in version 17.0.0.3 and later, the maximum increases to 1 GB.
About this task
After you install Node.js, configure the Liberty collective, and register the target host, use the Deploy tool to install the Node.js server as a member of the collective.
Procedure
- Go to the Deploy tool.
- From the Toolbox, select Deploy
.
- From details on hosts in the Explore tool, select Actions
> one_or_more_host_names > Deploy Server Package.
To directly launch the Deploy tool in the future, you can use the URL that is shown in the browser when you view the Deploy tool.
- From the Toolbox, select Deploy
- Select to install a Node.js application package.
- For DEFAULT SERVER TYPES, select Node.js.
- For DEFAULT RULES, select the Application Package default rule.
- Under APPLICATION PACKAGE, select CONFIRM.
- For Deployment Parameters, specify the server package file to deploy,
the server name, and the cluster name. If you drag a package to the Deploy tool or browse for a
package, the server package file name value is set automatically. You can also type in a value. To
specify a cluster name, you can select a cluster from a list of existing clusters or type in a new
cluster name.
- Drag or browse option
To upload a file from your browser system to the collective controller, drag a package to the Deploy tool or browse for a package.
For versions prior to 17.0.0.2, to upload a file from your browser system to the collective controller with a drag or browse option, you must first add to the controller server.xml file a statement that enables write access.
- Use a file located on the collective controller option
To use a file in the controller, the Node.js application must be available to the controller. If you have not done so already, complete step 2b in Deploying Node.js servers using deployment REST APIs. You then can use the Use a file located on the collective controller option.
After you upload or drop a file, select Use a file located on the collective controller again to edit the Application directory field.
The installation directory must be the same as the --hostWritePath value specified when you registered the target host with the controller.
- Drag or browse option
- For Selected Hosts, select the host computers on which to install the
server. If you do not see the wanted target host in the list of available hosts, you can search for
a host.
Each target host must be registered with the collective that is managed by Admin Center. See Registering host computers with a Liberty collective.
- For Security Details, specify a password to protect newly generated
keystore files that contain server authentication credentials.
The product generates keystore files in the resources directory of each deployed server.
- Select Deploy.
Results
The Deploy action runs. The Deploy tool displays messages about deployment status and results.

File name: twlp_ui_deploy_nodejs.html