Installing a node manager (tarball 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; for details, see Installing a node manager (RPM Linux). If you do not have root access, use the tarball installer instead.

Note: When installing a node manager on a Red Hat Linux computer with Security-Enhanced Linux enabled, it is recommended to use the RPM-based installer over the tar.gz file. If you choose to use the TAR file anyway, it is recommended to use /opt/tibco/<subfolder> as the installation directory.

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.
Unpack and run the TAR file by entering the following command:
```
tar xzf tss-nm-<version number>.x86_64.tar.gz
```
The node manager is installed in the directory where you ran the command. A successful execution of the command does not result in any confirmation text.
Go to the new node manager directory; its name will be tss-nm-<version number>.x86_64.

Replace the italicized parameters in the following post-installation script; the parameters are defined in the table below. Then run the script in the directory where the TAR file was unpacked.

Note: Alternatively, you can run the command (./configure) without any parameters. In this case you will be prompted for the missing information.

./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.

The following message appears on the command line:

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

In the directory that contains the configure-boot file, enter the following command:
```
./configure-boot
```
The following message appears on the command line:
```
TIBCO Spotfire Server Node Manager <version number> has been successfully configured to start on system boot.
```
It will also be possible to start and stop the node manager from the command line.

What to do next

After installation, start the new node manager; see Starting or stopping a node manager (Linux) or Manually starting or stopping a node manager (tarball Linux). The second procedure does not require root user privileges.