fs setcl [-a <client network interfaces>+] [-h]
fs sc [-a <client network interfaces>+] [-h]
The File Server uses the addresses when it initiates a remote procedure call (RPC) to the Cache Manager (as opposed to responding to an RPC sent by the Cache Manager). There are two common circumstances in which the File Server initiates RPCs: when it breaks callbacks and when it pings the client machine to verify that the Cache Manager is still accessible.
The list of interfaces specified with this command replaces the list that the Cache Manager constructs and records in kernel memory as it initializes. At that time, if the file /etc/openafs/NetInfo exists on the client machine's local disk, the Cache Manager uses its contents as the basis for the list of interfaces addresses. If the file does not exist, the Cache Manager instead uses the network interfaces configured with the operating system. It then removes from the list any address included in the local /etc/openafs/NetRestrict file. It records the final list in kernel memory. (An administrator must create the NetInfo and NetRestrict files; there are no default versions of them.)
If an RPC to that interface fails, the File Server simultaneously sends RPCs to all of the other interfaces in the list, to learn which of them are still available. Whichever interface replies first is the one to which the File Server then sends pings and RPCs to break callbacks.
To list the interfaces that the Cache Manager is currently registering with File Servers, use the fs getclientaddrs command.
Changes made with this command do not propagate automatically to File Servers to which the Cache Manager has already established a connection. To force such File Servers to use the revised list, either reboot each file server machine, or change the NetInfo file and reboot the client machine.
The fs command interpreter verifies that each of the addresses specified as a value for the -address argument is actually configured with the operating system on the client machine. If it is not, the command fails with an error message that marks the address as a "Nonexistent interface".
confirms that each new interface was added to the Cache Manager's list. The address appears in hexadecimal format to match the notation used in the File Server log, /var/log/openafs/FileLog.
% fs setclientaddrs 220.127.116.11 18.104.22.168 Adding 0xbfff6944 Adding 0xbfff6c54
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.