Patrick Williams | b48b7b4 | 2016-08-17 15:04:38 -0500 | [diff] [blame] | 1 | # This is an example configuration file for the LVM2 system. |
| 2 | # It contains the default settings that would be used if there was no |
| 3 | # /etc/lvm/lvm.conf file. |
| 4 | # |
| 5 | # Refer to 'man lvm.conf' for further information including the file layout. |
| 6 | # |
| 7 | # To put this file in a different directory and override /etc/lvm set |
| 8 | # the environment variable LVM_SYSTEM_DIR before running the tools. |
| 9 | |
| 10 | |
| 11 | # This section allows you to configure which block devices should |
| 12 | # be used by the LVM system. |
| 13 | devices { |
| 14 | |
| 15 | # Where do you want your volume groups to appear ? |
| 16 | dir = "/dev" |
| 17 | |
| 18 | # An array of directories that contain the device nodes you wish |
| 19 | # to use with LVM2. |
| 20 | scan = [ "/dev" ] |
| 21 | |
| 22 | # A filter that tells LVM2 to only use a restricted set of devices. |
| 23 | # The filter consists of an array of regular expressions. These |
| 24 | # expressions can be delimited by a character of your choice, and |
| 25 | # prefixed with either an 'a' (for accept) or 'r' (for reject). |
| 26 | # The first expression found to match a device name determines if |
| 27 | # the device will be accepted or rejected (ignored). Devices that |
| 28 | # don't match any patterns are accepted. |
| 29 | |
| 30 | # Be careful if there there are symbolic links or multiple filesystem |
| 31 | # entries for the same device as each name is checked separately against |
| 32 | # the list of patterns. The effect is that if any name matches any 'a' |
| 33 | # pattern, the device is accepted; otherwise if any name matches any 'r' |
| 34 | # pattern it is rejected; otherwise it is accepted. |
| 35 | |
| 36 | # Don't have more than one filter line active at once: only one gets used. |
| 37 | |
| 38 | # Run vgscan after you change this parameter to ensure that |
| 39 | # the cache file gets regenerated (see below). |
| 40 | # If it doesn't do what you expect, check the output of 'vgscan -vvvv'. |
| 41 | |
| 42 | |
| 43 | # By default we accept every block device: |
| 44 | filter = [ "a/.*/" ] |
| 45 | |
| 46 | # Exclude the cdrom drive |
| 47 | # filter = [ "r|/dev/cdrom|" ] |
| 48 | |
| 49 | # When testing I like to work with just loopback devices: |
| 50 | # filter = [ "a/loop/", "r/.*/" ] |
| 51 | |
| 52 | # Or maybe all loops and ide drives except hdc: |
| 53 | # filter =[ "a|loop|", "r|/dev/hdc|", "a|/dev/ide|", "r|.*|" ] |
| 54 | |
| 55 | # Use anchors if you want to be really specific |
| 56 | # filter = [ "a|^/dev/hda8$|", "r/.*/" ] |
| 57 | |
| 58 | # The results of the filtering are cached on disk to avoid |
| 59 | # rescanning dud devices (which can take a very long time). By |
| 60 | # default this cache file is hidden in the /etc/lvm directory. |
| 61 | # It is safe to delete this file: the tools regenerate it. |
| 62 | cache = "/etc/lvm/.cache" |
| 63 | |
| 64 | # You can turn off writing this cache file by setting this to 0. |
| 65 | write_cache_state = 1 |
| 66 | |
| 67 | # Advanced settings. |
| 68 | |
| 69 | # List of pairs of additional acceptable block device types found |
| 70 | # in /proc/devices with maximum (non-zero) number of partitions. |
| 71 | # types = [ "fd", 16 ] |
| 72 | |
| 73 | # If sysfs is mounted (2.6 kernels) restrict device scanning to |
| 74 | # the block devices it believes are valid. |
| 75 | # 1 enables; 0 disables. |
| 76 | sysfs_scan = 1 |
| 77 | |
| 78 | # By default, LVM2 will ignore devices used as components of |
| 79 | # software RAID (md) devices by looking for md superblocks. |
| 80 | # 1 enables; 0 disables. |
| 81 | md_component_detection = 1 |
| 82 | } |
| 83 | |
| 84 | # This section that allows you to configure the nature of the |
| 85 | # information that LVM2 reports. |
| 86 | log { |
| 87 | |
| 88 | # Controls the messages sent to stdout or stderr. |
| 89 | # There are three levels of verbosity, 3 being the most verbose. |
| 90 | verbose = 0 |
| 91 | |
| 92 | # Should we send log messages through syslog? |
| 93 | # 1 is yes; 0 is no. |
| 94 | syslog = 1 |
| 95 | |
| 96 | # Should we log error and debug messages to a file? |
| 97 | # By default there is no log file. |
| 98 | #file = "/var/log/lvm2.log" |
| 99 | |
| 100 | # Should we overwrite the log file each time the program is run? |
| 101 | # By default we append. |
| 102 | overwrite = 0 |
| 103 | |
| 104 | # What level of log messages should we send to the log file and/or syslog? |
| 105 | # There are 6 syslog-like log levels currently in use - 2 to 7 inclusive. |
| 106 | # 7 is the most verbose (LOG_DEBUG). |
| 107 | level = 0 |
| 108 | |
| 109 | # Format of output messages |
| 110 | # Whether or not (1 or 0) to indent messages according to their severity |
| 111 | indent = 1 |
| 112 | |
| 113 | # Whether or not (1 or 0) to display the command name on each line output |
| 114 | command_names = 0 |
| 115 | |
| 116 | # A prefix to use before the message text (but after the command name, |
| 117 | # if selected). Default is two spaces, so you can see/grep the severity |
| 118 | # of each message. |
| 119 | prefix = " " |
| 120 | |
| 121 | # To make the messages look similar to the original LVM tools use: |
| 122 | # indent = 0 |
| 123 | # command_names = 1 |
| 124 | # prefix = " -- " |
| 125 | |
| 126 | # Set this if you want log messages during activation. |
| 127 | # Don't use this in low memory situations (can deadlock). |
| 128 | # activation = 0 |
| 129 | } |
| 130 | |
| 131 | # Configuration of metadata backups and archiving. In LVM2 when we |
| 132 | # talk about a 'backup' we mean making a copy of the metadata for the |
| 133 | # *current* system. The 'archive' contains old metadata configurations. |
| 134 | # Backups are stored in a human readeable text format. |
| 135 | backup { |
| 136 | |
| 137 | # Should we maintain a backup of the current metadata configuration ? |
| 138 | # Use 1 for Yes; 0 for No. |
| 139 | # Think very hard before turning this off! |
| 140 | backup = 1 |
| 141 | |
| 142 | # Where shall we keep it ? |
| 143 | # Remember to back up this directory regularly! |
| 144 | backup_dir = "/etc/lvm/backup" |
| 145 | |
| 146 | # Should we maintain an archive of old metadata configurations. |
| 147 | # Use 1 for Yes; 0 for No. |
| 148 | # On by default. Think very hard before turning this off. |
| 149 | archive = 1 |
| 150 | |
| 151 | # Where should archived files go ? |
| 152 | # Remember to back up this directory regularly! |
| 153 | archive_dir = "/etc/lvm/archive" |
| 154 | |
| 155 | # What is the minimum number of archive files you wish to keep ? |
| 156 | retain_min = 10 |
| 157 | |
| 158 | # What is the minimum time you wish to keep an archive file for ? |
| 159 | retain_days = 30 |
| 160 | } |
| 161 | |
| 162 | # Settings for the running LVM2 in shell (readline) mode. |
| 163 | shell { |
| 164 | |
| 165 | # Number of lines of history to store in ~/.lvm_history |
| 166 | history_size = 100 |
| 167 | } |
| 168 | |
| 169 | |
| 170 | # Miscellaneous global LVM2 settings |
| 171 | global { |
| 172 | |
| 173 | # The file creation mask for any files and directories created. |
| 174 | # Interpreted as octal if the first digit is zero. |
| 175 | umask = 077 |
| 176 | |
| 177 | # Allow other users to read the files |
| 178 | #umask = 022 |
| 179 | |
| 180 | # Enabling test mode means that no changes to the on disk metadata |
| 181 | # will be made. Equivalent to having the -t option on every |
| 182 | # command. Defaults to off. |
| 183 | test = 0 |
| 184 | |
| 185 | # Whether or not to communicate with the kernel device-mapper. |
| 186 | # Set to 0 if you want to use the tools to manipulate LVM metadata |
| 187 | # without activating any logical volumes. |
| 188 | # If the device-mapper kernel driver is not present in your kernel |
| 189 | # setting this to 0 should suppress the error messages. |
| 190 | activation = 1 |
| 191 | |
| 192 | # If we can't communicate with device-mapper, should we try running |
| 193 | # the LVM1 tools? |
| 194 | # This option only applies to 2.4 kernels and is provided to help you |
| 195 | # switch between device-mapper kernels and LVM1 kernels. |
| 196 | # The LVM1 tools need to be installed with .lvm1 suffices |
| 197 | # e.g. vgscan.lvm1 and they will stop working after you start using |
| 198 | # the new lvm2 on-disk metadata format. |
| 199 | # The default value is set when the tools are built. |
| 200 | # fallback_to_lvm1 = 0 |
| 201 | |
| 202 | # The default metadata format that commands should use - "lvm1" or "lvm2". |
| 203 | # The command line override is -M1 or -M2. |
| 204 | # Defaults to "lvm1" if compiled in, else "lvm2". |
| 205 | # format = "lvm1" |
| 206 | |
| 207 | # Location of proc filesystem |
| 208 | proc = "/proc" |
| 209 | |
| 210 | # Type of locking to use. Defaults to file-based locking (1). |
| 211 | # Turn locking off by setting to 0 (dangerous: risks metadata corruption |
| 212 | # if LVM2 commands get run concurrently). |
| 213 | locking_type = 1 |
| 214 | |
| 215 | # Local non-LV directory that holds file-based locks while commands are |
| 216 | # in progress. A directory like /tmp that may get wiped on reboot is OK. |
Brad Bishop | d7bf8c1 | 2018-02-25 22:55:05 -0500 | [diff] [blame] | 217 | locking_dir = "/tmp/lock/lvm" |
Patrick Williams | b48b7b4 | 2016-08-17 15:04:38 -0500 | [diff] [blame] | 218 | |
| 219 | # Other entries can go here to allow you to load shared libraries |
| 220 | # e.g. if support for LVM1 metadata was compiled as a shared library use |
| 221 | # format_libraries = "liblvm2format1.so" |
| 222 | # Full pathnames can be given. |
| 223 | |
| 224 | # Search this directory first for shared libraries. |
| 225 | # library_dir = "/lib" |
| 226 | } |
| 227 | |
| 228 | activation { |
| 229 | # Device used in place of missing stripes if activating incomplete volume. |
| 230 | # For now, you need to set this up yourself first (e.g. with 'dmsetup') |
| 231 | # For example, you could make it return I/O errors using the 'error' |
| 232 | # target or make it return zeros. |
| 233 | missing_stripe_filler = "/dev/ioerror" |
| 234 | |
| 235 | # Size (in KB) of each copy operation when mirroring |
| 236 | mirror_region_size = 512 |
| 237 | |
| 238 | # How much stack (in KB) to reserve for use while devices suspended |
| 239 | reserved_stack = 256 |
| 240 | |
| 241 | # How much memory (in KB) to reserve for use while devices suspended |
| 242 | reserved_memory = 8192 |
| 243 | |
| 244 | # Nice value used while devices suspended |
| 245 | process_priority = -18 |
| 246 | |
| 247 | # If volume_list is defined, each LV is only activated if there is a |
| 248 | # match against the list. |
| 249 | # "vgname" and "vgname/lvname" are matched exactly. |
| 250 | # "@tag" matches any tag set in the LV or VG. |
| 251 | # "@*" matches if any tag defined on the host is also set in the LV or VG |
| 252 | # |
| 253 | # volume_list = [ "vg1", "vg2/lvol1", "@tag1", "@*" ] |
| 254 | } |
| 255 | |
| 256 | |
| 257 | #################### |
| 258 | # Advanced section # |
| 259 | #################### |
| 260 | |
| 261 | # Metadata settings |
| 262 | # |
| 263 | # metadata { |
| 264 | # Default number of copies of metadata to hold on each PV. 0, 1 or 2. |
| 265 | # You might want to override it from the command line with 0 |
| 266 | # when running pvcreate on new PVs which are to be added to large VGs. |
| 267 | |
| 268 | # pvmetadatacopies = 1 |
| 269 | |
| 270 | # Approximate default size of on-disk metadata areas in sectors. |
| 271 | # You should increase this if you have large volume groups or |
| 272 | # you want to retain a large on-disk history of your metadata changes. |
| 273 | |
| 274 | # pvmetadatasize = 255 |
| 275 | |
| 276 | # List of directories holding live copies of text format metadata. |
| 277 | # These directories must not be on logical volumes! |
| 278 | # It's possible to use LVM2 with a couple of directories here, |
| 279 | # preferably on different (non-LV) filesystems, and with no other |
| 280 | # on-disk metadata (pvmetadatacopies = 0). Or this can be in |
| 281 | # addition to on-disk metadata areas. |
| 282 | # The feature was originally added to simplify testing and is not |
| 283 | # supported under low memory situations - the machine could lock up. |
| 284 | # |
| 285 | # Never edit any files in these directories by hand unless you |
| 286 | # you are absolutely sure you know what you are doing! Use |
| 287 | # the supplied toolset to make changes (e.g. vgcfgrestore). |
| 288 | |
| 289 | # dirs = [ "/etc/lvm/metadata", "/mnt/disk2/lvm/metadata2" ] |
| 290 | #} |
| 291 | |
| 292 | # Event daemon |
| 293 | # |
| 294 | dmeventd { |
| 295 | # mirror_library is the library used when monitoring a mirror device. |
| 296 | # |
| 297 | # "libdevmapper-event-lvm2mirror.so" attempts to recover from |
| 298 | # failures. It removes failed devices from a volume group and |
| 299 | # reconfigures a mirror as necessary. If no mirror library is |
| 300 | # provided, mirrors are not monitored through dmeventd. |
| 301 | |
| 302 | mirror_library = "@libdir@/device-mapper/libdevmapper-event-lvm2mirror.so" |
| 303 | |
| 304 | # snapshot_library is the library used when monitoring a snapshot device. |
| 305 | # |
| 306 | # "libdevmapper-event-lvm2snapshot.so" monitors the filling of |
| 307 | # snapshots and emits a warning through syslog when the use of |
| 308 | # the snapshot exceeds 80%. The warning is repeated when 85%, 90% and |
| 309 | # 95% of the snapshot is filled. |
| 310 | |
| 311 | snapshot_library = "@libdir@/device-mapper/libdevmapper-event-lvm2snapshot.so" |
| 312 | |
| 313 | # thin_library is the library used when monitoring a thin device. |
| 314 | # |
| 315 | # "libdevmapper-event-lvm2thin.so" monitors the filling of |
| 316 | # pool and emits a warning through syslog when the use of |
| 317 | # the pool exceeds 80%. The warning is repeated when 85%, 90% and |
| 318 | # 95% of the pool is filled. |
| 319 | |
| 320 | thin_library = "@libdir@/device-mapper/libdevmapper-event-lvm2thin.so" |
| 321 | |
| 322 | # Full path of the dmeventd binary. |
| 323 | # |
| 324 | # executable = "@DMEVENTD_PATH@" |
| 325 | } |
| 326 | |