doc/man-pages/pod5/NetInfo.pod

   1 =head1 NAME
   2
   3 NetInfo - Defines machine interfaces to register with AFS servers
   4
   5 =head1 DESCRIPTION
   6
   7 There are two F<NetInfo> files, one for an AFS client and one for an AFS
   8 File Server or database server.  The AFS client F<NetInfo> file specifies
   9 the IP addresses that the client should register with the File Servers it
  10 connects to.  The server F<NetInfo> file specifies what interfaces should
  11 be registered with AFS Database Servers or used to talk to other database
  12 servers.
  13
  14 =head2 Client NetInfo
  15
  16 The client F<NetInfo> file lists the IP addresses of one or more of the
  17 local machine's network interfaces. If it exists in the F</usr/vice/etc>
  18 directory when the Cache Manager initializes, the Cache Manager uses its
  19 contents as the basis for a list of local interfaces. Otherwise, the Cache
  20 Manager uses the list of interfaces configured with the operating
  21 system. It then removes from the list any addresses that appear in the
  22 F</usr/vice/etc/NetRestrict> file, if it exists. The Cache Manager records
  23 the resulting list in kernel memory. The first time it establishes a
  24 connection to a File Server, it registers the list with the File Server.
  25
  26 The File Server uses the addresses when it initiates a remote procedure
  27 call (RPC) to the Cache Manager (as opposed to responding to an RPC sent
  28 by the Cache Manager). There are two common circumstances in which the
  29 File Server initiates RPCs: when it breaks callbacks and when it pings the
  30 client machine to verify that the Cache Manager is still accessible.
  31
  32 The F<NetInfo> file is in ASCII format. One of the machine's IP addresses
  33 appears on each line, in dotted decimal format. The File Server initially
  34 uses the address that appears first in the list. The order of the
  35 remaining addresses is not significant: if an RPC to the first interface
  36 fails, the File Server simultaneously sends RPCs to all of the other
  37 interfaces in the list.  Whichever interface replies first is the one to
  38 which the File Server then sends pings and RPCs to break callbacks.
  39
  40 To prohibit the Cache Manager absolutely from using one or more addresses,
  41 list them in the F<NetRestrict> file. To display the addresses the Cache
  42 Manager is currently registering with File Servers, use the B<fs
  43 getclientaddrs> command. To replace the current list of interfaces with a
  44 new one between reboots of the client machine, use the B<fs
  45 setclientaddrs> command.
  46
  47 =head2 Server NetInfo
  48
  49 The server F<NetInfo> file, if present in the F</usr/afs/local> directory,
  50 defines the following:
  51
  52 =over 4
  53
  54 =item *
  55
  56 On a file server machine, the local interfaces that the File Server
  57 (B<fileserver> process) can register in the Volume Location Database
  58 (VLDB) at initialization time.
  59
  60 =item *
  61
  62 On a database server machine, the local interfaces that the Ubik database
  63 synchronization library uses when communicating with the database server
  64 processes running on other database server machines.
  65
  66 =back
  67
  68 If the F<NetInfo> file exists when the File Server initializes, the File
  69 Server uses its contents as the basis for a list of interfaces to register
  70 in the VLDB. Otherwise, it uses the list of network interfaces configured
  71 with the operating system. It then removes from the list any addresses
  72 that appear in the F</usr/afs/local/NetRestrict> file, if it exists. The
  73 File Server records the resulting list in the F</usr/afs/local/sysid> file
  74 and registers the interfaces in the VLDB. The database server processes
  75 use a similar procedure when initializing, to determine which interfaces
  76 to use for communication with the peer processes on other database
  77 machines in the cell.
  78
  79 The F<NetInfo> file is in ASCII format. One of the machine's IP addresses
  80 appears on each line, in dotted decimal format. The order of the addresses
  81 is not significant.
  82
  83 Optionally, the File Server can be forced to use an IP address that does
  84 not belong to one of the server interfaces. To do this, add a line to the
  85 F<NetInfo> file with the IP address prefixed with "f" and a space. This is
  86 useful when the File Server is on the internal side of a NAT firewall.
  87
  88 To display the File Server interface addresses registered in the VLDB, use
  89 the B<vos listaddrs> command.
  90
  91 =head1 EXAMPLES
  92
  93 If the File Server is on the internal side of a NAT firewall, where it
  94 serves internal clients using the IP address 192.168.1.123 and external
  95 clients using the IP address 10.1.1.321, then the F<NetInfo> file should
  96 contain the following:
  97
  98    192.168.1.123
  99    f 10.1.1.321
 100
 101 =head1 SEE ALSO
 102
 103 L<NetRestrict(5)>,
 104 L<sysid(5)>,
 105 L<vldb.DB0(5)>,
 106 L<fileserver(8)>,
 107 L<fs_getclientaddrs(1)>,
 108 L<fs_setclientaddrs(1)>,
 109 L<vos_listaddrs(1)>
 110
 111 =head1 COPYRIGHT
 112
 113 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
 114
 115 This documentation is covered by the IBM Public License Version 1.0.  It was
 116 converted from HTML to POD by software written by Chas Williams and Russ
 117 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.