How to Take Down a Cache Server for Maintenance
Assumption: You have multiple caches running in your environment on multiple cache servers. These steps should be followed on each cache server in your environment that you want to take down for maintenance.
Stopping All Caches:
-
Stop one of the caches on your cache server
- Using NCache Manager: Right-click on IP-address of the node in NCache Manager shown under "Server Nodes" for a cache and then choose Stop
OR
- Using Command line tool: Run stopcache command line tool on the cache server (locally) as follows
C:\Program Files\NCache\bin\tools>stopcache CacheName
-
Remove this node from cache
State transfer process starts as soon as a cache node leaves or joins a cache cluster. You should wait at least 30 seconds or so for its completion and then move on to next cache.
-
Wait for state transfer process to complete:
- Using NCache Manager: Right click on IP address of the node in NCache Manager under your cache name and choose Remove
OR
- Using Command line tool: Run removeNode command line tool on the cache server (locally) as follows
C:\Program Files\NCache\bin\tools>removenode.exe CacheName
- Follow Steps 1 to 3 above for stopping all caches on this cache server one by one
- This server will be ready for maintenance once all caches are stopped.
Performing Maintenance on Downed Cache Server:
- Stop NCache Services on Downed Cache Server
- (NCache installs two windows services NCache and NCache Bridge service on a cache server box. It is required that both NCache services are stopped on this node.)
- Perform maintenance on this cache server as needed.
- Reboot this cache server after maintenance.
- Start both NCache and NCache Bridge services on this node.
Starting back all Caches:
-
Add this node back to one of your caches
- Using NCache Manager: Right click on Server Nodes (under your cache name in NCache Manager) and then choose Add Node. This will open another window where you can provide IP address/Machine name of this node to add it back to your cache cluster.
OR
-
Start the cache on your cache server
-
Using NCache Manager: Right click on IP address of the Server node in NCache Manager under your cache name and choose Start. This will start the cache on this node and would join it back to cache cluster.
OR
-
Wait for 30 seconds for state transfer to complete
-
You should wait at least 30 seconds for completion of state transfer process and thenmove on to next cache.
-
Verify cache cluster connectivity
-
Right click on your cache name in NCache Manager and then choose View cluster connectivity option. Make sure that cluster shows Fully Connected status
.
-
Follow Steps 3 to 4 above for starting all caches one by one on your cache server
What to Do Next?