[3053] in SIPB-AFS-requests
Re: Proceeding with new-rosebud
daemon@ATHENA.MIT.EDU (John Hawkinson)
Mon Jul 13 11:11:22 1998
To: Greg Hudson <ghudson@MIT.EDU>
Cc: sipb-afsreq@MIT.EDU
In-Reply-To: Your message of "Fri, 10 Jul 1998 12:15:22 EDT."
<199807101615.MAA03052@small-gods.mit.edu>
Date: Mon, 13 Jul 1998 11:11:02 EDT
From: John Hawkinson <jhawk@MIT.EDU>
| >> Note that 'vos changeaddr' is obsolete under 3.4a and that changing
| >> addresses of servers is supposedly pretty easy.
| >
| >Do you know how it works?
Not especially. Apparently afs 3.3 added supprt in the vlserver for
allowing clients to change their addresses. AFS 3.4 made this automatic.
The AFS 3.4a release notes say:
// AFS 3.4a makes the vos changeaddr command obsolete. File server
// machine addresses are registered automatically with the VL Server each
// time the File Server restarts.
It was suggested by jweiss that it was necessary to rm a file
prior to starting the fileservers to make this function. While this
sounded vaguely familiar at the time, I can't find any documentation
of it now, and a cursory glance at source didn't yield anything.
Here's the section on 'vos changeaddr' from the 3.4a relnotes,
which are left in there from the 3.3 relnotes.
// The vos Commands 12.8. The vos changeaddr Command
//
// AFS 3.3 Changes The vos changeaddr command changes a file server's IP
// address. Changing the IP address of a file server was a difficult task
// in earlier versions of AFS. After changing the IP address, you had to
// run the vos syncserv and vos syncvldb commands. Then you had to issue
// the vos remsite command to remove site information associated with the
// ReadOnly volumes under the old IP address. A new vos command, vos
// changeaddr, allows you to change a simple file server's IP address
// easily.
//
// Note: If you are using AFS 3.4a VL servers, the vos changeaddr command
// has no
//
// effect on file server addresses. AFS 3.4a VL servers automatically
// register the IP addresses of file server machines upon restarting the
// fileserver process.
//
// The syntax of the new command follows:
//
// vos changeaddr -oldaddr <original IP address> -newaddr <new IP
// address> [-cell <cell name>] [-noauth] [-localauth] [-verbose] [-help]
//
// Arguments:
//
// -oldaddr Specifies the old IP address of the file server whose IP
// address you are changing. -newaddr Specifies the new IP address of the
// file server. -cell Specifies the cell in which to run the command; the
// default is the local cell. Do
//
// not use this flag with the -localauth flag; the -cell argument and the
// -localauth flag are mutually exclusive.
//
// -noauth Tells the Volume Location (VL) servers to assign the identity
// system:anyuser
//
// to the issuer.
//
// -localauth Constructs a server ticket using a key from the
// /usr/afs/etc/KeyFile file. Do
//
// not use this flag with the -cell argument; the -cell argument and the
// -localauth flag are mutually exclusive.
//
// -verbose Tells the Volume and VL servers to report on what they are
// doing as they
//
// execute the command.
//
// The vos Commands -help Prints the online help for this command. All
// other valid options specified with
//
// this option are ignored.
//
// Note: This command does not change IP addresses contained in any
// protection groups
//
// that you have defined with the pts creategroup command. Use the pts
// rename command to change IP addresses in existing groups.
//
// Changing the IP address of a Ubik database server involves additional
// changes. Refer to the AFS System Administrator's Guide for more
// information.
//
// Examples: The following command changes the IP address of a simple
// file server from 128.21.16.214 to 128.21.16.221:
//
// % vos changeaddr -oldaddr 128.21.16.214 -newaddr 128.21.16.221
// -localauth
--jhawk