* 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 4cdd12c1f4de5c2a7a79792dda7088c77b8e2e36..d323215afbdf779ff8e06e8df9a397aa1c4c699c 100644 (file)
--- 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 3ecc80d795c8fa51ded7e90ac24e9e46b26523c1..b8f167235d6d5279d3144decd74d943da78d754c 100644 (file)
--- 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)
 
  --