X-Git-Url: https://git.openafs.org/?p=openafs.git;a=blobdiff_plain;f=doc%2Fman-pages%2Fpod8%2Fbos_removehost.pod;h=0e2f4f3866f399da06fdf9d4cbff395182da5ce7;hp=7462341e455357ef82f03d62895875b19cb2a304;hb=20d5760fe9653fb748fc25661257ab9720b2b5a6;hpb=03b9fcc8834bfaaac069b27c0cd919934b68e833 diff --git a/doc/man-pages/pod8/bos_removehost.pod b/doc/man-pages/pod8/bos_removehost.pod index 7462341..0e2f4f3 100644 --- a/doc/man-pages/pod8/bos_removehost.pod +++ b/doc/man-pages/pod8/bos_removehost.pod @@ -1,116 +1,112 @@ =head1 NAME -bos removehost - Removes a database server machine from the -B file +bos_removehost - Removes a database server machine from the CellServDB file =head1 SYNOPSIS -B > -host >+ -[B<-cell> >] [B<-noauth>] [B<-localauth>] [B<-help>] +=for html +
-B > B<-ho> >+ [-c >] -[B<-n>] [B<-l>] [B<-he>] +B S<<< B<-server> > >>> S<<< B<-host> >+ >>> + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] [B<-help>] + +B S<<< B<-s> > >>> S<<< B<-ho> >+ >>> + S<<< [B<-c> >] >>> [B<-n>] [B<-l>] [B<-he>] + +=for html +
=head1 DESCRIPTION -The bos removehost command removes the entry for each database -server machine specified with the B<-host> argument from the -B file on the server machine named by the +The B command removes the entry for each database server +machine specified with the B<-host> argument from the +F file on the server machine named by the B<-server> argument. =head1 CAUTIONS After executing this command (and waiting for the Update Server to -propagate the changes, if it is used), restart the database server processes -on all database server machines to force election of a quorum that includes -the new set of machines listed in the B -file. The I explains in more detail -how to add and remove database server machines. +propagate the changes, if it is used), restart the database server +processes on all database server machines to force election of a quorum +that includes the new set of machines listed in the +F file. The I explains +in more detail how to add and remove database server machines. =head1 OPTIONS =over 4 -=item -server -> +=item B<-server> > Indicates the server machine on which to change the -B file. Identify the machine by IP -address or its host name (either fully-qualified or abbreviated -unambiguously). For details, see the introductory reference page for -the B command suite. +F file. Identify the machine by IP address or its +host name (either fully-qualified or abbreviated unambiguously). For +details, see L. -In cells that run the United States edition of AFS and use the Update -Server to distribute the contents of the B directory, it -is conventional to specify only the system control machine as a value for the -B<-server> argument. In cells that run the international -version of AFS, repeat the command for each file server machine. For -further discussion, see the introductory reference page for the B -command suite. +In cells that use the Update Server to distribute the contents of the +F directory, it is conventional to specify only the system +control machine as a value for the B<-server> argument. Otherwise, repeat +the command for each file server machine. For further discussion, see +L. -=item -host -> +=item B<-host> >+ -Specifies the fully-qualified host name (such as -B) of each database server machine to -remove from the B file. +Specifies the fully-qualified host name (such as C) of each +database server machine to remove from the B file. -=item -cell -> +=item B<-cell> > -Names the cell in which to run the command. Do not combine this -argument with the B<-localauth> flag. For more details, see the -introductory B reference page. +Names the cell in which to run the command. Do not combine this argument +with the B<-localauth> flag. For more details, see L. -=item -noauth -> +=item B<-noauth> -Assigns the unprivileged identity anonymous to the -issuer. Do not combine this flag with the B<-localauth> -flag. For more details, see the introductory B reference -page. +Assigns the unprivileged identity C to the issuer. Do not +combine this flag with the B<-localauth> flag. For more details, see +L. -=item -localauth -> +=item B<-localauth> Constructs a server ticket using a key from the local -B file. The B command -interpreter presents the ticket to the BOS Server during mutual -authentication. Do not combine this flag with the B<-cell> or -B<-noauth> options. For more details, see the introductory -B reference page. +F or F file. +The B command interpreter presents the +ticket to the BOS Server during mutual authentication. Do not combine this +flag with the B<-cell> or B<-noauth> options. For more details, see +L. -=item -help +=item B<-help> -Prints the online help for this command. All other valid options -are ignored. +Prints the online help for this command. All other valid options are +ignored. =back =head1 EXAMPLES The following command removes the former database server machine -B from the B file on -the system control machine B. +C from the F file on the system control machine +C. - % bos removehost -server fs1.abc.com -host db2.abc.com + % bos removehost -server fs1.example.com -host db2.example.com =head1 PRIVILEGE REQUIRED -The issuer must be listed in the /usr/afs/etc/UserList file on -the machine named by the B<-server> argument, or must be logged onto a -server machine as the local superuser B if the -B<-localauth> flag is included. +The issuer must be listed in the F file on the +machine named by the B<-server> argument, or must be logged onto a server +machine as the local superuser C if the B<-localauth> flag is +included. =head1 SEE ALSO -L, -L, -L, -L, -L +L, +L, +L, +L, +L, +L -I +The I at +L. =head1 COPYRIGHT