Create a New Local Persistent Cache

A local persistence cache can be created in the following ways:

Prerequisites

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

In a command line tool of your choice, execute the following command:

Start-Service -Name NCacheSvc

For .NET Core, make sure that you run the NCache Service as an administrator. Here are the steps to do so:

  • Open the Services window and look for NCache in the list.
  • Right click on NCacheSvc from the list and choose Properties.
  • Go to the Log On tab and click on the Browse button.
  • In the object name field, type Administrator and click on the Check Names button.
  • It will pick the appropriate Administrator, then click OK.
  • Now, set a Password and click OK.
  • Right click on the NCache Service and choose the Restart option. Now your service will start running as administrator.

Using 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 Local Caches. This opens up the Local Caches page at <server-ip>:8251/LocalCaches/. The page shows any existing local caches on your machine and additional details like Server and Server Platform.

  • To create a new local cache, click on New.

Create New Local Cache Web

  • Specify the Server Node IP / Name and click Next.

Enter Server IP Web

  • Specify the In-Memory Store Type as Local Cache with Persistence from the dropdown menu. Afterwards, specify the Name of your cache. Click Next.
Warning

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

Note

A Local Cache with Persistence only supports JSON serialization and OutProc mode.

Specify Cache Name Web

  • Change the cache size if required and click Next.

Specify Cache Size 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 can not proceed further with the cache creation process.

Important

NCache Persistence requires a shared path that is accessible from the cache node. Make sure that cache node has read and write access to the shared path. To set up a shared path on Linux for NCache Persistence.

Create New Store

  • 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.

NCache Persistence Store

Use Existing Store

  • In case you want to use an existing store previously created with the same cache type (local cache with persistence), you can choose Existing 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 , and then either of the following can happen.

    • If the connection to the specified store is tested successfully 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.

      Notification

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

Warning

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

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

  • If you want to enable encryption and compression, check 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 Settings

  • 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 checked the Start this cache on Finish checkbox on this dialog box.

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

Advanced Options Web

  • Click Finish. The created cache will appear on the Local Caches page, and a success notification will be received in the notification panel.

Local Cache Started

Using Command Line

NCache also provides you with cmdlets to create a local cache with persistence. To create a local cache with persistence, follow the steps below:

Create Cache

The New Cache tool is responsible for creating new caches. You can create a new local cache with persistence as follows.

Important

NCache Persistence requires a shared path that is accessible from the cache node. Make sure that the cache node has read and write access to the shared path.

Note

Explicitly specify the NewPersistenceStore flag while creating a new store.

The following command creates a local cache with persistence named myCache. A new persistence store named myCache_db is created on the path \fileserver\stores using the provided connection string. The topology is Local 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 myCache -InMemoryStoreType DistributedCacheWithPersistence -NewPersistenceStore myCache_db -PersistenceStoreConnectionString "\\fileserver\stores;domain_name\user_name;password" -Topology Local -Size 1024

The following command creates a local cache with persistence named myCache using a persistence store named localCache_db already existing on the path \fileserver\stores. The topology is Local and the cache size is 1024MB.

Note

If you create a local 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.

New-Cache -Name myCache -InMemoryStoreType DistributedCacheWithPersistence -PersistenceStoreName localCache_db -PersistenceStoreConnectionString "\\fileserver\stores;domain_name\user_name;password" -Topology Local -Size 1024

See Also

Add Existing Cache
Create Clustered Cache
Remove Cache
Clear Cache