Installing StackState in a production configuration

This page describes StackState version 4.0.

The StackState 4.0 version range is End of Life (EOL) and no longer supported. We encourage customers still running the 4.0 version range to upgrade to a more recent release.

Go to the documentation for the latest StackState release.

Requirements

Before starting the installation, ensure your system(s) meet StackState's production deployment installation requirements.

Two-node deployment architecture

NOTE: Installing StackState on versions older than 1.15.0 requires an alternative procedure, see (Installing before 1.15.0).

The StackState production environment requires two nodes a StackGraph and a StackState node.

Configure StackState to run in the two-node setup requires the following steps:

Preparing the StackGraph node

1. Install the package using the instruction for Installing StackState, using PRODUCTION-STACKGRAPH as SETUP configuration parameter.

2. Start the StackGraph process as described in Starting / Stopping.

Preparing the StackState node

To prepare an additional node for running a StackState component, follow these steps:

1. Install the package using the instruction for Installing StackState, using PRODUCTION-STACKSTATE as SETUP configuration parameter.

Further Configuring StackState

After you have installed StackState, refer to the following pages for configuration instructions:

• Configuring authentication

• Reverse Proxy (recommended setup) or TLS without reverse proxy

Starting and Stopping

Note that the StackGraph node always needs to be running before starting StackState

Starting and Stopping StackGraph

On the StackGraph node, the following commands will start/stop StackGraph:

sudo systemctl start stackgraph.service

sudo systemctl stop stackgraph.service

Starting and Stopping StackState

On the StackState node, the following commands will start/stop StackState:

sudo systemctl start stackstate.service

sudo systemctl stop stackstate.service