doc/man-pages/pod1/vos_setaddrs.pod.in

   1 =head1 NAME
   2
   3 vos_setaddrs - Set new addresses for a file server's entry in the VLDB
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<vos setaddrs> S<<< B<-uuid> <I<UUID of server>> >>>
  11     S<<< B<-host> <I<IP address>>+ >>>
  12     S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
  13     [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
  14     S<<< [B<-config> <I<config directory>>] >>>
  15     [B<-help>]
  16
  17 B<vos seta> S<<< B<-u> <I<UUID of server>> >>>
  18     S<<< B<-ho> <I<IP address>>+ >>>
  19     S<<< [B<-c> <I<cell name>>] >>>
  20     [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>]
  21     S<<< [B<-co> <I<config directory>>] >>>
  22     [B<-h>]
  23
  24 =for html
  25 </div>
  26
  27 =head1 DESCRIPTION
  28
  29 The B<vos setaddrs> command sets the IP addresses for a server entry in
  30 the Volume Location Database (VLDB). Specify one or several IP addresses.
  31 All existing addresses in the VLDB server entry are replaced with the new
  32 addresses given on the command line.
  33
  34 To find the UUID for a server entry, use the C<vos listaddrs -printuuid>
  35 command to display all VLDB server entries with their UUIDs.
  36
  37 =head1 CAUTIONS
  38
  39 Normally, the best way to change the registered addresses for a server
  40 entry is to restart the File Server process after changing the network
  41 configuration for that server and possibly the F<NetInfo> and
  42 F<NetRestrict> files for that server.  See L<NetInfo(5)> and
  43 L<NetRestrict(5)> for more information about configuring the File Server
  44 to register the correct set of addresses.  This command can be used to
  45 change the registered addresses without restarting the File Server, but
  46 the next time the File Server is restarted, it will register all of its
  47 known addresses again.  You should therefore always ensure that the File
  48 Server configuration is correct for whenever it is next restarted before
  49 using this command.
  50
  51 Setting the wrong addresses will make the volumes on that file server
  52 unreachable from AFS clients.
  53
  54 This command was introduced in OpenAFS 1.5.74, but can be used with any
  55 version of the Volume Location Server.
  56
  57 =head1 OPTIONS
  58
  59 =over 4
  60
  61 =item B<-uuid> <I<UUID of server>>
  62
  63 The unique ID as provided by the C<vos listaddrs -printuuid> command.
  64
  65 =item B<-host> <I<IP address>>+
  66
  67 The new list of IP addresses for the File Server.
  68
  69 =include fragments/vos-common.pod
  70
  71 =back
  72
  73 =head1 EXAMPLES
  74
  75 The following command sets addresses C<192.12.107.214> and C<10.47.11.17>
  76 for the UUID 008f157e-bad0-157c-0ffee-357c4d1faa77
  77
  78    % vos setaddrs -uuid 008f157e-bad0-157c-0ffee-357c4d1faa77 \
  79        -host 192.12.107.214 -host 10.47.11.17 -verbose
  80    vos: Changed UUID with addresses:
  81    UUID: 008f157e-bad0-157c-0ffee-357c4d1faa77
  82    192.12.107.214
  83    10.47.11.17
  84
  85 =head1 PRIVILEGE REQUIRED
  86
  87 Issuer must be listed in the F</usr/afs/etc/UserList> file on each
  88 database server machine.
  89
  90 =head1 SEE ALSO
  91
  92 L<CellServDB(5)>,
  93 L<NetInfo(5)>,
  94 L<NetRestrict(5)>,
  95 L<UserList(5)>,
  96 L<sysid(5)>,
  97 L<fileserver(8)>,
  98 L<vos(1)>,
  99 L<vos_listaddrs(1)>
 100
 101 =head1 COPYRIGHT
 102
 103 KTH 2010. All Rights Reserved.
 104
 105 This documentation is covered by the IBM Public License Version 1.0.