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.

Import the certificate into the Trusted Root Certification Authorities store

The provided self-signed certificate is located in your installation folder:

C:\Program Files\ScaleOut_Software\StateServer\ActiveCachingWebUI\WebService.Api\certs

  • Right-click on the public key certificate file (default-sossac-cert.crt) and choose Install Certificate. The Certificate Import Wizard will appear.

  • Select the Local Machine store location and click Next.

  • Select Place all certificates in the following store and click on Browse.

  • Select the Trusted Root Certification Authorities store and click Ok.

  • Click Next and then Finish to complete the installation of the public key certificate.

While these instructions work for Google Chrome, they might not be sufficient for Mozilla Firefox. If you still see Not Secure in the address bar after following these steps and restarting Firefox, you might need to add a certificate exception as described in the corresponding Linux instructions.

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

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.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 Windows installer installs three services to the machine:

Service

Port

Summary

soss-ac-web

7701

Used to access the ScaleOut Active Caching UI.

soss-msg-rest

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

%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\WebService.Api

%ProgramData%\ScaleOut Software\WebService.Api

soss-msg-rest

%ProgramFiles%\ScaleOut_Software\ActiveCachingWebUI\Messaging.Api

%ProgramData%\ScaleOut Software\Messaging.Api