Linux Installation

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

Prerequisites

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

RHEL8 or Debian 11 based operating system
sudo privileges
A ScaleOut cluster somewhere on your local network…

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

RedHat Enterprise Linux 8

Install the ScaleOut Active Caching services with the command:

sudo rpm -i soss-ac-web-1.0.0-1.el8.x86_64.rpm

Debian 11 Based Systems

Install the ScaleOut Active Caching services with the command:

sudo dpkg -i soss-ac-web_1.0.0-1_amd64.deb

Install Self-Signed Certificate

Note

Before using the UI, you need to 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 your 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:

Navigating to Settings (alternatively, type about:preferences into the search bar).
Click Privacy and Security.
Scroll down to the Certificates section and select View Certificates.
Click Servers
Click Add Exception
For 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 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.

Point the ActiveCaching Service to your ScaleOut Cluster

On the Active Caching Web UI (by default: https://localhost:7701), navigate to Account and Settings, scroll to IP Configuration and update the connection string with the gateway IPs of your ScaleOut cluster:

Installed Services and Components

The Linux installers install three systemd services to 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.

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…