Linux Installation

This topic describes the installation process for the ScaleOut Active Caching service on RedHat Enterprise Linux and Debian 11 systems.

Prerequisites

Before installing the software, ensure that your system meets the following requirements:

  • RHEL8, RHEL9, Debian 11, Debian 12, or Debian 13 based operating system

  • sudo privileges

  • A ScaleOut StateServer cluster on your network, accessible from the server you will use for this installation.

  • A license key for ScaleOut Active Caching that has been entered into the ScaleOut StateServer Management Console (contact sales@scaleoutsoftware.com to obtain a license key).

Important

The ScaleOut StateServer cluster must be active with at least one host joined to form an in-memory data grid. (A joined host has a green icon in the ScaleOut Management Console.)

Required Packages:

# Enable the RHEL8 appstream rpms
sudo subscription-manager repos --enable rhel-8-for-x86_64-appstream-rpms

# Install the Linux trace toolkit
sudo yum install -y lttng-ust

Start the ScaleOut Active Caching Web Service

Once the ScaleOut Product Suite is installed and at least one host has joined the ScaleOut StateServer cluster, start the ScaleOut Active Caching service:

sudo systemctl start soss-ac-web

To configure the service to start automatically on system boot, run the following command:

sudo systemctl enable soss-ac-web

Install Self-Signed Certificate

Note

Before using the UI, install the provided self-signed certificate. For production usage, replace the self-signed certificate with a trusted certificate. Follow our step-by-step guide to use a trusted certificate within your domain.

Service

Browser Certificate Exception

soss-ac-web

https://localhost:7701

soss-ac-msg

https://localhost:8801

In Mozilla Firefox, you can add a certificate exception by:

  1. Navigate to Settings (alternatively, type about:preferences into the search bar).

  2. Click Privacy and Security.

  3. Scroll down to the Certificates section and select View Certificates.

  4. Click Servers

  5. Click Add Exception

  6. For location, enter one of the service URLs – i.e. https://localhost:7701.

  7. Click Get Certificate.

  8. Click Confirm Security Exception.

  9. Repeat for all service URLs.

Caution

Generate and install a certificate following our step-by-step guide. The provided self-signed certificate is not intended for production usage.

First Time Log in

Open the ScaleOut Active Caching Management UI (https://localhost:7701). Press Login and use the built-in admin user:

  • Email: admin@localhost.net

  • Password: Sc@le0ut

To register new users or manage passwords and membership roles, please refer to the Manage Users page.

Installed Services and Components

The Linux installers install three systemd services on the machine:

Service

Port

Summary

soss-ac-web

7701

Used to access the ScaleOut Active Caching UI.

soss-ac-msg

8801

Used for sending messages to msg modules and digital twins.

The working directory, binaries, configuration, and log file locations of these services are:

Service

File Location

Log File Location

soss-ac-web

/usr/lib/soss-ac/soss-ac-web

/var/log/soss/ac_web_log…

soss-ac-msg

/usr/lib/soss-ac/soss-ac-msg

/var/log/soss/ac_msg_rest…