1LVCHANGE(8)                 System Manager's Manual                LVCHANGE(8)
2
3
4

NAME

6       lvchange - change attributes of a logical volume
7

SYNOPSIS

9       lvchange   [--addtag   Tag]   [-A|--autobackup   y|n]   [-a|--available
10       y|n|ey|en|ly|ln]  [--alloc  AllocationPolicy]   [-C|--contiguous   y|n]
11       [-d|--debug] [--deltag Tag] [--resync] [-h|-?|--help] [--ignorelocking‐
12       failure]  [--ignoremonitoring]   [--monitor   {y|n}]   [--poll   {y|n}]
13       [--sysinit]   [--noudevsync]   [-M|--persistent  y|n]  [--minor  minor]
14       [-P|--partial]  [-p|--permission  r|rw]  [-r/--readahead  ReadAheadSec‐
15       tors|auto|none]   [--refresh]  [-t|--test]  [-v|--verbose]  LogicalVol‐
16       umePath [LogicalVolumePath...]
17

DESCRIPTION

19       lvchange allows you to  change  the  attributes  of  a  logical  volume
20       including making them known to the kernel ready for use.
21

OPTIONS

23       See lvm for common options.
24
25       -a, --available y|n|ey|en|ly|ln
26              Controls  the availability of the logical volumes for use.  Com‐
27              municates with the kernel device-mapper driver via  libdevmapper
28              to activate (-ay) or deactivate (-an) the logical volumes.
29
30              If  clustered locking is enabled, -aey will activate exclusively
31              on one node and -aly will activate only on the local  node.   To
32              deactivate  only  on  the  local node use -aln.  Logical volumes
33              with single-host  snapshots  are  always  activated  exclusively
34              because they can only be used on one node at once.
35
36       -C, --contiguous y|n
37              Tries to set or reset the contiguous allocation policy for logi‐
38              cal volumes. It's only possible to change a non-contiguous logi‐
39              cal  volume's  allocation  policy  to  contiguous, if all of the
40              allocated physical extents are already contiguous.
41
42       --resync
43              Forces the complete resynchronization of a  mirror.   In  normal
44              circumstances  you  should not need this option because synchro‐
45              nization happens automatically.  Data is read from  the  primary
46              mirror  device and copied to the others, so this can take a con‐
47              siderable amount of time - and during this time you are  without
48              a complete redundant copy of your data.
49
50       --minor minor
51              Set the minor number.
52
53       --monitor y|n
54              Start  or  stop monitoring a mirrored or snapshot logical volume
55              with dmeventd, if it is installed.  If a device used by a  moni‐
56              tored  mirror  reports  an  I/O  error,  the  failure is handled
57              according to mirror_image_fault_policy and mirror_log_fault_pol‐
58              icy set in lvm.conf.
59
60       --poll y|n
61              Without  polling  a logical volume's backgrounded transformation
62              process will never complete.  If there is an  incomplete  pvmove
63              or  lvconvert  (for  example,  on  rebooting after a crash), use
64              --poll y to restart the process from its last checkpoint.   How‐
65              ever,  it  may  not be appropriate to immediately poll a logical
66              volume when it is activated, use --poll  n  to  defer  and  then
67              --poll y to restart the process.
68
69       --sysinit
70              Indicates  that  lvchange(8)  is being invoked from early system
71              initialisation scripts (e.g. rc.sysinit or  an  initrd),  before
72              writeable filesystems are available. As such, some functionality
73              needs to be disabled and this option acts as  a  shortcut  which
74              selects an appropriate set of options. Currently this is equiva‐
75              lent  to  using    --ignorelockingfailure,   --ignoremonitoring,
76              --poll n and setting LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES envi‐
77              ronment variable.
78
79       --noudevsync
80              Disable udev synchronisation. The  process  will  not  wait  for
81              notification  from  udev.   It will continue irrespective of any
82              possible udev processing in the background.  You should only use
83              this if udev is not running or has rules that ignore the devices
84              LVM2 creates.
85
86       --ignoremonitoring
87              Make no attempt to interact with dmeventd  unless  --monitor  is
88              specified.   Do not use this if dmeventd is already monitoring a
89              device.
90
91       -M, --persistent y|n
92              Set to y to make the minor number specified persistent.
93
94       -p, --permission r|rw
95              Change access permission to read-only or read/write.
96
97       -r, --readahead ReadAheadSectors|auto|none
98              Set read ahead sector count of this logical volume.  For  volume
99              groups  with  metadata  in  lvm1  format,  this  must be a value
100              between 2 and 120 sectors.  The default value  is  "auto"  which
101              allows  the  kernel  to  choose  a suitable value automatically.
102              "None" is equivalent to specifying zero.
103
104       --refresh
105              If the logical volume is active, reload its metadata.   This  is
106              not  necessary  in  normal operation, but may be useful if some‐
107              thing has gone wrong or  if  you're  doing  clustering  manually
108              without a clustered lock manager.
109

Examples

111       "lvchange  -pr  vg00/lvol1"  changes  the permission on volume lvol1 in
112       volume group vg00 to be read-only.
113
114

SEE ALSO

116       lvm(8), lvcreate(8), vgchange(8)
117
118
119
120Sistina Software UK    LVM TOOLS 2.02.84(2) (2011-02-09)           LVCHANGE(8)
Impressum