2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
bos_restart - Restarts a server process
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
|
|
|
|
|
|
|
B<bos restart> S<<< B<-server> <I<machine name>> >>> S<<< [B<-instance> <I<instances>>+] >>>
|
|
|
|
[B<-bosserver>] [B<-all>] S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>]
|
2005-12-13 19:21:13 +00:00
|
|
|
[B<-localauth>] [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<bos res> S<<< B<-s> <I<machine name>> >>> S<<< [B<-i> <I<instances>>+] >>> [B<-b>]
|
|
|
|
[B<-a>] S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-h>]
|
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<bos restart> command stops and immediately restarts server processes
|
|
|
|
on the server machine named by the B<-server> argument. Indicate which
|
|
|
|
process or processes to restart by providing one of the following
|
|
|
|
arguments:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<-instance> argument names each AFS server process to stop and
|
|
|
|
restart immediately, regardless of its status flag in the
|
|
|
|
F</usr/afs/local/BosConfig> file. Do not include B<bosserver> in the list
|
|
|
|
of processes; use the B<-bosserver> flag instead.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<-bosserver> flag stops all AFS server processes running on the
|
|
|
|
machine, including the BOS Server. A new BOS Server starts immediately,
|
|
|
|
and it starts a new instance of each process that is marked with the
|
|
|
|
C<Run> status flag in the F<BosConfig> file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<-all> flag stops all AFS server processes running on the machine,
|
|
|
|
except the BOS Server, and immediately restarts the processes that are
|
|
|
|
marked with the C<Run> status flag in the F<BosConfig> file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
This command does not change a process's status flag in the F<BosConfig>
|
|
|
|
file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-server> <I<machine name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Indicates the server machine on which to restart each process. Identify
|
|
|
|
the machine by IP address or its host name (either fully-qualified or
|
|
|
|
abbreviated unambiguously). For details, see L<bos(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-instance> <I<instances>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Names each process to stop and then restart immediately regardless of its
|
2005-12-13 19:21:13 +00:00
|
|
|
status flag setting. Use the process name assigned with the B<-instance>
|
|
|
|
argument to the B<bos create> command. The output from the B<bos status>
|
|
|
|
command lists the names. Provide this flag or one of the B<-bosserver> or
|
|
|
|
B<-all> options, but do not combine them.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-bosserver>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Stops all AFS server processes running on the machine, including the BOS
|
|
|
|
Server. A new BOS Server instance immediately starts, and starts all
|
2005-12-13 19:21:13 +00:00
|
|
|
processes marked with the C<Run> status flag in the F<BosConfig>
|
|
|
|
file. Provide this flag or one of the B<-instance> or B<-all> options, but
|
|
|
|
do not combine them.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-all>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Stops all AFS server processes running on the machine other than the BOS
|
|
|
|
Server, and immediately restarts the processes marked with the B<Run>
|
2005-12-13 19:21:13 +00:00
|
|
|
status flag in the F<BosConfig> file. Provide this flag or one of the
|
|
|
|
B<-instance> or B<-bosserver> options, but do not combine them.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-cell> <I<cell name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Names the cell in which to run the command. Do not combine this argument
|
|
|
|
with the B<-localauth> flag. For more details, see L<bos(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-noauth>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Assigns the unprivileged identity C<anonymous> to the issuer. Do not
|
|
|
|
combine this flag with the B<-localauth> flag. For more details, see
|
|
|
|
L<bos(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-localauth>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Constructs a server ticket using a key from the local
|
2005-12-13 19:21:13 +00:00
|
|
|
F</usr/afs/etc/KeyFile> file. The B<bos> 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<bos(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
|
|
|
The following command stops and restarts all processes running on the
|
2005-12-13 19:21:13 +00:00
|
|
|
machine C<fs3.abc.com>, including the BOS Server.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% bos restart -server fs3.abc.com -bosserver
|
|
|
|
|
|
|
|
The following command stops and restarts all processes running on the
|
2005-12-13 19:21:13 +00:00
|
|
|
machine C<fs5.abc.com>, excluding the BOS Server.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% bos restart -server fs5.abc.com -all
|
|
|
|
|
|
|
|
The following command stops and restarts the Protection Server and Volume
|
2005-12-13 19:21:13 +00:00
|
|
|
Location (VL) Server processes on the machine C<db3.abc.com>:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% bos restart -server db3.abc.com -instance ptserver vlserver
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer must be listed in the F</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 C<root> if the B<-localauth> flag is
|
|
|
|
included.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<BosConfig(5)>,
|
|
|
|
L<KeyFile(5)>,
|
|
|
|
L<UserList(5)>,
|
|
|
|
L<bos(8)>,
|
|
|
|
L<bos_create(8)>,
|
|
|
|
L<bos_status(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|