Remove Cache
A pre-existing, already registered cache can be simply removed using the NCache Management Center and Command Line Tools like PowerShell, etc., as detailed below.
Using Management Center
Launch the NCache Management Center by browsing to http://localhost:8251 or
<server-ip>:8251on Windows and Linux.In the left navigation bar, click on Local Caches or Clustered Caches based on the cache to be removed. This opens up a new page at
<server-ip>:8251/. The page shows any existing local or clustered caches and additional details like Server and Server Platform.In the caches window, check the box against the cache name to remove, and click Remove.
- You will be prompted to confirm if you want to unregister the cache as well. Clicking Yes will unregister the cache, clicking No will only remove the cache from the NCache Management Center view.
- In case the In-Memory Store Type of your cache is Distributed Cache with Persistence, you will also be prompted with the "Do you also want to delete persisted data of selected caches?" checkbox. Selecting this checkbox will also delete your persisted data along with your cache.
Using Command Line
The Remove Cache tool enables the user to remove an already registered cache and also remove cache(s) on a specified server.
This command removes the cache demoCache from the local server.
Remove-Cache –Name demoCache
The following command removes the cache demoCache along with its persisted data:
Note
In case your cache has persisted data and you don't specify the Force flag, you will be prompted with the message: "Do you want to remove the persisted data ('y' or 'n')?". Pressing y will remove the persisted data and vice versa.
Remove-Cache -Name demoCache -Force
This command removes the cache demoCache on the server node 20.200.20.40.
Remove-Cache –Name demoCache –Server 20.200.20.40
Manually Editing NCache Configuration
Warning
This is only recommended for OSS.
You can manually edit the config.ncconf and client.ncconf located at %NCHOME%\config through any text editor. %NCHOME% is the NCache install directory.
Step 1: Remove Cache Configuration from All Nodes
To remove an existing cache on a server, remove the entire configurations of that particular cache from config.ncconf of each server node (in case of a clustered cache) and the local server (in case of a local cache).
In the sample configuration below, the cache named demoCache is removed by updating the associated configurations of the <cache-config>. The cache-name in your configuration will be the name of your cache.
<cache-config cache-name="demoCache">
...
</cache-config>
Step 2: Restart NCache Service on All Nodes
For the configuration changes made to take effect, restart the NCache Service. Ensure you have enough privileges to restart the service. If the user is not in the Administrator's group, run PowerShell as administrator, or you might get an error message that "Cannot open NCacheSvc service on computer." Execute the following command in PowerShell to restart the NCache Service:
Restart-Service -Name NCacheSvc
Step 3: Remove cache from client.ncconf
Once the node is removed from config.ncconf, you need to update client.ncconf. In client.ncconf of each server node, remove the entire <cache> configuration associated to the cache.
<cache id="demoCache..."/>
...
</cache>
Please refer to the Remove Client from Cache section for more detail.
Step 4: Verify Successful Cache Removal on All Nodes
To verify the successful cache removal, use PowerShell to run the Get-Cachescommand to get the list of the registered caches on the server. Removal will be successful if the cache list displayed does not contain its name.
Get-Caches
