Create Pub/Sub Messaging Cache

This section will demonstrate how you can create a Pub/Sub Messaging cache through the NCache Management Center and Command Line Interface.

Using the NCache Management Center in Pub/Sub Messaging Cache

  • 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 at <server-ip>:8251/ClusteredCaches.

  • To create a new Pub/Sub Messaging cache, click on New.

Create Pub/Sub Messaging Cache Web

  • The In-Memory Store screen appears. From the In-Memory Store Type dropdown menu, select Pub/Sub Messaging and specify the name of your cache. Select JSON or Binary from the Serialization dropdown menu as per your requirement. Click Next.
Note

It is recommended that you use JSON serialization if you are using ASP.NET 5.0 and above. For more details click here.

Create Pub/Sub Messaging Cache Web

  • Select the caching topology and any advanced options like Operation timeout and Statistic replication interval. If you have selected the Partition-Replica Cache topology, you have to select a Replication Strategy, either Asynchronous or Synchronous. Click Next.

Select Caching Topology Web

  • Specify the Cache Partition Size of the cache and add your cluster nodes by specifying the Server Node IP or Namw of the machine and clicking on the Add Node button. To add more nodes, click Add Node. Click Next once all the required nodes are added.
Warning

If the cache is already registered on that node, notification is prompted.

Cache Size Pub/Sub Cache Web

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

Select Port Range Web

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

Select Encryption and Compression 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 select the Start this cache on finish checkbox on this dialog box.
    • You can make the cache start automatically after service restart by selecting the checkbox Auto start this cache on service startup.

Advanced Options PubSub

  • Click Finish. The created cache will appear on the Clustered Caches page with the server nodes and their status. A success notification will be received in the notification panel.

Clustered Caches List Web

Using Command Line Interface

You can use PowerShell to manage Pub/Sub Messaging caches by using the NCache supported Command Line Interface.

Create Cache

The New-Cache cmdlet enables the user to create a new cache on one or more server nodes.

This command creates a Pub/Sub Messaging cache named demoPubSubCache of Partition-Replica topology of size 1024MB on server nodes 20.200.20.40 and 20.200.20.39.

New-Cache -Name demoPubSubCache -InMemoryStoreType PubSubMessaging -Server "20.200.20.40,20.200.20.39" -Size 1024 -Topology PartitionReplica

Start Cache

Once the cache is created, you need to start a clustered cache on all the server nodes so that operations can be performed on it. The Start-Cache cmdlet enables the user to start the registered cache and cache process on the nodes.

Perform this step on all server nodes to start the previously created demoPubSubCache.

Start-Cache -Name demoPubSubCache

See Also

Add Local/Remote Clients
Monitor Caches
NCache Programmer's Guide
NCache Command Line Interface Guide