~brightbox/ubuntu/raring/lvm2/fix-for-1076304

« back to all changes in this revision

Viewing changes to man/lvconvert.8.in

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2012-08-14 14:35:57 UTC
  • mfrom: (3.1.25 sid)
  • Revision ID: package-import@ubuntu.com-20120814143557-93aill2tp3kf3o30
Tags: 2.02.95-4ubuntu1
* Merge from Debian unstable, remaining changes:
  - debian/patches/avoid-dev-block.patch: Prefer any other device name over
    names in /dev/block/ since lvm.conf won't handle this.
  - debian/rules:
    - copy .po file to .pot file for Rosetta (Ubuntu specific).
  - debian/{dmsetup,lvm2}-udeb.install:
    - install initramfs and udev hooks in udebs (Debian bug 504341).
  - auto-start VGs as their PVs are discovered (Ubuntu specific):
    - add debian/tree/lvm2/lib/udev/rules.d/85-lvm2.rules: use watershed plus
      the sledgehammer of vgscan/vgchange to turn on VGs as they come online.
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/hooks/lvm2:
      - add 85-lvm2.rules to the list of udev rules to copy.
      - depend on udev.
    - debian/control:
      - add versioned Depend on watershed in lvm2 for udev rules.
      - add Depends on watershed-udeb in lvm2-udeb for udev rules.
      - add versioned Depend/Breaks on udev in dmsetup for udev rules.
      - add Depend on initramfs-tools in dmsetup so system is not potentially
        rendered unbootable by out-of-order dpkg configuration.
    - debian/rules:
      - do not install local-top scripts since Ubuntu mounts root using udev.
      - do not install init scripts for lvm2, since udev starts LVM.
    - debian/lvm2.postinst: handle missing lvm2 init script.
    - debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules:
      watch dm devices for changes with inotify
  - add mountroot failure hooks to help fix bad boots (Debian bug 468115):
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/init-premount/lvm2
  - remaining changes to upstream event manager packages (Debian bug 514706):
    - debian/rules:
      - enable dmeventd during configure.
    - debian/dmeventd.{8,manpages}: install dmeventd files.
  - rename debian/clvm.defaults to debian/clvm.default so it is installed
    correctly.
  - debian/control: add dmsetup-udeb to libdevmapper1.02.1-udeb recommends.
  - debian/rules: make sure dmsetup and lvm2 initramfs-tools scripts are
    executable.  When the Ubuntu-specific ones are added with a patch,
    they may lose their executable bit.
  - Add and install clvmd resource agent
  - Add dependency on libudev-dev to libdevmapper-dev so that the .pc file
    works.
  - debian/{clvmd.ra,clvm.init}:
    - create /run/lvm if it doesn't exist.
  - debian/clvm.init:
    - exit 3 if not running on status action.
  - Call dh_installman so that our dmeventd manpage actually gets installed
  - Install the missing fsadm manpage.

 * libdevmapper-dev:
  - move .so symlinks and pkgconfig files to multiarched locations.
  - mark libdevmapper-dev M-A: same

 * libdevmapper-event1.02.1:
  - Add Breaks: dmeventd (<< 2.02.95-4ubuntu1) due to debian symbol rename

 * debian/lvm2.{preinst,postinst,postrm}:
  - Implement removal of obsolete /etc/init.d/lvm2 conffile, which
    should not have been re-introduced in Quantal.

 * Dropped Changes, included in Debian:
  - Mostly included packages for upstream event manager (Debian bug 514706).
  - debian/patches/rules-subdir.patch: removed as reordering will cause
    build failure with dmeventd.
  - debian/patches/libdm-event-static.patch: removed as other static libs
    aren't being built anymore either.
  - Update symbols for libdevmapper-event.
  - Update libdevmapper-event, dmeventd descriptions to match Debian
    boilerplate.

 * Disappeared Changes:
  - Don't install documentation in udebs. No diff found, but no docs are
    installed into udebs either.

 * Resurected Changes:
  - corrected dropping the wrong init script. Now clvm.init is shipped
    and lvm2.init is dropped in favor of udev rules as per original
    intention (LP: #1037033).

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
.SH SYNOPSIS
5
5
.B lvconvert
6
6
\-m|\-\-mirrors Mirrors [\-\-mirrorlog {disk|core|mirrored}] [\-\-corelog] [\-R|\-\-regionsize MirrorLogRegionSize]
 
7
[\-\-type SegmentType]
7
8
[\-A|\-\-alloc AllocationPolicy]
8
9
[\-b|\-\-background] [\-f|\-\-force] [\-i|\-\-interval Seconds]
9
10
[\-h|\-?|\-\-help]
50
51
[\-v|\-\-verbose]
51
52
[\-\-version]
52
53
LogicalVolume[Path] [PhysicalVolume[Path]...]
 
54
 
 
55
.br
 
56
.B lvconvert
 
57
\-\-replace PhysicalVolume
 
58
[\-h|\-?|\-\-help]
 
59
[\-v|\-\-verbose]
 
60
[\-\-version]
 
61
LogicalVolume[Path] [PhysicalVolume[Path]...]
 
62
 
53
63
.SH DESCRIPTION
54
64
lvconvert is used to change the segment type (i.e. linear, mirror, etc) or
55
65
characteristics of a logical volume.  For example, it can add or remove the
94
104
A mirror is divided into regions of this size (in MB), and the mirror log
95
105
uses this granularity to track which regions are in sync.
96
106
.TP
 
107
.I \-\-type SegmentType
 
108
Used to convert a logical volume to another segment type or to explicitly state
 
109
the desired RAID1 segment type ("mirror" or "raid1") when converting a linear
 
110
logical volume to a mirror with the '-m' argument.
 
111
.TP
97
112
.I \-b, \-\-background
98
113
Run the daemon in the background.
99
114
.TP
174
189
viz. activation/mirror_log_fault_policy or
175
190
activation/mirror_device_fault_policy.
176
191
.br
 
192
 
 
193
.TP
 
194
.I \-\-replace PhysicalVolume
 
195
Remove the specified device (PhysicalVolume) and replace it with one that is
 
196
available in the volume group or from the specific list provided.  This option
 
197
is only available to RAID segment types (e.g. "raid1", "raid5", etc).
 
198
.br
 
199
 
177
200
.SH Examples
178
201
"lvconvert -m1 vg00/lvol1"
179
202
.br
180
203
converts the linear logical volume "vg00/lvol1" to
181
204
a two-way mirror logical volume.
 
205
.br
 
206
.SH Examples
 
207
"lvconvert --type raid1 -m1 vg00/lvol1"
 
208
.br
 
209
converts the linear logical volume "vg00/lvol1" to a two-way RAID1
 
210
logical volume.
182
211
 
183
212
"lvconvert --mirrorlog core vg00/lvol1"
184
213
.br
195
224
converts a mirror logical volume to a linear logical
196
225
volume.
197
226
.br
 
227
"lvconvert --type raid1 vg00/mirror_lv"
 
228
.br
 
229
converts a mirror logical volume to a RAID1 logical volume with the same
 
230
number of images.
 
231
.br
198
232
 
199
233
.br
200
234
"lvconvert -s vg00/lvol1 vg00/lvol2"
252
286
the '\-\-trackchanges' argument back into its original mirror and
253
287
bring its contents back up-to-date.
254
288
 
 
289
.br
 
290
"lvconvert --replace /dev/sdb1 vg00/my_raid1 /dev/sdf1"
 
291
.br
 
292
Replace the physical volume "/dev/sdb1" in the RAID1 logical volume "my_raid1"
 
293
with the specified physical volume "/dev/sdf1".  Had the argument "/dev/sdf1"
 
294
been left out, lvconvert would attempt to find a suitable device from those
 
295
available in the volume group.
 
296
 
255
297
.SH SEE ALSO
256
298
.BR lvm (8),
257
299
.BR vgcreate (8),