Installing a node manager (tarball Linux)

You can install a node manager on Linux using the tarball installer.

About this task

Note: You might need to configure Security-Enhanced Linux in your system, if enabled, to install the node manager using the tarball. Check the corresponding documentation for your operating system.

Note: We strongly advise that you install each Spotfire node manager on a separate computer (physical computer, virtual machine or container).

Before you begin

Spotfire Server is installed and running.
You must have sudo access to the host.
The commands zip and unzip are installed.
In the firewall of the computer on which you are installing the node manager, open the ports that the node manager and the services use. The default ports are listed in the Installation parameters table under Node manager installation.

Procedure

Copy the node manager installation software package from its download directory to a temporary directory on the target host.
For example, /temp/.
Create a destination directory for the node manager. The path should not contain any whitespace characters (as per Linux naming best practices).
Example:
```
mkdir -p /opt/spotfire/nodemanager/<version number>
```

From the destination directory, unpack the package.

Example:

cd /opt/spotfire/nodemanager/<version number>
tar xzf /temp/spotfirenodemanager-<version number>.x86_64.tar.gz
--strip-components 1

The node manager is installed in the destination directory.

In the node manager installation directory, execute the configure post installation script, specifying the values for the parameters.
Example:
```
./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:
- To be prompted to provide the values, run the ./configure command with no parameters (./configure).
- To provide specific parameter values, run the ./configure command with explicit values for the parameters (for example, ./configure -s SPOTFIRE_SERVER.example.com -r 9081 -b 9444).
See the Installation parameters table under Node manager installation for detailed information about the available parameters.

For more information about ports and how they are used, see Ports and firewall configuration.
The following message is displayed on the command line.
```
Post install configuration of Spotfire Server Node Manager <version number> was successful.
```
To configure the node manager to start when the computer starts, from the directory containing the configure-boot file, run the following command.

Important: You must have root user access to the computer to run the following script.
```
./configure-boot
```
The following message is displayed on the command line.
```
Spotfire Server Node Manager <version number> has been successfully configured to start on system boot. 
```
Note: Running the configure-boot script changes the installation directory ownership to user spotfire and restricts other users from performing actions on the installation directory.

Customizing your installation

You can make your tarball installation more streamlined by using commands as in the following example:

SERVER_VERSION=<version>
mkdir -p /opt/spotfire/nodemanager/$SERVER_VERSION
tar xvf spotfirenodemanager-$SERVER_VERSION.x86_64.tar.gz --strip-components=1 --directory=/opt/spotfire/nodemanager/$SERVER_VERSION
 
/opt/spotfire/nodemanager/$SERVER_VERSION/configure -s "${SERVER_FRONTEND_PORT:-8080}" -r "${NODEMANAGER_REGISTRATION_PORT:-9080}" -b "${NODEMANAGER_COMMUNICATION_PORT:-9443}"
/opt/spotfire/nodemanager/$SERVER_VERSION/configure-boot

What to do next

After installation, start the new node manager. You can start and stop the node manager from the command line. See Starting or stopping a node manager (Linux) or Manually starting the node manager process (tarball Linux). The second procedure does not require root user privileges.

If you intend to use the node manager with a Web Player or Automation Services service, you must also install some required packages. Read more in Running Web Player or Automation Services on Linux.

For administrators of large implementations who want to be able to quickly scale their Spotfire system as necessary, an automated method of installing and configuring services and service instances is available. For details, see Automatically installing services and instances.