doc/html/AdminReference/auarf145.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf144.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf146.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRFS_GETCLIENTADDRS" HREF="auarf002.htm#ToC_159">fs getclientaddrs</A></H2>
  19 <A NAME="IDX4839"></A>
  20 <A NAME="IDX4840"></A>
  21 <A NAME="IDX4841"></A>
  22 <A NAME="IDX4842"></A>
  23 <A NAME="IDX4843"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Displays the client interfaces to register with the File Server
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>fs getclientaddrs</B> [<B>-help</B>]
  28
  29 <B>fs gc</B> [<B>-h</B>]
  30
  31 <B>fs getcl </B>[<B>-h</B>]
  32 </PRE>
  33 <P><STRONG>Description</STRONG>
  34 <P>The <B>fs getclientaddrs</B> command displays the IP addresses of the
  35 interfaces that the local Cache Manager registers with a File Server when
  36 first establishing a connection to it.
  37 <P>The File Server uses the addresses when it initiates a remote procedure
  38 call (RPC) to the Cache Manager (as opposed to responding to an RPC sent by
  39 the Cache Manager). There are two common circumstances in which the
  40 File Server initiates RPCs: when it breaks callbacks and when it pings
  41 the client machine to verify that the Cache Manager is still
  42 accessible.
  43 <P>If an RPC to that interface fails, the File Server simultaneously sends
  44 RPCs to all of the other interfaces in the list, to learn which of them are
  45 still available. Whichever interface replies first is the one to which
  46 the File Server then sends pings and RPCs to break callbacks.
  47 <P>The <B>fs setclientaddrs</B> reference page explains how the Cache
  48 Manager constructs the list automatically in kernel memory as it initializes,
  49 and how to use that command to alter the kernel list after
  50 initialization.
  51 <P><STRONG>Cautions</STRONG>
  52 <P>The File Server uses the list of interfaces displayed by this command only
  53 when selecting an alternative interface after a failed attempt to break a
  54 callback or ping the Cache Manager. When responding to the Cache
  55 Manager's request for file system data, the File Server replies to the
  56 interface which the Cache Manager used when sending the request. If the
  57 File Server's reply to a data request fails, the file server
  58 machine's network routing configuration determines which alternate
  59 network routes to the client machine are available for resending the
  60 reply.
  61 <P>The displayed list applies to all File Servers to which the Cache Manager
  62 connects in the future. It is not practical to register different sets
  63 of addresses with different File Servers, because it requires using the
  64 <B>fs setclientaddrs</B> command to change the list and then rebooting
  65 each relevant File Server immediately.
  66 <P>The displayed list is not necessarily governing the behavior of a given
  67 File Server, if an administrator has issued the <B>fs setclientaddrs</B>
  68 command since the Cache Manager first contacted that File Server. It
  69 determines only which addresses the Cache Manager registers when connecting to
  70 File Servers in the future.
  71 <P>The list of interfaces does not influence the Cache Manager's choice
  72 of interface when establishing a connection to a File Server.
  73 <P><STRONG>Options</STRONG>
  74 <DL>
  75 <P><DT><B>-help
  76 </B><DD>Prints the online help for this command. All other valid options
  77 are ignored.
  78 </DL>
  79 <P><STRONG>Output</STRONG>
  80 <P>The output displays the IP address of each interface that the Cache Manager
  81 is currently registering with File Server processes that it contacts, with one
  82 address per line. The File Server initially uses the first address for
  83 breaking callbacks and pinging the Cache Manager, but the ordering of the
  84 other interfaces is not meaningful.
  85 <P><STRONG>Examples</STRONG>
  86 <P>The following example displays the two interfaces that the Cache Manager is
  87 registering with File Servers.
  88 <PRE>   % <B>fs getclientaddrs</B>
  89    192.12.105.68
  90    192.12.108.84
  91
  92 </PRE>
  93 <P><STRONG>Privilege Required</STRONG>
  94 <P>None
  95 <P><STRONG>Related Information</STRONG>
  96 <P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
  97 <P><A HREF="auarf160.htm#HDRFS_SETCLIENTADDRS">fs setclientaddrs</A>
  98 <P>
  99 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf144.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf146.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 100 <!-- Begin Footer Records  ========================================== -->
 101 <P><HR><B>
 102 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 103 </B>
 104 <!-- End Footer Records  ============================================ -->
 105 <A NAME="Bot_Of_Page"></A>
 106 </BODY></HTML>