ScaleOut StateServer consists of the following key components and their installation locations:
| Installer Component(s) | SOSS Component | File(s) | Installed in the: |
|---|---|---|---|
|
All |
Management Console, a .NET executable |
soss_console.exe, soss_mgtdotnet.dll, soss_mgtcli.dll |
Installation folder |
|
All |
Object Browser, a .NET executable |
dotnetbrowser.exe |
Installation folder |
|
All |
soss.exe, geos.exe |
Installation folder |
|
|
All |
.NET Store Access Application Program Interface (API) |
soss_svcdotnet.dll |
.NET Global Assembly Cache, \DOTNET2.0\, and \DOTNET4.0\ in Installation folder |
|
All |
.NET Distributed Cache Application Program Interface (API) NOTE: This API provides the primary interface for applications. |
soss_namedcache.dll, soss_namedcache.xml |
.NET Global Assembly Cache, \DOTNET2.0\, \DOTNET3.5\, \DOTNET4.0\, and \DOTNET4.5\ in Installation folder |
|
All |
.NET Cached Data Accessor Application Program Interface (API) [DEPRECATED] NOTE: This API layers above the .NET Store Access API to provide simplified semantics. |
soss_cachedotnet.dll, soss_cachedotnet.xml |
.NET Global Assembly Cache, \DOTNET2.0\, and \DOTNET4.0\ in Installation folder |
|
All |
C Application Program Interface |
soss_svccli.dll, soss_svccli.h, soss_query.h |
\c_api\ in Installation Folder |
|
All |
C Parallel Method Invocation Client Library |
soss_svccli.dll, soss_pmicli.h |
\c_api\ in Installation Folder |
|
All |
C++ Native Client Application Program Interface (API) headers and libs |
cpp_api\* |
\cpp_api\ in Installation Folder |
|
All |
HTTP REST Application Program Interface (API) service and documentation |
soss_svc_rest\* |
\soss_svc_rest\ in Installation Folder |
|
All |
Java Named Cache (JNC) Application Program Interface (API) |
soss-jnc-5.5.jar |
\JavaAPI\ in Installation Folder |
|
All |
Java Event Pipeline Application Program Interface (API) |
soss-eventpipeline-5.5-PREVIEW.jar |
\JavaAPI\ in Installation Folder |
|
All |
Java hServer Application Program Interface (API) and libraries |
hslib\* |
\JavaAPI\ in Installation Folder |
|
All |
Java hServer Application Program Interface (API) source code |
soss-hserver-5.5-src |
\JavaAPI\ in Installation Folder |
|
All |
Java default logger configuration file |
log4j.properties |
\JavaAPI\ in Installation Folder |
|
All |
Java third party libraries and licensing information |
\JavaAPI\third_party_lib\*.jar, \JavaAPI\license_readme.txt |
\JavaAPI\ in Installation Folder |
|
All |
Java API documentation (Javadoc) |
soss-jnc-5.5-javadoc.jar, soss-hserver-5.5-javadoc.jar |
\JavaAPI\ in Installation Folder |
|
All |
Java Event Pipeline Documentation (Javadoc) |
soss-eventpipeline-5.5-javadoc-PREVIEW.jar |
\JavaAPI\ in Installation Folder |
|
All |
Online help |
soss_help.chm, dotnetbrowser.chm |
Installation folder |
|
All |
API help files |
SOSS_NamedCacheAPI.chm, SOSS_DotNetAPI.chm, SOSS_CacheAPI.chm |
Installation folder |
|
All |
Sample programs |
\Samples\C, \Samples\Cpp, \Samples\DotNet, Samples\Java sub-folders |
\Samples\ in Installation folder |
|
All |
Sample Web site test programs for ASP.Net |
SessionTestSetup.msi, SessionTest_readme.txt |
\DOTNET2.0\SessionTest\ and \DOTNET4.0\SessionTest\ in Installation Folder |
|
Server |
StateServer service, a Windows service |
soss_svr.exe |
Installation folder |
|
Server |
Parameters file |
soss_params.txt |
Installation folder |
|
Server (GeoServer Option) |
Parameters file |
soss_client_params.txt |
Installation folder |
|
Remote Client |
Remote Client configuration file |
soss_client_params.txt |
Installation folder |
|
ASP.NET |
ASP.NET Session Provider |
soss_storeprovider.dll |
.NET Global Assembly Cache |
|
All |
Microsoft Azure related components |
soss_azure_adapter.exe, soss_azureproxylib.dll, SOSSWorkerRole.dll |
.NET Global Assembly Cache and Installation folder |
|
All |
Windows Server AppFabric Caching Compatibility Library |
soss_wsaf_compat.dll, SOSS_WSAF_API.chm |
.NET Global Assembly Cache and \Compat\WSAF_Caching in Installation folder |
|
All |
Windows PowerShell Modules |
soss_mgt_cmds.dll, soss_mgt_cmds.dll-Help.xml, soss_mgt_cmds.format.ps1xml, SossAdministration.psd1 |
\PowershellModules in Installation folder |
These components are organized as shown in the following diagram. The components with blue borders provide user-accessible features, and the red circle depicts the StateServer service.
Note that the StateServer service uses three Internet Protocol ports. The management port is used for local host access by the management tools using the TCP protocol and optionally for multicast between hosts using the UDP protocol. The server port is used for client access by the APIs using the TCP protocol. The interconnect port is used for internal, inter-host communication by SOSS hosts using the TCP protocol.
Optional Components
When using the standard installer for ScaleOut StateServer (soss_setup32.msi for 32-bit Windows and soss_setup64.msi for Windows x64), you should see the following screen, which lets you select either the Server component, the Remote Client/Cloud Mgt. component, or specific components for installation:
![[Note]](../common/images/admon/note.png) |
Note |
|---|---|
|
This installer requires the .NET 3.5 framework or higher and automatically installs support for ASP.NET 2.0 and higher. |
If you are installing the Remote Client option (for a networked computer that will communicate with a remote SOSS store) or preparing to launch ScaleOut StateServer in a public cloud, select the Remote Client/Cloud Mgt. component. If you would like to just install specific components, such as the .NET Developer Libraries, select Custom, which lets you select specific components for installation:
