Stop Cache

Stopping an NCache distributed cache is a fundamental administrative task required for maintenance, configuration updates, or cluster scaling. Depending on the cache topology, stopping a cache may lead to data loss for volatile caches or trigger a state transfer if only a single node is stopped in a resilient cluster. NCache provides flexible methods to stop a cache across all server nodes simultaneously or target a specific node to maintain partial availability, accessible via the NCache Management Center or PowerShell.

Stop Cache On All Server Nodes

You can stop a clustered cache on all server nodes through the following steps:

  • Launch the NCache Management Center by browsing to http://localhost:9801 or <server-ip>:9801.

  • In the left navigation bar, click on Clustered Caches or Local Caches, based on the cache that needs to be stopped.

  • Check the box against the cache to stop.

  • Method 1: Click on the Stop Cache Button button on the toolbar to stop the cache.

Stop Cache

  • Method 2: Click on ... against the cache and select Stop.

Cache Stopped

  • The Status of the cluster will change from Running to Stopped and result in a success notification.

Stopping Cache On a Particular Server Node

You can stop a cache on a particular server node either through the NCache Management Center or PowerShell, as explained below:

Using the NCache Management Center

  • Launch the NCache Management Center by browsing to http://localhost:9801 or <server-ip>:9801.

  • In the left navigation bar, click on Clustered Caches or Local Caches, based on the cache server that needs to be stopped. Against the cache name, click on View Details.

Stop Cache Details

  • This opens the detailed configuration page for the cache.

  • Under the Server Nodes tab, check the box against the server node IP to stop.

  • Method 1: Click on the Stop Cache Button button on the toolbar to stop the server.

Stop Cache Button

  • Method 2: Click on "..." against the server IP and select Stop.

Cache Stopped

  • The Status of the server will change from Running to Stopped and result in a success notification.

Using PowerShell

The Stop-Cache tool enables users to stop the cache.

  • This command stops the defaultCache on local server.
Stop-Cache -Name defaultCache
  • This command stops the defaultCache on 20.200.20.12.
Stop-Cache -Name defaultCache -Server 20.200.20.12
  • This command stops the defaultCache on 20.200.20.12 gracefully.
Stop-Cache -Name defaultCache -Server 20.200.20.12 `
           -IsGracefulStop
  • This command stops the defaultCache on 20.200.20.12 for 30 minutes for maintenance.
Stop-Cache -Name defaultCache -Server 20.200.20.12 `
           -IsStopForMaintenance -Timeout 30
  • This command stops the defaultCache on the 20.200.20.12 and 20.200.20.11 servers.
Stop-Cache -Name defaultCache -Server "20.200.20.12,20.200.20.11"
  • This command stops defaultCache on the specified server with mutual TLS (mTLS) enabled. It runs from a machine where NCache is not installed and uses C:\certs\client.pem to authenticate the machine running the cmdlet. The -TlsCertPassword parameter decrypts the certificate’s password-protected private key. Omit this parameter if the private key is not encrypted.
Stop-Cache -Name defaultCache -Server 20.200.20.11 `
           -TlsCertPath "C:\certs\client.pem" -TlsCertPassword "clientKeyPassword"
  • This command stops the defaultCache on local server using security credentials.
Stop-Cache -Name defaultCache -Credentials(Get-Credential john_smith)

See Also

Start Cache
Restart Cache
Manage Services