Migrating from Windows Server AppFabric Caching to ScaleOut StateServer®

Revision: 1.6 - May 9, 2017

ScaleOut StateServer is a registered trademark of ScaleOut Software, Inc.

Microsoft, Visual Studio, Windows, Azure, SQL Server, PowerShell, and AppFabric are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.


Introduction

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

Feedback and Questions

ScaleOut Software welcomes your feedback. Please send your comments and questions to the ScaleOut support team.

Other Resources

Documentation

Additional product documentation and guides are available on the Product Documentation page of ScaleOut Software’s web site.

WSAF Caching Compatibility Library

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:

  1. 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.
  2. Change the "using Microsoft.ApplicationServer.Caching;" statements in your source files to "using Soss.Compat.WSAF;".
  3. 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.