Checks the statuses of File Server machines
Synopsis
cm statservers [{-cell cellname | -all}] [-fast] [-help]
Options
-cell cellname
Specifies the name of the specific cell the Cache Manager is to probe for the status of each File Server machine it has contacted or has attempted to
contact from that cell. The Cache Manager probes only machines in the specified cell. Use this option or use the -all option; omit both options to direct the Cache Manager to probe only
machines in the local cell.
-all
Directs the Cache Manager to probe all of the machines it has contacted in all cells. Use this option or use the -cell option; omit both options to direct the
Cache Manager to probe only machines in the local cell.
-fast
Directs the Cache Manager to display its current list of contacted File Server machines without probing the machines. This option can be combined with the -cell
or -all option; it can also be used if both the -cell and -all options are omitted.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The cm statservers command lists all File Server machines in the indicated cells that meet the following two conditions:
· The Cache Manager has been in contact with the File Exporter running on the machine and needs to contact it in the future (probably because the Cache Manager is holding tokens for data on that File Server machine).
· The File Exporter on the machine is not currently responding to the Cache Manager's probes (implying that it is not responding to the Cache Manager's requests for data either).
The Cache Manager maintains a list of File Server machines that meet the first condition, updating the list periodically by attempting to contact the File Exporter on each machine in the list. When a machine does not respond to a probe, the Cache Manager marks it as nonfunctioning. If a machine that previously did not respond begins to respond again, the Cache Manager erases the mark. The Cache Manager maintains this information in the kernel of the local machine.
Without the -fast option, this command forces the Cache Manager to update its information immediately (rather than waiting the standard interval). The Cache Manager probes the File Exporters on the machines in the specified cells, records those that do not respond, and reports the results. If you include the -fast option, the Cache Manager displays the list of nonfunctioning machines that it has at the time the command is issued; it does not probe the machines again.
By default, the Cache Manager probes machines in the local cell only. If the -all option is used, the Cache Manager probes all machines (from all cells) that meet the first condition. If a cellname is specified with the -cell option, the Cache Manager probes only the machines in that cell.
The execution of this command can be lengthy if a number of machines in the Cache Manager's list are unresponsive when the command is issued. The Cache Manager waits a standard time-out period before concluding that a File Exporter is not responding; this allows for the possibility of slow cross-network communication. If it is important that the command shell prompt return quickly, run this command in the background. It is harmless to interrupt the command (with <Ctrl-c> or another interrupt signal).
This command does not check the statuses of all File Server machines in a cell. The Cache Manager probes only those machines that meet the first condition in the previous list.
Privilege Required
No privileges are required.
Output
If the Cache Manager gets a response from all of the machines that it probes (that is, all such machines are functioning normally), the command displays the following
output:
All servers are running.
This message does not imply that all File Server machines in the specified cells are running; it implies only that those machines that the Cache Manager probed are running.
If one or more machines fail to respond to the Cache Manager's probes within the time-out period, the command displays the following output:
These servers are still down: hostname
where hostname is the name of each File Server machine that fails to respond.
In a multihomed server environment (a File Server machine can have four IP addresses listed in the Cache Managers preferences), the hostname corresponds to the host name or IP address that the Cache Manager is currently using to access each File Server machine. The output does not contain multiple machine names for the same File Server machine.
Examples
The following command uses the -fast option to view the Cache Manager's current list of unresponsive machines belonging to the local cell rather than waiting
for the Cache Manager to probe them again. The output indicates that all machines responded to the most recent probes.
$ cm statservers -f
All servers are running.
The following command checks all File Server machines from which the Cache Manager has cached data, regardless of the cell in which a machine resides. The command reports that the machines named fs1.abc.com and fs3.state.edu did not respond to the Cache Manager's probes. The & (ampersand) is used to execute the command in the background.
$ cm statservers -all &
These servers are still down: fs1.abc.com fs3.state.edu
Related Information
Commands: cm lsstores(8dfs)