Cancels attempts by the Cache Manager to contact unavailable File Server machines and discards all data the Cache Manager cannot store to such machines
Synopsis
cm resetstores [-help]
Options
-help
Prints the online help for this command.
Description
The cm resetstores command cancels the Cache Manager's continued attempts to contact unavailable File Server machines. All data the Cache Manager
cannot store to such File Server machines is discarded; there is no way to selectively discard individual files or data from specific filesets.
Occasionally, a File Server machine may be unavailable to the Cache Manager (possibly because the File Server machine is down or because a network problem prevents the Cache Manager from contacting the machine). In such cases, the Cache Manager cannot write data back to the File Server machine. The Cache Manager displays a message on the screen to notify the user that it cannot write the data to the unavailable machine. If possible, it also returns a failure code to the application program using the data.
The Cache Manager keeps the unstored data in the cache and continues to attempt to contact the File Server machine until it can store the data. (The frequency with which it attempts to reach a File Server machine is defined with the -pollinterval option of the fxd command issued on that File Server machine.) In the meantime, corrective measures can be taken to alleviate the problem that prevents the data from being stored; for example, the File Server machine can be restarted. Once the problem is alleviated, the Cache Manager can reach the File Server machine and store the data.
The Cache Manager discards unstored data only when
· It needs to make room in the cache for other data. Given an average-sized cache with average usage, the Cache Manager rarely needs to discard unstored data.
· The cm resetstores command is issued to force it to discard unstored data from the cache.
Because unstored data discarded from the cache cannot be recovered, any problem that prevents data from being written to a File Server machine should be handled promptly.
Note that the cm resetstores command affects only data that could not be stored to a File Server machine; it does not affect other data in the cache. Nonetheless, be cautious when issuing the cm resetstores command: Issue the cm lsstores command first to list the fileset ID numbers of filesets that contain data the Cache Manager cannot write to a File Server machine; examine the output of the command to be sure that you know from which filesets unstored data will be discarded (you may also be able to use this information to ensure that unstored data from the indicated filesets can safely be discarded).
Privilege Required
The issuer must be logged in as root on the local machine.
Related Information
Commands: cm lsstores(8dfs)