lvm2/man/lvmconf.8.in

.TH "LVMCONF" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""

.SH "NAME"
lvmconf \(em LVM configuration modifier
.SH "SYNOPSIS"
.B lvmconf
.RB [ \-\-disable-cluster ]
.RB [ \-\-enable-cluster ]
.RB [ \-\---enable-halvm ]
.RB [ \-\---disable-halvm ]
.RB [ \-\-file
.RI < configfile >]
.RB [ \-\-lockinglib
.RI < lib >]
.RB [ \-\-lockinglibdir
.RI < dir >]
.RB [ \-\-services ]
.RB [ \-\-mirrorservice ]
.RB [ \-\-startstopservices ]

.SH "DESCRIPTION"
lvmconf is a script that modifies the locking configuration in
an lvm configuration file. See \fBlvm.conf\fP(5). In addition
to that, it can also set Systemd or SysV services according to
changes in the lvm configuration if needed.

.SH "OPTIONS"
.TP
.BR \-\-disable-cluster
Set \fBlocking_type\fR to the default non-clustered type. Also reset
lvmetad use to its default.
.TP
.BR \-\-enable-cluster
Set \fBlocking_type\fR to the default clustered type on this system.
Also disable lvmetad use as it is not yet supported in clustered environment.
.TP
.BR \-\-disable-halvm
Set \fBlocking_type\fR to the default non-clustered type. Also reset
lvmetad use to its default.
.TP
.BR \-\-enable-halvm
Set \fBlocking_type\fR suitable for HA LVM use.
Also disable lvmetad use as it is not yet supported in HA LVM environment.
.TP
.BR \-\-file " <" \fIconfigfile >
Apply the changes to \fIconfigfile\fP instead of the default
\fI#DEFAULT_SYS_DIR#/lvm.conf\fP.
.TP
.BR \-\-lockinglib " <" \fIlib >
Set external \fBlocking_library\fR locking library to load if an external locking type is used.
.TP
.BR \-\-lockinglibdir " <" \fIdir >
.TP
.BR \-\-services
In addition to setting the lvm configuration, also enable or disable related Systemd or SysV
clvmd and lvmetad services. This script does not configure services provided by cluster resource
agents.
.TP
.BR \-\-mirrorservice
Also enable or disable optional cmirrord service when handling services (applicable only with \-\-services).
.TP
.BR \-\-startstopservices
In addition to enabling or disabling related services, start or stop them immediately
(applicable only with \-\-services).
.SH FILES
.I #DEFAULT_SYS_DIR#/lvm.conf

.SH "SEE ALSO"
.BR lvm (8),
.BR lvm.conf (5)
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.TH "LVMCONF" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""`

			`.SH "NAME"`
man: properly escape - Dash should be using '\' to be typographically correct. 2014-06-11 13:06:30 +04:00			`lvmconf \(em LVM configuration modifier`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.SH "SYNOPSIS"`
			`.B lvmconf`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`.RB [ \-\-disable-cluster ]`
			`.RB [ \-\-enable-cluster ]`
lvmconf: add --enable-halvm, --disable-halvm, --services, --mirrorservice, --startstopservices options and use proper global/use_lvmetad default value This patch adds new options to lvmconf: --enable-halvm (just like --enable-cluster, but configure LVM for use in HA LVM - meaning disabling lvmetad and making sure we have locking_type=1) --disable-halvm (just like --disable-cluster, but configure LVM back from HA LVM - meaning enabling lvmetad if it's enabled by default and making sure we have default locking type set) --services (causes clvmd and lvmetad services to be enabled or disabled appropriately and conforming to the changes in lvm configuration we've just made with lvmconf) --mirrorservice (in addition to clvmd and lvmetad services, also enable or disable cmirrord service appropriately; this is a separate option because cmirrord is optional and it doesn't need to be always enabled when clvmd is enabled) --startstopservices (in addition to enabling or disabling services, start and stop these services immediately) These options are supposed to help users to make their system ready for cluster with clvmd (active-active) or HA LVM (active-passive) use while lvmconf script can handle services as well so users don't need to bother about setting them manually. Also, before this patch, we hardcoded global/use_lvmetad=0 as default value in lvmconf script. Howeverm this default may change by just flipping the value in config_settings.h and we may forget to edit the lvmconf. It's better to use lvm dumpconfig --type default global/use_lvmetad to get the actual default value and use this one instead of hardcoded one. 2015-04-13 16:27:17 +03:00			`.RB [ \-\---enable-halvm ]`
			`.RB [ \-\---disable-halvm ]`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`.RB [ \-\-file`
			`.RI < configfile >]`
			`.RB [ \-\-lockinglib`
			`.RI < lib >]`
			`.RB [ \-\-lockinglibdir`
			`.RI < dir >]`
lvmconf: add --enable-halvm, --disable-halvm, --services, --mirrorservice, --startstopservices options and use proper global/use_lvmetad default value This patch adds new options to lvmconf: --enable-halvm (just like --enable-cluster, but configure LVM for use in HA LVM - meaning disabling lvmetad and making sure we have locking_type=1) --disable-halvm (just like --disable-cluster, but configure LVM back from HA LVM - meaning enabling lvmetad if it's enabled by default and making sure we have default locking type set) --services (causes clvmd and lvmetad services to be enabled or disabled appropriately and conforming to the changes in lvm configuration we've just made with lvmconf) --mirrorservice (in addition to clvmd and lvmetad services, also enable or disable cmirrord service appropriately; this is a separate option because cmirrord is optional and it doesn't need to be always enabled when clvmd is enabled) --startstopservices (in addition to enabling or disabling services, start and stop these services immediately) These options are supposed to help users to make their system ready for cluster with clvmd (active-active) or HA LVM (active-passive) use while lvmconf script can handle services as well so users don't need to bother about setting them manually. Also, before this patch, we hardcoded global/use_lvmetad=0 as default value in lvmconf script. Howeverm this default may change by just flipping the value in config_settings.h and we may forget to edit the lvmconf. It's better to use lvm dumpconfig --type default global/use_lvmetad to get the actual default value and use this one instead of hardcoded one. 2015-04-13 16:27:17 +03:00			`.RB [ \-\-services ]`
			`.RB [ \-\-mirrorservice ]`
			`.RB [ \-\-startstopservices ]`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00
			`.SH "DESCRIPTION"`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`lvmconf is a script that modifies the locking configuration in`
man: lvmconf: more notes on --services option 2015-04-14 10:49:56 +03:00			`an lvm configuration file. See \fBlvm.conf\fP(5). In addition`
			`to that, it can also set Systemd or SysV services according to`
			`changes in the lvm configuration if needed.`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00
			`.SH "OPTIONS"`
			`.TP`
			`.BR \-\-disable-cluster`
lvmconf: use_lvmetad=0 on --enable-cluster, reset to default on --disable-cluster lvmetad is not yet supported in clustered environment so disable it automatically if using lvmconf --enable-cluster and reset it to default value if using lvmconf --disable-cluster. Also, add a few comments in lvm.conf about locking_type vs. use_lvmetad if setting it for clustered environment. 2013-09-24 16:03:42 +04:00			`Set \fBlocking_type\fR to the default non-clustered type. Also reset`
			`lvmetad use to its default.`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.TP`
			`.BR \-\-enable-cluster`
Various cleanups following recent commits. 2010-06-21 19:56:57 +04:00			`Set \fBlocking_type\fR to the default clustered type on this system.`
lvmconf: use_lvmetad=0 on --enable-cluster, reset to default on --disable-cluster lvmetad is not yet supported in clustered environment so disable it automatically if using lvmconf --enable-cluster and reset it to default value if using lvmconf --disable-cluster. Also, add a few comments in lvm.conf about locking_type vs. use_lvmetad if setting it for clustered environment. 2013-09-24 16:03:42 +04:00			`Also disable lvmetad use as it is not yet supported in clustered environment.`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.TP`
lvmconf: add --enable-halvm, --disable-halvm, --services, --mirrorservice, --startstopservices options and use proper global/use_lvmetad default value This patch adds new options to lvmconf: --enable-halvm (just like --enable-cluster, but configure LVM for use in HA LVM - meaning disabling lvmetad and making sure we have locking_type=1) --disable-halvm (just like --disable-cluster, but configure LVM back from HA LVM - meaning enabling lvmetad if it's enabled by default and making sure we have default locking type set) --services (causes clvmd and lvmetad services to be enabled or disabled appropriately and conforming to the changes in lvm configuration we've just made with lvmconf) --mirrorservice (in addition to clvmd and lvmetad services, also enable or disable cmirrord service appropriately; this is a separate option because cmirrord is optional and it doesn't need to be always enabled when clvmd is enabled) --startstopservices (in addition to enabling or disabling services, start and stop these services immediately) These options are supposed to help users to make their system ready for cluster with clvmd (active-active) or HA LVM (active-passive) use while lvmconf script can handle services as well so users don't need to bother about setting them manually. Also, before this patch, we hardcoded global/use_lvmetad=0 as default value in lvmconf script. Howeverm this default may change by just flipping the value in config_settings.h and we may forget to edit the lvmconf. It's better to use lvm dumpconfig --type default global/use_lvmetad to get the actual default value and use this one instead of hardcoded one. 2015-04-13 16:27:17 +03:00			`.BR \-\-disable-halvm`
			`Set \fBlocking_type\fR to the default non-clustered type. Also reset`
			`lvmetad use to its default.`
			`.TP`
			`.BR \-\-enable-halvm`
			`Set \fBlocking_type\fR suitable for HA LVM use.`
			`Also disable lvmetad use as it is not yet supported in HA LVM environment.`
			`.TP`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`.BR \-\-file " <" \fIconfigfile >`
			`Apply the changes to \fIconfigfile\fP instead of the default`
			`\fI#DEFAULT_SYS_DIR#/lvm.conf\fP.`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.TP`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`.BR \-\-lockinglib " <" \fIlib >`
Various cleanups following recent commits. 2010-06-21 19:56:57 +04:00			`Set external \fBlocking_library\fR locking library to load if an external locking type is used.`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.TP`
Update man pages Use one style for man pages. 2012-04-11 16:42:10 +04:00			`.BR \-\-lockinglibdir " <" \fIdir >`
lvmconf: add --enable-halvm, --disable-halvm, --services, --mirrorservice, --startstopservices options and use proper global/use_lvmetad default value This patch adds new options to lvmconf: --enable-halvm (just like --enable-cluster, but configure LVM for use in HA LVM - meaning disabling lvmetad and making sure we have locking_type=1) --disable-halvm (just like --disable-cluster, but configure LVM back from HA LVM - meaning enabling lvmetad if it's enabled by default and making sure we have default locking type set) --services (causes clvmd and lvmetad services to be enabled or disabled appropriately and conforming to the changes in lvm configuration we've just made with lvmconf) --mirrorservice (in addition to clvmd and lvmetad services, also enable or disable cmirrord service appropriately; this is a separate option because cmirrord is optional and it doesn't need to be always enabled when clvmd is enabled) --startstopservices (in addition to enabling or disabling services, start and stop these services immediately) These options are supposed to help users to make their system ready for cluster with clvmd (active-active) or HA LVM (active-passive) use while lvmconf script can handle services as well so users don't need to bother about setting them manually. Also, before this patch, we hardcoded global/use_lvmetad=0 as default value in lvmconf script. Howeverm this default may change by just flipping the value in config_settings.h and we may forget to edit the lvmconf. It's better to use lvm dumpconfig --type default global/use_lvmetad to get the actual default value and use this one instead of hardcoded one. 2015-04-13 16:27:17 +03:00			`.TP`
			`.BR \-\-services`
			`In addition to setting the lvm configuration, also enable or disable related Systemd or SysV`
man: lvmconf: more notes on --services option 2015-04-14 10:49:56 +03:00			`clvmd and lvmetad services. This script does not configure services provided by cluster resource`
			`agents.`
lvmconf: add --enable-halvm, --disable-halvm, --services, --mirrorservice, --startstopservices options and use proper global/use_lvmetad default value This patch adds new options to lvmconf: --enable-halvm (just like --enable-cluster, but configure LVM for use in HA LVM - meaning disabling lvmetad and making sure we have locking_type=1) --disable-halvm (just like --disable-cluster, but configure LVM back from HA LVM - meaning enabling lvmetad if it's enabled by default and making sure we have default locking type set) --services (causes clvmd and lvmetad services to be enabled or disabled appropriately and conforming to the changes in lvm configuration we've just made with lvmconf) --mirrorservice (in addition to clvmd and lvmetad services, also enable or disable cmirrord service appropriately; this is a separate option because cmirrord is optional and it doesn't need to be always enabled when clvmd is enabled) --startstopservices (in addition to enabling or disabling services, start and stop these services immediately) These options are supposed to help users to make their system ready for cluster with clvmd (active-active) or HA LVM (active-passive) use while lvmconf script can handle services as well so users don't need to bother about setting them manually. Also, before this patch, we hardcoded global/use_lvmetad=0 as default value in lvmconf script. Howeverm this default may change by just flipping the value in config_settings.h and we may forget to edit the lvmconf. It's better to use lvm dumpconfig --type default global/use_lvmetad to get the actual default value and use this one instead of hardcoded one. 2015-04-13 16:27:17 +03:00			`.TP`
			`.BR \-\-mirrorservice`
			`Also enable or disable optional cmirrord service when handling services (applicable only with \-\-services).`
			`.TP`
			`.BR \-\-startstopservices`
			`In addition to enabling or disabling related services, start or stop them immediately`
			`(applicable only with \-\-services).`
Add man pages for lvmconf and unsupported lvmsadc and lvmsar tools. 2010-06-18 14:19:29 +04:00			`.SH FILES`
			`.I #DEFAULT_SYS_DIR#/lvm.conf`

			`.SH "SEE ALSO"`
			`.BR lvm (8),`
			`.BR lvm.conf (5)`