Windows Installation

This topic describes the installation process for the ScaleOut Active Caching software 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.

Install ScaleOut Active Caching Services

Download the MSI installer soss_activecaching_web.msi from the ScaleOut Support Downloads page.

Run the installer and go through the installation steps.

Accept the terms of the license agreement:

Select an installation folder:

Complete the installation:

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 can add it to the Trusted Root Certification Authorities.

Export the certificate

For instance, if using Chrome:

• Visit https://localhost:9901 and click the View Certificate button in the security warning.

• Go to the Details tab and click Copy to file to launch the Certificate Export Wizard.

• Follow the wizard’s steps to save the certificate, ensuring you select the Base-64 encoded X.509 (.CER) format and choose a save location.

Import the certificate into the Trusted Root Certification Authorities store

• Open the Start Menu, type certmgr.msc, and press Enter to open the Certificate Manager.

• Navigate to Trusted Root Certification Authorities > Certificates.

• Right-click on the Certificates folder, select All Tasks > Import.

• In the Certificate Import Wizard, click Next, then Browse to find and select the certificate file you exported.

• Click Next through the remaining steps, accepting the security warning by clicking Yes to complete the import.

Caution

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

Point the ActiveCaching Service to your ScaleOut Cluster

On the Active Caching Management UI (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:

In the example below, the IP is set to localhost because the StateServer cluster is installed on the same server as the Management UI.

Installed Services and Components

The Windows installer installs three services to the machine:

Service	Port	Summary
soss-ac-web	7701	Used to access the ScaleOut Active Caching UI.
soss-ac-identity	9901	Used for access control (create and add user logins).
soss-msg-rest	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	%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\WebService.Api	%ProgramData%\ScaleOut Software\WebService.Api
soss-ac-identity	%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\IdentityServer	%ProgramData%\ScaleOut Software\IdentityServer
soss-msg-rest	%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\Messaging.Api	%ProgramData%\ScaleOut Software\Messaging.Api