2008-04-01 08:50:28 +01:00
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
vos_shadow - Creates a shadow copy of a volume on a different server/partition
|
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
|
|
|
|
|
|
|
B<vos shadow> S<<< [B<-id>] <I<volume name or ID on source>> >>>
|
|
|
|
S<<< [B<-fromserver>] <I<machine name on source>> >>>
|
|
|
|
S<<< [B<-frompartition>] <I<partition name on source>> >>>
|
|
|
|
S<<< [B<-toserver>] <I<machine name on destination>> >>>
|
|
|
|
S<<< [B<-topartition>] <I<partition name on destination>> >>>
|
|
|
|
S<<< [B<-toname> <I<volume name on destination>>] >>>
|
2009-10-08 18:31:00 +01:00
|
|
|
S<<< [B<-toid> <I<volume ID on destination>>] >>>
|
|
|
|
[B<-offline>] [B<-readonly>] [B<-live>] [B<-incremental>]
|
|
|
|
S<<< [B<-cell> <I<cell name>>] >>>
|
|
|
|
[B<-noauth>] [B<-localauth>]
|
2013-06-20 23:45:05 +01:00
|
|
|
[B<-verbose>] [B<-encrypt>] [B<-noresolve>]
|
|
|
|
S<<< [B<-config> <I<config directory>>] >>>
|
|
|
|
[B<-help>]
|
2009-10-08 18:31:00 +01:00
|
|
|
|
|
|
|
B<vos sh> S<<< [B<-id>] <I<volume name or ID on source>> >>>
|
|
|
|
S<<< [B<-froms>] <I<machine name on source>> >>>
|
|
|
|
S<<< [B<-fromp>] <I<partition name on source>> >>>
|
|
|
|
S<<< [B<-tos>] <I<machine name on destination>> >>>
|
|
|
|
S<<< [B<-top>] <I<partition name on destination>> >>>
|
|
|
|
S<<< [B<-ton> <I<volume name on destination>>] >>>
|
|
|
|
S<<< [B<-toi> <I<volume ID on destination>>] >>>
|
|
|
|
[B<-o>] [B<-r>] [B<-l>] [B<-in>]
|
|
|
|
S<<< [B<-c> <I<cell name>>] >>>
|
2013-06-20 23:45:05 +01:00
|
|
|
[B<-noa>] [B<-lo>] [B<-v>] [B<-e>] [B<-nor>]
|
|
|
|
S<<< [B<-co> <I<config directory>>] >>>
|
|
|
|
[B<-h>]
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
|
|
|
The B<vos shadow> command creates a shadow copy of a volume on a
|
|
|
|
different partition or server.
|
|
|
|
|
|
|
|
A shadow volume is a copy of a volume that does not normally appear in
|
|
|
|
the volume location database (VLDB). It is a primitive operation that
|
|
|
|
is meant to be used in backup or disaster recovery situations.
|
|
|
|
|
|
|
|
=head1 CAUTIONS
|
|
|
|
|
|
|
|
This command is not used during normal OpenAFS administration and may
|
|
|
|
have adverse effects on the VLDB if not used properly! This command
|
|
|
|
should only be used by an expert.
|
|
|
|
|
|
|
|
Using this command on a volume when the source volume is not the same
|
|
|
|
as parent volume used to create the shadow will leave the destination
|
|
|
|
volume in a unknown state.
|
|
|
|
|
2012-12-06 15:23:05 +00:00
|
|
|
Running B<vos syncserv> or B<vos syncvldb> on a fileserver containing
|
|
|
|
shadow volumes will not update the VLDB with the shadowed Read/Write
|
|
|
|
volumes as long as the entries for the source volumes still exist. In
|
|
|
|
a disaster recovery situation the VLDB entries for the corresponding
|
|
|
|
source volumes need hence to be deleted first.
|
2008-04-01 08:50:28 +01:00
|
|
|
|
2012-06-28 21:30:40 +01:00
|
|
|
=include fragments/volsize-caution.pod
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-id> <I<volume name or ID>>
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
Specifies either the complete name or volume ID number of a read/write
|
|
|
|
volume.
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-fromserver> <I<machine name for source>>
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
Identifies the file server machine where the source volume resides. Provide
|
|
|
|
the machine's IP address or its host name (either fully qualified or using
|
|
|
|
an unambiguous abbreviation). For details, see L<vos(1)>.
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-frompartition> <I<partition name for source>>
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
Names the partition where the source volume resides. Provide the full
|
|
|
|
partition name (for, example, B</vicepa>) or one of the abbreviated forms
|
|
|
|
described in L<vos(1)>.
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-toserver> <I<machine name for destination>>
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
Identifies the file server machine to which to copy the volume. Provide
|
|
|
|
the machine's IP address or its host name (either fully qualified or using
|
|
|
|
an unambiguous abbreviation). For details, see L<vos(1)>.
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-topartition> <I<partition name for destination>>
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
Names the partition to which to copy the volume. Provide the full partition
|
|
|
|
name (for, example, B</vicepa>) or one of the abbreviated forms described in
|
|
|
|
L<vos(1)>.
|
|
|
|
|
|
|
|
=item B<-toname> <I<volume name for new copy>>
|
|
|
|
|
|
|
|
The complete name of the new volume to create.
|
|
|
|
|
2013-06-20 23:45:05 +01:00
|
|
|
=item B<-toid> <I<volume ID for new copy>>
|
|
|
|
|
|
|
|
The volume ID number to use for the new volume.
|
|
|
|
|
2008-04-01 08:50:28 +01:00
|
|
|
=item B<-offline>
|
|
|
|
|
|
|
|
Leaves the new volume flagged as off-line in the volume database.
|
|
|
|
|
|
|
|
=item B<-readonly>
|
|
|
|
|
|
|
|
Flags the new volume as read-only in the volume database.
|
|
|
|
|
|
|
|
=item B<-live>
|
|
|
|
|
|
|
|
Copies the live volume without cloning. This is normally not necessary and
|
|
|
|
causes the volume to be kept locked for longer than the normal copy
|
|
|
|
mechanism.
|
|
|
|
|
|
|
|
=item B<-incremental>
|
|
|
|
|
|
|
|
Copy the changes from the source volume to a previously created shadow
|
|
|
|
volume.
|
|
|
|
|
2013-06-30 03:06:51 +01:00
|
|
|
=include fragments/vos-common.pod
|
2008-04-01 08:50:28 +01:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 OUTPUT
|
|
|
|
|
|
|
|
This command has no output unless C<-verbose> is specified or there is
|
|
|
|
an error.
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
|
|
|
The issuer must be listed in the F</usr/afs/etc/UserList> file on the
|
|
|
|
machines specified with the B<-toserver> and B<-fromserver> arguments and
|
|
|
|
on each database server machine. If the B<-localauth> flag is included,
|
|
|
|
the issuer must instead be logged on to a server machine as the local
|
|
|
|
superuser C<root>.
|
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
|
|
|
L<vos(1)>,
|
|
|
|
L<vos_backup(1)>,
|
|
|
|
L<vos_copy(1)>,
|
|
|
|
L<vos_move(1)>
|
|
|
|
|
|
|
|
L<http://www.openafs.org/pipermail/openafs-info/2005-July/018469.html>
|
|
|
|
discusses motivation for the creation of this command.
|
|
|
|
|
|
|
|
L<http://workshop.openafs.org/afsbpw06/talks/drh.scs.html> discusses
|
|
|
|
one possible use for it.
|
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
Copyright 2008 Jason Edgecombe <jason@rampaginggeek.com>
|
|
|
|
|
|
|
|
This documentation is covered by the BSD License as written in the
|
|
|
|
doc/LICENSE file. This man page was written by Jason Edgecombe for
|
|
|
|
OpenAFS.
|