fs_checkservers - Displays the status of server machines
fs checkservers [-cell <cell to check>] [-all] [-fast] [-interval <seconds between probes>] [-config <config path>] [-help]
The fs checkservers command reports whether file servers and location servers contacted by the Cache Manager since the last restart are still accessible from the local machine.
All database servers for every cell accessed by the Cache Manager since the last restart.
All file servers the Cache Manager has contacted since the last restart.
If the Cache Manager is unable to contact the location server or the file server, it marks the machine as inaccessible (aka down). If a file server is multihomed (is assigned multiple network addresses), the Cache Manager attempts to contact all of the server's addresses and only marks the machine as inaccessible if the file server fails to reply.
The Cache Manager periodically sends a probe to each accessed server to check if it is reachable. Servers that are marked inaccessible are probed every three minutes (by default) and those that are marked accessible are probed every ten minutes.
The fs checkservers command instructs the Cache Manager to immediately send probes to the specified list of inaccessible servers:
By default, only servers that belong to the workstation cell, the cell reported by fs wscell.
If the -cell argument is included, only servers that belong to the specified cell.
If the -all flag is included, all servers that have been previously accessed by the Cache Manager.
If the -fast flag is included, the Cache Manager does not probe any servers, but instead reports the current list of inaccessible servers.
To set the interval (in seconds) between inaccessible server probes use the -interval argument. The new setting persists until the Cache Manager is restarted. Upon completion the new and previous probe interval will be reported.
The command can take quite a while to complete if a number of servers do not respond to the Cache Manager's probe. The Cache Manager probes servers concurrently but waits 50 seconds for a response before marking the servers inaccessible. To make the command shell prompt return quickly, put the command in the background. It is harmless to interrupt the command by typing Ctrl-C or another interrupt signal.
Note that the Cache Manager probes only servers that it has contacted since the last restart. A server's absence from the output does not indicate that it is reachable unless it is known that the server has been contacted.
Names each cell in which to probe servers marked as inaccessible. Provide the full cell name or a shortened form that disambiguates it from other cells listed in the local configuration file, /etc/yfs/yfs-client.conf. Combine this argument with the -fast flag if desired, but not with the -all flag. Omit both this argument and the -all flag to only probe machines in the workstation cell.
Probes all servers known to the Cache Manager that are marked inaccessible. Combine this argument with the -fast flag if desired, but not with the -cell argument. Omit both this flag and the -cell argument to only probe machines in the workstation cell.
Displays the current list of inaccessible servers instead of sending new probes.
Sets or reports the number of seconds between the Cache Manager's probes to servers that are marked inaccessible:
To set the interval,
specify a value from the range between 1 and
600 seconds (10 minutes); the default is
180 seconds (three minutes).
The issuer must be logged in as the local superuser
The altered setting persists until again changed with this command,
or until the machine reboots,
at which time the setting returns to the default.
Provide a value of
0 (zero) to display the current interval setting.
No privilege is required.
Do not combine this argument with any other.
The location of the configuration file to be used. The default file is /etc/yfs/yfs-client.conf.
Prints the online help for this command. All other valid options are ignored.
If there are no servers marked as inaccessible when the command completes, the output is:
All servers are running.
Note that this message does not mean that all server machines in each relevant cell are reachable. The output indicates the status of only those servers that the Cache Manager probes.
If a server fails to respond to the probe within the timeout period, the output begins with the string
These servers unavailable due to network or server problems:
and lists the hostname of each machine on its own line. The Cache Manager stores machine records by Internet address, so the format of each hostname (uppercase or lowercase letters, or an Internet address in dotted decimal format) depends on how the domain name service translates it at the time the command is issued. If a server machine is multihomed, the output lists only one of its assigned addresses.
If the -interval argument is provided with a value between
600 seconds, the output reports the new and prior probe interval as follows:
The new down server probe interval (<interval> secs) is now in effect (old interval was <interval> secs)
If the value is
0, the output reports the probe interval as follows:
The current down server probe interval is <interval> secs
The following command displays the Cache Manager's current list of inaccessible servers in the workstation cell, rather than probing them again. The output indicates that as of the most recent probe all known servers were reachable.
% fs checkservers -fast All servers are running.
The following example probes servers known to the Cache Manager that are part of the
% fs checkservers -cell your-cell-name.com All servers are running.
The following example probes all servers known to the Cache Manager. It reports that two machines did not respond to the probe.
% fs checkservers -all These servers unavailable due to network or server problems: fs1.your-cell-name.com fs2.foreign-cell-name.com
To set the probe interval, the issuer must be logged in as the local superuser
root. Otherwise, no privilege is required.
IBM Corporation 2000. http://www.ibm.com/ All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.