'\" t
.\"     Title: udisks2_lsm.conf
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: March 2016
.\"    Manual: UDisks2 LSM Module Configuration
.\"    Source: udisks2_lsm.conf 2.6.2
.\"  Language: English
.\"
.TH "UDISKS2_LSM\&.CONF" "5" "March 2016" "udisks2_lsm\&.conf 2\&.6\&.2" "UDisks2 LSM Module Configurati"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
udisks2_lsm.conf \- The UDisks2 LSM Module configuration file
.SH "DESCRIPTION"
.PP
The lsm module of UDisks2 uses
\fILibStorageMgmt\fR[1] API to provides
\fBorg\&.freedesktop\&.UDisks2\&.Drive\&.LSM\fR
interface with RAID information for external(DAS or SAN) Linux disk drive\&. Please refer to storage interface document for detail\&.
.PP
Some storage system requires extra configuration in
\fI/etc/udisks2/modules\&.conf\&.d/udisks2\&.conf\fR\&.
.SH "CONFIGURATION FILE"
.PP
.PP
\fBrefresh_interval = <integer>\fR
.RS 4
.PP
The option controls how many seconds should this module refresh the RAID information cache\&. If not defined, the default value is 30 (seconds)\&.
.RE
.PP
\fBenable_sim = true|false\fR
.RS 4
.PP
This option indicates whether lsm module should try simulator of LibStorageMgmt\&. This is only for developer\&. If not defined, the default value is false(do not enable simulator of LibStorageMgmt)\&. If enabled, the
\fBsim://\fR
URI will be used to query LibStorageMgmt simulator plugin\&.
.RE
.PP
\fBenable_hpsa = true|false\fR
.RS 4
.PP
This option indicates whether lsm module should check HP SmartArray\&. If not defined, the default value is true(check HP SmartArray)\&.
.PP
To be functional, also requires
\fBlibstoragemgmt\-hpsa\-plugin\fR
package be installed and well configured\&. Please refer to the
\fIhpsa_lsmplugin(1)\fR
manpage for detail\&.
.PP
If enabled, the
\fBhpsa://\fR
URI will be used to query LibStorageMgmt HP SmartArray plugin\&.
.RE
.PP
\fBextra_uris= ["uri_string_1", "uri_string_2"]\fR
.RS 4
.PP
This option defines extra LibStorageMgmt URI list here\&. Please refer to
\fILibStorageMgmt User Guide[3]\fR
for URI format\&.
.PP
Require double quoted string and separated by comma, example:
.sp
.if n \{\
.RS 4
.\}
.nf
              extra_uris = ["ontap+ssl://root@ontap\&.a\&.ip", "ontap+ssl://root@ontap\&.b\&.ip"]
            
.fi
.if n \{\
.RE
.\}
.sp
If not defined, empty list(no extra URI loaded) will be used\&.
.RE
.PP
\fBextra_passwords = ["password_string_1", "password_string_2"]\fR
.RS 4
.PP
This options defines the passwords of above URI list\&. Please use double quoted string and separated by comma, example:
.sp
.if n \{\
.RS 4
.\}
.nf
              extra_paasswords = ["password1", "password2"]
            
.fi
.if n \{\
.RE
.\}
.sp
.RE
.SH "HARDWARE SUPPORT STATUS"
.PP
Any hardwares which are supported in LibStorageMgmt with these capabilities will get fully support by UDisks2 LSM module:
.PP
* \fBVOLUMES capabilityes\fR with valid VPD83 information,
.RS 4
.RE
.PP
* \fBVOLUME_RAID_INFO\fR capabilities\&.
.RS 4
.RE
.PP
Please refer to LibStorageMgmt document website[2] for support status\&.
.PP
Tested hardwares are:
.PP
\fBHP SmartArray\fR
.RS 4
.PP
Using
\fBlibstoragemgmt\-hpsa\-plugin\fR
package\&.
.RE
.PP
\fBNetApp ONTAP\fR
.RS 4
.PP
Using
\fBlibstoragemgmt\-netapp\-plugin\fR
package\&.
.RE
.SH "AUTHOR"
.PP
Gris Ge
<fge@redhat\&.com>
.SH "BUGS"
.PP
Please send bug reports to either the distribution bug tracker or the upstream bug tracker at
\m[blue]\fB\%https://github.com/storaged-project/storaged/issues\fR\m[]\&.
.SH "SEE ALSO"
.PP
\fBlsmd\fR(1),
\fBudisksd\fR(8),
\fBhpsa_lsmplugin\fR(1),
\fBontap_lsmplugin\fR(1),
.PP
.PP
[1]: \m[blue]\fB\%https://github.com/libstorage/libstoragemgmt\fR\m[]
.RS 4
.RE
.PP
[2]: \m[blue]\fB\%http://libstorage.github.io/libstoragemgmt-doc\fR\m[]
.RS 4
.RE
.PP
[3]: \m[blue]\fB\%http://libstorage.github.io/libstoragemgmt-doc/doc/user_guide.html\fR\m[]
.RS 4
.RE