3
vos_offline - Takes a volume offline
10
B<vos offline> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
11
S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-unbless>] >>> S<<< [B<-cell> <I<cell name>>] >>>
12
S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>>
19
The B<vos offline> command takes a volume offline on the
24
Taking a volume offline that has existing
25
callbacks will result in those callbacks being broken
26
and clients not being able to access the volume.
32
=item B<-server> <I<machine name>>
34
Identifies the file server machine where the volume resides.
35
Provide the machine's IP address or its host name (either fully
36
qualified or using an unambiguous abbreviation). For details, see
39
=item B<-partition> <I<partition name>>
41
Identifies the partition where the volume resides, on the
42
file server machine named by the B<-server> argument. Provide the
43
partition's complete name with preceding slash (for example, C</vicepa>)
44
or use one of the three acceptable abbreviated forms. For details, see
47
=item B<-id> <I<volume name or ID>>
49
Specifies either the complete name or volume ID number of the volume.
53
If the volume resides on a fileserver running as a I<dafs> (Demand
54
Attach File Server), then the volume may be marked as I<blessed> or
55
I<unblessed>. A I<dafs> server will not bring I<unblessed> volumes
56
online unless the B<-bless> option to L<vos_online> is specified.
57
See L<vos_online(1)> for setting a volume to be I<blessed>.
59
=item B<-cell> <I<cell name>>
61
Names the cell in which to run the command. Do not combine this argument
62
with the B<-localauth> flag. For more details, see L<vos(1)>.
66
Assigns the unprivileged identity anonymous to the issuer. Do not combine
67
this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
71
Constructs a server ticket using a key from the local
72
F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
73
to the Volume Server and Volume Location Server during mutual
74
authentication. Do not combine this flag with the B<-cell> argument or
75
B<-noauth> flag. For more details, see L<vos(1)>.
79
Produces on the standard output stream a detailed trace of the command's
80
execution. If this argument is omitted, only warnings and error messages
85
Encrypts the command so that the operation's results are
86
not transmitted across the network in clear text.
90
Prints the online help for this command. All other valid options are
97
The following example takes an online volume offline:
99
% vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs
101
The following example takes an online volume offline and marks it
102
so that a B<vos online> without B<-bless> will not bring it online:
104
% vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs \
107
=head1 PRIVILEGE REQUIRED
109
The issuer must be listed in the F</usr/afs/etc/UserList> file on the
110
machine specified with the B<-server> argument and on each database server
111
machine. If the B<-localauth> flag is included, the issuer must instead be
112
logged on to a server machine as the local superuser C<root>.
122
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
124
This man page was created by Steven Jenkins.