From: Russ Allbery <rra@debian.org>
Date: Thu, 9 Feb 2006 04:51:23 +0000 (+0000)
Subject:   * Document the need to restart ptserver and vlserver on the existing
X-Git-Tag: debian/1.4.0-4~3
X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=e8438cd2297244dc0785f94827efdc528bcde588;p=packages%2Fo%2Fopenafs.git

  * Document the need to restart ptserver and vlserver on the existing
    database servers when adding a new one.  Thanks, Niklas Edmundsson.
    (Closes: #349659)
---

diff --git a/debian/README.servers b/debian/README.servers
index 4cdd12c1f..d323215af 100644
--- a/debian/README.servers
+++ b/debian/README.servers
@@ -329,7 +329,19 @@ Adding Additional Servers
           bos addhost <server> <new-server>
 
       for each db server <server> in your cell (including the new one).
-      Then, create ptserver and vlserver instances on the new server:
+      Then, restart the ptserver and vlserver instances on each of your
+      existing servers with:
+
+          bos restart <server> ptserver
+          bos restart <server> vlserver
+
+      It's best to wait a few seconds after doing this for each server
+      before doing the next server so that voting finishes and you never
+      lose a quorum.
+
+      Only after ptserver and vlserver have been restarted on each of your
+      existing servers, create ptserver and vlserver instances on the new
+      server:
 
           bos create <host> ptserver simple /usr/lib/openafs/ptserver \
               -localauth
@@ -337,11 +349,14 @@ Adding Additional Servers
               -localauth
 
       The existing servers should then propagate the database to the new
-      server.  Note that you do not need to run a file server on a db
-      server if you don't want to (and larger sites probably will not want
-      to), but you always need to have the openafs-fileserver package
-      installed on db servers.  It contains the bosserver binary and some
-      of the shared infrastructure.
+      server.  If you are using buserver, you will need to do the same
+      thing for it as with ptserver and vlserver.
+
+      Note that you do not need to run a file server on a db server if you
+      don't want to (and larger sites probably will not want to), but you
+      always need to have the openafs-fileserver package installed on db
+      servers.  It contains the bosserver binary and some of the shared
+      infrastructure.
 
   5.  If you added a new db server, configure your clients to use it.  If
       you are using AFSDB records in DNS, you can just add a new record
diff --git a/debian/changelog b/debian/changelog
index 3ecc80d79..b8f167235 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -2,6 +2,9 @@ openafs (1.4.0-4) unstable; urgency=low
 
   * Hopefully fix sparc64 kernel support.  Thanks, Troy Benjegerdes.
     (Closes: #219429)
+  * Document the need to restart ptserver and vlserver on the existing
+    database servers when adding a new one.  Thanks, Niklas Edmundsson.
+    (Closes: #349659)
 
  --