Installing a node manager (RPM Linux)

To make the TERR service or Spotfire Service for Python available to end users, you have the option of installing a node manager on a Linux computer instead of a Windows computer. A Spotfire implementation can contain several nodes, but each one must be installed on a different computer.

About this task

If you have root access to the Linux computer on which you want to install the node manager, you can use the RPM-based installer. If you do not have root access, use the tarball installer instead; for details, see Installing a node manager (tarball Linux).

Before you begin

Spotfire Server is installed and running.
In the firewall of the computer on which you are installing the node manager, open the ports that will be used for the node manager and the services. The default ports are listed in the "Installation parameters" table, below.

Procedure

Open a terminal and go to the directory that contains the node manager installation file.
Enter the following command to install the node manager:
```
rpm -ivh tss-nm-<version number>.x86_64.rpm
```
A successful execution of the command produces text similar to this:
```
Preparing...
Updating / Installing...
    l:tss-nm-<version>-1-1
You must now execute /opt/tibco/tsnm/<version number>/configure to complete the configuration.
```
By default, the node manager is installed in the following directory: /opt/tibco/tsnm/<version number>.

Replace the italicized parameters in the following post-installation script; the parameters are defined in the table below. Then run the script.

Note: Alternatively, you can run the script without any parameters. In this case you will be prompted for the missing information.

<node manager installation dir>/<version number>/configure -m NODEMANAGER_REGISTRATION_PORT -c NODEMANAGER_COMMUNICATION_PORT -s SERVER_NAME -r SERVER_BACKEND_REGISTRATION_PORT -b SERVER_BACKEND_COMMUNICATION_PORT -n NODEMANAGER_HOST_NAMES

Note: Include only those parameters whose default values you are changing, in addition to the server name. The default values are listed in the table below.

Table 1. Installation parameters
Parameter	Description
`NODEMANAGER_REGISTRATION_PORT`	Node manager registration port (Default: 9080) Port used for initial setup of internal secure communication channels. Needs only be accessible from Spotfire Server(s). Important: Running the node manager and the Spotfire Server on the same computer is not a supported configuration. However, if you decide to install the node manager on the same computer as the server, this port must be different than the Spotfire Server backend registration port.
`NODEMANAGER_COMMUNICATION_PORT`	Node manager communication port (TLS) (Default: 9443) Port used for secure (TLS) internal communication within the environment. Needs only be accessible from Spotfire Server(s). Important: Running the node manager and the Spotfire Server on the same computer is not a supported configuration. However, if you decide to install the node manager on the same computer as the server, this port must be different than the Spotfire Server backend communication port.
`SERVER_NAME`	Must match the host name of the Spotfire Server. Note: Use the FQDN (Fully Qualified Domain Name).
`SERVER_BACKEND_REGISTRATION_PORT`	Server backend registration port (Default: 9080) Must match the registration port specified in the Spotfire Server installation.
`SERVER_BACKEND_COMMUNICATION_PORT`	Server backend communication port (TLS): (Default: 9443) Must match the backend communication port specified in the Spotfire Server installation.
`NODEMANAGER_HOST_NAMES`	A comma-separated list of IP addresses, hostnames, and FQDN names that can be used by backend trust. These should be for the interface(s) on the computer where the node manager is installed. Note: Valid hostnames may only contain alphabetic characters, numeric characters, hyphens and periods. Note: If you do not enter any values, the installer automatically provides values. After installation, confirm that these are correct in the following file: <node manager installation dir>/<version number>/nm/config/nodemanager.properties.

Text similar to the following appears on the command line:

Post install configuration of TIBCO Spotfire Server Node Manager <version number> successful.

What to do next

After installation, start the new node manager; see Starting or stopping a node manager (Linux).