Introduction to Management

ScaleOut StateServer is designed to automatically manage itself to the greatest extent possible. In normal operation, hosts self-discover an existing store and self-aggregate to join the store and to take on a portion of the workload. When a host loses network connectivity or fails, the surviving hosts automatically attempt to detect the outage, recover to restore access to the affected objects, and then self-heal the store as necessary.

ScaleOut StateServer’s management tools are designed to simplify management and configuration by providing a comprehensive view of the distributed store’s status so that it can be managed as a single entity when appropriate and can be managed on a per host basis when necessary. Also, both management tools run on all hosts, and they let you uniformly configure and control both local and remote SOSS hosts.

The management tools include:

  • a Management Console with a graphical user interface, which runs as a Windows application,
  • a Web Management Console (Preview) with a graphical user interface, which runs as a web application in a standard web browser,
  • the Command-line Control Programs that you can run from a command prompt or embed in scripts, and
  • the ScaleOut Object Browser that lets you examine and manage objects within the distributed store. The management console and command-line control programs provide asynchronous notification of status changes in the store.

In addition, SOSS provides a complete set of Perfmon counters that let you monitor the status of each host’s status, memory usage, access rates.

Managing SOSS from a Remote Client

You can remotely manage an SOSS store from a networked computer by using the management tools with the Remote Client option. When using this option, the remote client connects to a random host within the remote SOSS store using the gateway list in the client parameters file (see Configuration Parameters). Once a connection is established, the management tools display this host as the “local host,” and all management operations then proceed as if the management tools were locally connected to the host. Should the host become unavailable, the remote client will automatically reconnect the management tools to another host within the SOSS store if another host in the gateway list is available.


You do not need to separately license the Remote Client option from ScaleOut Software to use this option with the management tools. However, an SOSS store requires a licensed Remote Client option for access by remote client applications.


Be sure to carefully read and follow all management procedures. It is important to allow a host to fully leave the store prior to shutting down the host or restarting the StateServer service. Otherwise, the host will abruptly leave the store, and other hosts will trigger recovery actions that further delay resumption of full storage throughput. In some cases, the distributed store can be destabilized, especially if multiple hosts are simultaneously stopped in this manner. Please refer to the following sections and the section Requirements and Limitations for details. Please see the section Best Practices for more information on managing SOSS hosts.