• Facebook
  • Twitter
  • Youtube
  • LinedIn
  • RSS
  • Docs
  • Comparisons
  • Blogs
  • Download
  • Contact Us
  • Products
  • Solutions
  • Customers
  • Resources
  • Company
  • Pricing
  • Download
Download
  • Configure Caches
  • Create a Cache
  • Clustered Cache Overview
  • Distributed Cache with Persistence
Show / Hide Table of Contents
  • Administrator's Guide
  • NCache Architecture
    • Cache Topologies
      • Partitioned Topologies
      • Replicated Topology
      • Mirrored Topology
      • Scalability in Topologies
    • Dynamic Clustering
    • Local Cache
    • Cache Client
    • Client Cache
    • Bridge for WAN Replication
    • Connectivity with Load Balancer
    • Serialization Format
    • Data Encryption
    • Data Compression
    • Data Load Balancing
    • Pipelining
    • Cache Server Backward Compatibility
    • Client Backward Compatibility
    • Eviction
    • Indexing
    • Split-Brain
    • Maintenance Mode
    • Runtime Data Sharing
    • Portable Data Types
    • Class Versioning
    • IP Binding with Multiple NICs
    • Graceful Node Down
    • Separate Cache Host Process
    • Self Healing Dynamic Clustering
    • Distributed Cache with Persistence
  • NCache Management Center
  • Configure Caches
    • Create a Cache
      • Local Cache Overview
        • Local Cache
        • Local Cache with Persistence
        • Pub/Sub Messaging Cache
        • Add Existing Cache
      • Clustered Cache Overview
        • Distributed Cache
        • Distributed Cache with Persistence
        • Pub/Sub Messaging Cache
        • Add Existing Cache
        • Troubleshooting
    • Remove Cache
    • Clear Cache
    • Add Server Node
    • Remove Server Node
    • Add Test Data
    • Configure Query Indexes
    • Configure JSON Query Indexes
    • Compact Serialization
      • Non-Generic Registration
      • Non-Generic Unregistration
      • Generic Registration
      • Using Type Handler
    • Deploy Providers
    • Configure Custom Dependency
    • Add Data Source Providers
      • Read-through Provider
      • Write-through Provider
      • Write-behind Provider
    • Loader and Refresher
    • Configure Maintenance Mode
      • Stop for Maintenance Mode
      • Exit Maintenance Mode
    • Configure LINQPad
      • Configure LinqPad for NCache
      • Querying Data in LinqPad
  • Configure Clients
    • Add Client Node
    • Remove Client Node
  • Configure Client Cache
    • Create Client Cache
    • Create Client Cache with NuGet
    • Enable Client Cache on Client Nodes
    • Disable Client Cache on Client Nodes
    • Remove Client Cache
  • Management Operations
    • Start Cache
    • Stop Cache
    • Restart Cache
    • Manage Cache Service on a Server Node
    • Data Load Balancing
    • Invoke Refresher Dataset
    • Import/Export Cache Data
    • Suspend/Resume NCache Data Persistence
    • Backup and Restore NCache Persisted Data
  • Cache Settings
    • General Cache Settings
      • Cache Size
      • Cache Isolation Levels
      • Cache Serialization Format
      • Cache Data Expiration
    • Cache Cluster Settings
      • Ports
      • Operation Timeout
      • Configure Pipelining
      • Statistic Replication Interval
      • Connection Retries
      • Retry Interval
      • Split-Brain Auto Recovery
    • NCache Persistence Settings
      • Store Information
      • Persistence Interval
    • Error Logging
    • Cache Level Events
    • Client Activity Events
    • Eviction Policy
    • MapReduce
    • Register Classes for Portable Data Sharing
    • Compression
    • Email Notifications
    • Bind IP with Multiple NICs
    • Heartbeat
    • Keep Alive
    • Client Death Detection
    • Communication Reliability
    • Auto Start Cache on Boot
    • Nagle's Algorithm
    • Dual Socket
    • Configuration Files
      • Client Side Configurations
        • Client Config
        • EF Caching Config
      • Server Side Configurations
        • Cache Config
        • Bridge Config
        • Security Config
        • TLS Config
        • Monitoring Config
        • Emails Template
  • Cache Server Settings
    • Server Connectivity
    • Bind to Multiple NICs
    • Server Ports
    • Memory
    • Custom Dependency
    • Request Inquiry
    • Windows Events
    • Message Events
    • Expiration & Eviction
    • SQL Server
    • Logging
    • Monitoring
    • Persistence Data Loading Retries
    • Miscellaneous Configurations
  • Bridge Server Settings
  • Cache Client Settings
  • Client Cache Settings
  • Configure Security
    • Configure Authentication and Authorization
    • Configure Encryption for Cache
    • Configure TLS Encryption
    • Configure HTTPS for NCache Management Center
  • Configure Bridge for WAN Replication
    • Create Bridge
    • Add Clustered Caches to Bridge
    • Configure Bridge Settings
    • Change Cache Synchronization Modes
    • Bridge Management
    • Synchronize Caches in Bridge
    • Leave Bridge
    • Remove Cache from Bridge
    • Configure Conflict Resolver
  • Setup Database for Cache Synchronization
    • Setup SQL Server Environment
    • Setup Oracle Database Environment
    • Setup OleDb Environment
    • Setup SQL Server for CLR Procedures
  • Simulate NCache Usage
  • Monitor Caches
    • Counters
      • Distributed Cache Counters
      • Distributed Cache with Persistence Counters
      • Pub/Sub Messaging Cache Counters
      • Cache Client Counters
      • Bridge Counters
    • Monitor NCache Using the NCache Management Center
      • Using Monitoring Dashboards
        • Configure Monitor Settings
        • Configure Event Logging
        • Configure API Logging
        • Built-in Dashboard
        • Custom Dashboard
        • Cluster Connectivity
        • NCache Email Alerts
      • Using Tabular Statistics
        • Configure Counters to Display Caching Statistics
        • Configure Counters to Display Pub/Sub Statistics
        • Configure Counters to Display Bridge Statistics
        • Browse Cache Statistics
        • Monitor Bridge
    • Monitor NCache Using Command Line Tools
      • Cache Server Statistics Using Command Line Tools
      • Cache Client Statistics Using Command Line Tools
    • Monitor NCache Using Windows PerfMon Tool
      • Cache Server Counters Using PerfMon
      • Cache Client Counters Using PerfMon
      • Bridge Counters Using PerfMon Tool
    • Monitor NCache Using Prometheus
    • Monitor NCache Using Grafana
    • Monitor NCache Using SNMP Counters
    • Monitor NCache Using JMX Counters
    • Memory Dumps
    • Logging
      • NCache Log Viewer
      • Performance Counters Logging
      • Windows Event Logging
      • Cache Health Alerts
      • Email Notifications on NCache Events
      • Cache Server Logging
      • Client Side API Logging
      • Cache Event IDs
      • Feature Usage Logging
    • Troubleshooting NCache Monitoring
      • Computer Name Not Found
      • Diskperf Not Installed
      • No READ Access to Perflib Subkeys
      • Unable to Connect to Remote Server
    • IPV6 Support

Create a New Distributed Persistent Cache

A Persistent Cache can be created through the NCache Management Center or any Command Line Tools by creating a new store or using an existing store.

Note

A Distributed Cache with Persistence is supported for Partitioned Topologies and Local (out-proc) caches.

Prerequisites

Make sure the NCache Service is started. If it is not, do the following:

  • Windows Environment
  • Linux Environment
  • For .NET, type the following command in any Command Line Tool of your choice (run as admin):
Start-Service -Name NCacheSvc
  • For .NET Core, run NCacheSvc as Administrator.

In a terminal of your choice, type the following command:

> sudo systemctl start ncached

Using the NCache Management Center

  • Launch the NCache Management Center by browsing to http://localhost:8251 or <server-ip>:8251 on Windows and Linux.

  • In the left navigation bar, click on Clustered Caches. This opens up the Clustered Caches page. It shows any existing clustered caches on your machine and additional details like Topology, Servers, and Server Platform.

  • To create a new Distributed Cache with Persistence, click on New.

Create Persistent Cache Web

  • From the In-Memory Store Type dropdown menu, select Distributed Cache with Persistence and specify the name of your cache. Click Next.
Note

A Distributed Cache with Persistence supports JSON serialization only.

Create Persistent Cache Web

  • Select the caching topology and advanced options like Operation timeout and Statistic replication interval. Click Next.
Note

A Distributed Cache with Persistence supports the Partitioned and Partition-Replica Topologies only.

Select Topology for Persistent Cache Web

  • Specify the Cache Partition Size and add your cluster nodes by providing the Server Node IP or Host Name and clicking on the Add Node button. To add more nodes, click Add Node. Once all the required nodes are added, click Next.
Warning

If a cache with the specified name already exists, you are prompted with an error message.

Specify Size Persistent Cache Web

  • Next, you need to provide the persistence store settings for this cache on the Persistence Settings page where you have two options for persistence store.
Warning

Unless the connection to the persistence store has been tested successfully, you cannot proceed further with the cache creation process.

Important

The NCache Persistence requires a shared path that is accessible from all nodes. Make sure that all nodes have read and write access to the shared path.

Create New Store

  • In case you want to create a new store from scratch, choose New Store against the Select Store label. Specify the name of your store against the Store Name label. For connection information, provide the UNC Path, User Name, and Password. Once done, click on Test Connection. If the connection to your persistence store has been successfully tested, you will receive a success notification. Click Next.
Note

For Windows, User Name and Password are required if authentication is enabled on the file share. You can also provide the domain name along with the user name as domain_name\user_name.

Verify Connection Web

Use Existing Store

  • In case you want to use an existing store previously created with the same cache type (Distributed Cache with Persistence), choose Existing Store against the Select Store label given that you have an existing NCache Persistence store. Specify the name of your store against the Store Name label. For connection information, provide the UNC Path, User Name, and Password. Once done, click on Test Connection, and then either of the following can happen.

    • If the connection to the specified store is successful and it is in use of another cache, then you will be prompted with the following message. If you continue by clicking OK, no other cache will be able to use this store and you will receive a success notification.

      Verify Connection Web

    • If the connection to the specified store is successful and it is not in use of another cache, then you will receive a success notification.

Warning

The existing store of a local Distributed Cache with Persistence is incompatible with a clustered Distributed Cache with Persistence and vice versa.

  • After receiving the success message, click Next to proceed further.

  • Change the Cluster Port and Port Range if required. Click Next.

Specify TCP Parameters for Persistence Cache Web

  • If you want to enable encryption and compression, select the Enable Encryption and Enable Compression checkboxes. If enabled, set the Providers and Key for encryption and Threshold Size for compression. Click Next.
Note

If you want to use an existing store with encryption while creating a new cache, then encryption must be enabled on the new cache and vice versa. If the existing store was encrypted, the encryption credentials (provider and key) need to be the same as the ones used for the original store. If they are different, you will not be allowed to create the cache.

Encryption and Compression for Persistence Cache Web

  • On Advanced Options page, you can configure the following settings:

    • Eviction can't be enabled for this cache.

    • You can change the Clean Interval value. The default is 15 seconds.

    • This cache can be started automatically upon the completion of this process if you have selected the Start this cache on finish checkbox on this dialog box.

    • You can make the cache start automatically after service restart by selecting the Auto start this cache on service startup checkbox.

Note

Eviction is not supported for a Distributed Cache with Persistence.

Eviction for Persistence Cache Web

Warning

The cache will not start on a node on which the persistence store is inaccessible.

  • Click Finish to complete the process. Your created cache will appear in Clustered Caches page with the server nodes and their status and a success notification will be displayed in the notification panel.

Using Command Line

You can also use Command Line Tools to manage persistence caches by using the NCache supported cmdlets.

Create Cache

The New Cache tool is responsible for creating new caches. You can create a new Distributed Cache with Persistence as follows.

Important

The NCache Persistence requires a shared path that is accessible from all nodes. Make sure that all nodes have read and write access to the shared path.

  • Windows
  • Linux

The following command creates a Distributed Cache with Persistence named demoClusteredCache on the server nodes 20.200.20.40 and 20.200.20.39. A new NCache Persistence store named demoClusteredCache_db is created on the path \fileserver\stores using the provided connection string. The topology is PartitionReplica and the cache size is 1024MB.

Note

For Windows, User Name and Password are required if authentication is enabled on the file share. You can also provide the domain name along with the user name as domain_name\user_name.

New-Cache -Name demoClusteredCache -Server "20.200.20.40,20.200.20.39" -Size 1024 -InMemoryStoreType DistributedCacheWithPersistence -PersistenceStoreName demoClusteredCache_db -NewPersistenceStore -PersistenceStoreConnectionString "\\fileserver\stores\store1;\user_name;password" -Topology PartitionReplica

The following command creates a Distributed Cache with Persistence named demoClusteredCache on the server nodes 20.200.20.40 and 20.200.20.39. A new NCache Persistence store named demoClusteredCache_db is created on the path //fileserver/stores using the provided connection string. The topology is PartitionReplica and the cache size is 1024MB.

Note

For Windows, User Name and Password are required if authentication is enabled on the file share. You can also provide the domain name along with the user name as domain_name/user_name.

new-cache -name demoClusteredCache -server "20.200.20.40,20.200.20.39" size 1024 -inmemorystoretype DistributedCacheWithPersistence -persistencestorename demoClusteredCache_db -newpersistencestore -persistencestoreconnectionstring "//fileserver/stores/store1;/user_name;password" -topology PartitionReplica
Warning

The cache creation process will fail if the connection to the persistence store is unsuccessful.

Note

If you create a Distributed Cache with Persistence using an existing persistence store, you will be prompted with the message: The store might already be configured as a persistence store for another cache. No other cache will be able to use this store if you continue with this existing store. Are you sure you want to use the given store with this new cache('y' or 'n')?. Press y if you want to continue.

See Also

Start Cache
Add Server Node
Add Existing Cache
Remove Cache
Clear Cache

In This Article
  • Prerequisites
  • Using the NCache Management Center
    • Create New Store
    • Use Existing Store
  • Using Command Line
    • Create Cache
  • See Also

Contact Us

PHONE

+1 214-619-2601   (US)

+44 20 7993 8327   (UK)

 
EMAIL

sales@alachisoft.com

support@alachisoft.com

NCache
  • NCache Enterprise
  • NCache Community
  • Edition Comparison
  • NCache Architecture
  • Benchmarks
Download
Pricing
Try Playground

Deployments
  • Cloud (SaaS & Software)
  • On-Premises
  • Kubernetes
  • Docker
Technical Use Cases
  • ASP.NET Sessions
  • ASP.NET Core Sessions
  • Pub/Sub Messaging
  • Real-Time ASP.NET SignalR
  • Internet of Things (IoT)
  • NoSQL Database
  • Stream Processing
  • Microservices
Resources
  • Magazine Articles
  • Third-Party Articles
  • Articles
  • Videos
  • Whitepapers
  • Shows
  • Talks
  • Blogs
  • Docs
Customer Case Studies
  • Testimonials
  • Customers
Support
  • Schedule a Demo
  • Forum (Google Groups)
  • Tips
Company
  • Leadership
  • Partners
  • News
  • Events
  • Careers
Contact Us

  • EnglishChinese (Simplified)FrenchGermanItalianJapaneseKoreanPortugueseSpanish

  • Contact Us
  •  
  • Sitemap
  •  
  • Terms of Use
  •  
  • Privacy Policy
© Copyright Alachisoft 2002 - 2025. All rights reserved. NCache is a registered trademark of Diyatech Corp.
Back to top