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
# Install the Linux trace toolkit
sudo apt-get -y install liblttng-ust0
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 |
|---|---|
|
|
|
In Mozilla Firefox, you can add a certificate exception by:
Navigate to Settings (alternatively, type about:preferences into the search bar).
Click
Privacy and Security.Scroll down to the
Certificatessection and selectView Certificates.Click
ServersClick
Add ExceptionFor location, enter one of the service URLs – i.e.
https://localhost:7701.Click
Get Certificate.Click
Confirm Security Exception.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.netPassword:
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 |
|---|---|---|
|
7701 |
Used to access the ScaleOut Active Caching UI. |
|
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 |
|---|---|---|
|
/usr/lib/soss-ac/soss-ac-web |
/var/log/soss/ac_web_log… |
|
/usr/lib/soss-ac/soss-ac-msg |
/var/log/soss/ac_msg_rest… |