Revision: 1.6 - May 9, 2017
Copyright © 2015-2017 ScaleOut Software, Inc.
This guide provides information and advice to developers, system administrators, and managers who are pursuing a migration from Microsoft Windows Server AppFabric (WSAF) Caching to ScaleOut StateServer (SOSS). It outlines the key differences between the two products and offers guidance to help you complete a successful migration.
The topics in this guide include:
- Key architectural differences between the two products that may need to be considered when deploying and configuring ScaleOut StateServer
- Guidance for converting to ScaleOut’s ASP.NET session state and output cache providers
- Guidance for developers who are converting cache client applications, with equivalent API calls for core features and best practices for making the most effective use of ScaleOut APIs
- An overview of additional features in ScaleOut StateServer that can bring new levels of functionality and reliability to your application
ScaleOut Software welcomes your feedback. Please send your comments and questions to the ScaleOut support team.
Additional product documentation and guides are available on the Product Documentation page of ScaleOut Software’s web site.
This guide focuses on migrating applications to ScaleOut’s APIs. For users that need to continue using WSAF-style Caching APIs, ScaleOut Software also offers a WSAF Caching Compatibility Library that is source-compatible with AppFabric’s DataCache class. This library is shipped in version 5.4 and later.
Using the WSAF Caching Compatibility Library involves just a few easy steps:
- Add the soss_wsaf_compat.dll assembly as a reference to your project. This assembly can be found in the ScaleOut StateServer installation (typically C:\Program Files\ScaleOut_Software\StateServer) under the Compat\WSAF_Caching folder.
-
Change the "
using Microsoft.ApplicationServer.Caching;
" statements in your source files to "using Soss.Compat.WSAF;
". - Recompile your project to start using the WSAF Caching Compatibility Library.
More information about the compatibility library can be found on the Product Documentation page of ScaleOut Software’s web site.