From e55f1b4dc3134762c61143c7dcc8e252d9973365 Mon Sep 17 00:00:00 2001 From: Ken Dreyer Date: Tue, 13 Mar 2012 20:06:43 -0600 Subject: [PATCH] doc: remove references to AFS's NTP daemon AFS's own ntpd and runntp are obsolete. Remove them from the documentation, and recommend the OS vendor-supplied NTP instead. Change-Id: If0cd837aa407eb49049881790e618ccd75ca6e5b Reviewed-on: http://gerrit.openafs.org/6903 Tested-by: BuildBot Reviewed-by: Alistair Ferguson Reviewed-by: Derrick Brashear --- doc/man-pages/pod8/bos_create.pod | 4 - doc/man-pages/pod8/bos_status.pod | 1 - doc/man-pages/pod8/bos_stop.pod | 4 +- doc/xml/AdminGuide/auagd008.xml | 122 ------------------ doc/xml/AdminGuide/auagd009.xml | 58 --------- doc/xml/QuickStartUnix/auqbg005.xml | 17 +-- doc/xml/QuickStartUnix/auqbg006.xml | 59 +-------- .../lib/InstallGuides/GENERIC/miscserver | 4 - .../lib/InstallGuides/info/miscserver.toc | 2 - 9 files changed, 9 insertions(+), 262 deletions(-) diff --git a/doc/man-pages/pod8/bos_create.pod b/doc/man-pages/pod8/bos_create.pod index 589516e14..567462a73 100644 --- a/doc/man-pages/pod8/bos_create.pod +++ b/doc/man-pages/pod8/bos_create.pod @@ -84,10 +84,6 @@ The Authentication Server process. The Protection Server process. -=item runntp - -The controller process for the Network Time Protocol Daemon (obsolete). - =item upclientbin The client portion of the Update Server process that retrieves binary diff --git a/doc/man-pages/pod8/bos_status.pod b/doc/man-pages/pod8/bos_status.pod index 82b28b382..8216524dd 100644 --- a/doc/man-pages/pod8/bos_status.pod +++ b/doc/man-pages/pod8/bos_status.pod @@ -235,7 +235,6 @@ machine B: Instance fs, has core file, currently running normally. Auxiliary status is: file server running. Instance upserver, currently running normally. - Instance runntp, currently running normally. The following example command displays a detailed status report for the B and B processes on the machine diff --git a/doc/man-pages/pod8/bos_stop.pod b/doc/man-pages/pod8/bos_stop.pod index 1db32f377..f1a1071eb 100644 --- a/doc/man-pages/pod8/bos_stop.pod +++ b/doc/man-pages/pod8/bos_stop.pod @@ -77,10 +77,10 @@ ignored. =head1 EXAMPLES -The following example command stops the B and B +The following example command stops the B and B processes on the machine C. - % bos stop -server fs7.example.com -instance upserver runntp + % bos stop -server fs7.example.com -instance upserver vlserver =head1 PRIVILEGE REQUIRED diff --git a/doc/xml/AdminGuide/auagd008.xml b/doc/xml/AdminGuide/auagd008.xml index 773e576d3..2738f1ec9 100644 --- a/doc/xml/AdminGuide/auagd008.xml +++ b/doc/xml/AdminGuide/auagd008.xml @@ -499,77 +499,6 @@ The binary for the Authentication Server process. - - ntpd - - binary in /usr/afs/bin - - - - files - - ntpd - - - - programs - - ntpd - - - - processes - - NTPD, binary in /usr/afs/bin - - - - NTPD - - - - Network Time Protocol Daemon - - - - NTPD - - - - - - ntpd - - - The binary for the Network Time Protocol Daemon (NTPD). AFS redistributes this binary and uses the runntp program to configure and initialize the NTPD process. - - - ntpdc - - binary in /usr/afs/bin - - - - files - - ntpdc - - - - programs - - ntpdc - - - - - - ntpdc - - - A debugging utility furnished with the ntpd program. - files @@ -637,40 +566,6 @@ The binary for the Protection Server process. - - runntp - - binary in /usr/afs/bin - - - - runntp - - - - NTPD - - - - files - - runntp - - - - programs - - runntp - - - - - - runntp - - - The binary for the program used to configure NTPD most appropriately for use with AFS. - Salvager @@ -1924,11 +1819,6 @@ result from multiple simultaneous operations on the same data - - The NTP coordinator (runntp process), which helps keep the machine's clock - synchronized with the clocks on the other server machines in the cell - - A client portion of the Update Server that picks up binary files from the binary distribution machine of its AFS system type (the upclientbin process) @@ -2142,12 +2032,6 @@ United States edition of AFS. The client portion of the Update Server (upclientetc process) runs on the other server machines and references the system control machine. - - - The NTP coordinator (runntp process) which points to a time source outside the - cell, if the cell uses NTPD to synchronize its clocks. The runntp process on other - machines reference the system control machine as their main time source. - The system control machine can also run the processes that define a simple file server machine, as listed in Keep the clocks synchronized on all machines in the cell, especially the database server machines. - In the conventional configuration specified in the OpenAFS Quick Beginnings, you run the - runntp process to supervise the local Network Time Protocol Daemon (NTPD) on every - AFS server machine. The NTPD on the system control machine synchronizes its clock with a reliable source outside the - cell and broadcasts the time to the NTPDs on the other server machines. You can choose to run a different time - synchronization protocol if you wish. - Keeping clocks synchronized is important because the Ubik processes at a database's sites timestamp the messages which they exchange to maintain constant contact. Timestamping the messages is necessary because in a networked environment it is not safe to assume that a message reaches its destination instantly. Ubik compares the timestamp on diff --git a/doc/xml/AdminGuide/auagd009.xml b/doc/xml/AdminGuide/auagd009.xml index 5fcc2de3e..f04472bde 100644 --- a/doc/xml/AdminGuide/auagd009.xml +++ b/doc/xml/AdminGuide/auagd009.xml @@ -558,58 +558,6 @@ - - The runntp Process - - - runntp process - - - - ntpd - - invoked by runntp process - - - - server process - - runntp - - - The runntp process, which runs on every server machine, is a controller program for the - Network Time Protocol Daemon (NTPD), which synchronizes the hardware clocks on server machines. You need to run the runntp process if you are not already running NTP or another time synchronization protocol on your - server machines. - - The clocks on database server machines need to be synchronized because AFS's distributed database technology (Ubik) - works properly only when the clocks agree within a narrow range of variation (see Configuring the - Cell for Proper Ubik Operation). The clocks on file server machines need to be correct not only because the File Server - sets modification time stamps on files, but because in the conventional configuration they serve as the time source for AFS - client machines. - - The process appears as runntp in the bos status - command's output, if the conventional name is assigned. It appears in the output from the ps - command as /usr/afs/bin/runntp. The ps command's output also - includes an entry called ntpd; its exact form depends on the arguments you provide to the - runntp command. - - - ntpd - - when to contact - - - - contacting processes - - NTPD - - - As a system administrator, you do not contact the NTPD directly once you have installed it according to the instructions - in the OpenAFS Quick Beginnings. - - The upserver and upclient Processes: the Update Server @@ -1244,7 +1192,6 @@ Instance fs, currently running normally. Auxiliary status is: file server running. Instance upserver, currently running normally. - Instance runntp, currently running normally. Instance backupusers, currently running normally. Auxiliary status is: run next at Mon Jun 7 02:00:00 1999. @@ -1577,11 +1524,6 @@ ptserver for the Protection Server - - runntp for the controller process for the Network Time Protocol - Daemon - - upclientbin for the client portion of the Update Server that references the binary distribution machine of this machine's system type diff --git a/doc/xml/QuickStartUnix/auqbg005.xml b/doc/xml/QuickStartUnix/auqbg005.xml index 4405bb985..d3709aa02 100644 --- a/doc/xml/QuickStartUnix/auqbg005.xml +++ b/doc/xml/QuickStartUnix/auqbg005.xml @@ -67,11 +67,8 @@ - You have a NTP, or similar, time service deployed to ensure - rough clock syncronistation between your clients and servers. If you - wish to use AFS's built in timeservice (which is deprecated) please - see Appendix B for the necessary modifications to this installation - procedure. + You have NTP or a similar time service deployed to ensure + rough clock syncronistation between your clients and servers. @@ -3984,18 +3981,16 @@ Entry for principal afs/<cell name> with kvno 3 - Starting the Controller for NTPD + Clock Sync Considerations Keeping the clocks on all server and client machines in your cell synchronized is crucial to several functions, and in particular to the correct operation of AFS's distributed database technology, Ubik. The chapter in the OpenAFS Administration Guide about administering server machines explains how time skew can disturb Ubik's performance and cause service outages in your cell. - Historically, AFS used to distribute its own version of the Network -Time Protocol Daemon. Whilst this is still provided for existing sites, we -recommend that you configure and install your time service independently of -AFS. A reliable timeservice will also be required by your Kerberos realm, -and so may already be available at your site. + You should install and configure your time service independently of + AFS. Your Kerberos realm will also require a reliable time source, so your site + may already have one available. overview diff --git a/doc/xml/QuickStartUnix/auqbg006.xml b/doc/xml/QuickStartUnix/auqbg006.xml index b47135094..69d64297f 100644 --- a/doc/xml/QuickStartUnix/auqbg006.xml +++ b/doc/xml/QuickStartUnix/auqbg006.xml @@ -1657,7 +1657,7 @@ Starting Server Programs - In this section you initialize the BOS Server, the Update Server, the controller process for NTPD, and the In this section you initialize the BOS Server, the Update Server, and the fs process. You begin by copying the necessary server files to the local disk. copying @@ -1977,63 +1977,6 @@ - - runntp process - - server machine after first - - - - starting - - runntp process - - server machine after first - - - - file server machine, additional - - runntp process - - - - NTPD - - server machine after first - - - - - - - Historically, AFS provided its own version of the - Network Time Protocol Daemon. Whilst this is still provided for - existing sites, we recommend that you configure and run your - own timeservice independently of AFS. The instructions below are - provided for those sites still reliant upon OpenAFS's ntp system. - - - - Start the runntp process, which configures the Network Time Protocol Daemon - (NTPD) to choose a database server machine chosen randomly from the local /usr/afs/etc/CellServDB file as its time source. In the standard configuration, the first - database server machine installed in your cell refers to a time source outside the cell, and serves as the basis for - clock synchronization on all server machines. - # ./bos create <machine name> runntp simple \ - /usr/afs/bin/runntp -cell <cell name> -noauth - - - - Do not run the runntp process if NTPD or another time synchronization protocol - is already running on the machine. Some versions of some operating systems run a time synchronization program by - default, as detailed in the OpenAFS Release Notes. - - Attempting to run multiple instances of the NTPD causes an error. Running NTPD together with another time - synchronization protocol is unnecessary and can cause instability in the clock setting. - - File Server diff --git a/src/afsinstall/lib/InstallGuides/GENERIC/miscserver b/src/afsinstall/lib/InstallGuides/GENERIC/miscserver index 79c291581..52851d0de 100644 --- a/src/afsinstall/lib/InstallGuides/GENERIC/miscserver +++ b/src/afsinstall/lib/InstallGuides/GENERIC/miscserver @@ -17,11 +17,7 @@ sub miscserver { &Copy ("root.server/usr/afs/bin/buserver", "/usr/afs/bin"); &Copy ("root.server/usr/afs/bin/upserver", "/usr/afs/bin"); &Copy ("root.server/usr/afs/bin/upclient", "/usr/afs/bin"); -&Copy ("root.server/usr/afs/bin/runntp", "/usr/afs/bin"); -&Copy ("root.server/usr/afs/bin/ntpd", "/usr/afs/bin"); &Chmod(0744, "/usr/afs/bin/buserver"); &Chmod(0744, "/usr/afs/bin/upserver"); &Chmod(0744, "/usr/afs/bin/upclient"); -&Chmod(0744, "/usr/afs/bin/runntp"); -&Chmod(0744, "/usr/afs/bin/ntpd"); } diff --git a/src/afsinstall/lib/InstallGuides/info/miscserver.toc b/src/afsinstall/lib/InstallGuides/info/miscserver.toc index b757a08cd..ec8fe07ee 100644 --- a/src/afsinstall/lib/InstallGuides/info/miscserver.toc +++ b/src/afsinstall/lib/InstallGuides/info/miscserver.toc @@ -15,6 +15,4 @@ sub miscserver { &Print(" root.server/usr/afs/bin/buserver"); &Print(" root.server/usr/afs/bin/upserver"); &Print(" root.server/usr/afs/bin/upclient"); -&Print(" root.server/usr/afs/bin/runntp"); -&Print(" root.server/usr/afs/bin/ntpd"); } -- 2.39.5