This is the README for setcells. FIRST: THIS PROGRAM IS ENTIRELY UNSUPPORTED SOFTWARE. USE IT AT YOUR OWN RISK. IF IT BLOWS UP YOUR SYSTEM, CAUSES YOU TO LOSE DATA, UPTIME, OR OTHER BAD THINGS HAPPEN, NO ONE IS AT FAULT BUT YOURSELF! (I don't think any of these things will happen to you, but I don't want to face a lawsuit as thanks for my giving this program away free to the AFS user community.) ** See file `COPYING' for information about copying this program. ** See file `INSTALL' for general installation directions. What is it? ----------- setcells is a program for people running AFS. It can assist in keeping your cache managers synced up with your (or Transarcs!) master CellServDB file, without needing to reboot the affected client. This is important when you have AFS clients that need to have 99.9% uptime, or when you have very many (100-10000 or more!) AFS clients at your site. Both of these are the case at the site this program was developed for. This program is supposed to be portable -- we have four different AFS architectures at our site, ignoring the minor differences between sun4m and sun4c, etc. I have tested this program on AFS 3.4a clients running SunOS 4.1.3; Solaris 2.3, 2.4, 2.5, 2.5.1; HP-UX 9.03, 9.05, 9.07; and IRIX 5.3. Don't try to run this program if you aren't running AFS -- it will core dump, or worse. It tries to access kernel services that are only available on machines running AFS. Machines that get access to AFS via an NFS translator shouldn't need to run this program, but the translator will. Distribution ------------ Note that I've not used or had access to an AFS cell for quite a while, so setcells is no longer actively maintained. However the latest version of setcells is from the setcells home page located at http://www.damore.org/~garrett/software/setcells/ setcells is distributed under the terms of the GPL, see the `COPYING' file for licensing details. Installation ------------ There are instructions for installation in the INSTALL file. This just uses a GNU autoconf-generated configure script. If you have AFS header files and libraries installed somewhere other than /usr/afsws, you may want to run configure with the option --with-afsws=. Support (or lack thereof) ------------------------- I no longer have access to an AFS cell, so you're pretty much on your own here. However, if you have a problem, drop me an e-mail and maybe I'll be able to help anyway. Packaging --------- I've built in (rudimentary) support for native packaging for Solaris (pkgadd), and HP-UX 10.x (swinstall). It is conceivable that you can use this to distribute and install binaries of this utility. To try out the packaging, just do "make package" after compiling. We use this to install the software on local disk as part of a Solaris JumpStart, but it may have other uses as well. YMMV. -- Garrett D'Amore