Windows Installation
This topic describes the installation process for the ScaleOut Active Caching service on Windows.
Prerequisites
Before installing the software, ensure that your system meets the following requirements:
Windows 11/Server 2016 or later
Administrator 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.)
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:
net start soss-ac-web
To configure the service to start automatically on system boot, run the following command:
sc config soss-ac-web start=auto
Self-Signed And Trusted Certificates
For convenience, the ScaleOut Active Caching installation comes with a self-signed TLS certificate. This self-signed certificate is not intended for production usage and should be replaced with a trusted certificate. Follow our step-by-step guide to use your trusted certificate within your domain.
If you intend to use the self-signed certificate for your testing, you need to add it to the Trusted Root Certification Authorities before using the UI.
First Time Log in
Note
Install the self-signed certificate before opening the ScaleOut Active Caching Management UI. Please refer to the previous section.
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 Windows installer installs three services to 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 |
|---|---|---|
|
%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\WebService.Api |
%ProgramData%\ScaleOut Software\WebService.Api |
|
%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\Messaging.Api |
%ProgramData%\ScaleOut Software\Messaging.Api |