1targetd_lsmplugin(1) libStorageMgmt targetd_lsmplugin(1)
2
3
4
6 targetd_lsmplugin -- libStorageMgmt targetd plugin
7
8
10 LibStorageMgmt targetd plugin allows user to manage storage using the
11 targetd storage API [1]. The 'targetd_lsmplugin' executable file is for
12 libStorageMgmt daemon to execute when client user specifies targetd
13 plugin in the URI.
14
15
17 To use this plugin, users should set their URI to this format:
18
19 # HTTP connection
20 targetd://<username>@<targetd_server>:<port number>
21
22 # HTTPS connection
23 targetd+ssl://<username>@<targetd_server>:<port number>
24
25 # HTTPS connection with certificate file
26 targetd+ssl://<username>@<targetd_server>:<port number>?ca_cert_file=<full path and filename>
27
28 # HTTPS connection disabling all certificate checks (not recommended for production)
29 targetd+ssl://<username>@<targetd_server>:<port number>?no_ssl_verify=yes
30
31
32
33 username
34
35 The username is the user account configured in targetd configu‐
36 ration file.
37
38
39 targetd_server
40
41 The targetd_server is the IP address or DNS name of server run‐
42 ning targetd daemon.
43
44
45 port number
46
47 The port number is the listening port of the targetd daemon.
48 The default port of 18700 is used if none is supplied on the
49 URI.
50
51
52 URI parameters
53 These URI parameters are supported by this plugin:
54
55
56
57 ca_cert_file=<certificate file>
58 This URI parameter is for SSL connections only. For
59 those users that utilize a self signed certificate you
60 can pass the path and file to the certificate that should
61 be used to verify the server certificate.
62
63
64 no_ssl_verify=yes
65 This URI parameter is for SSL connections only. With this
66 URI parameter, the targetd plugin will not validate
67 servers SSL certificate. It's often used for self-signed
68 CA environment, but it's strongly suggested to remove
69 this URI parameter and install self-signed CA properly,
70 or use cert_file parameter instead.
71
72
74 Linux targetd 0.7.1 or later version. Detailed support status can be
75 queried via:
76
77 * lsm.Client.capabilities() (Python API)
78 * lsm_capabilities() (C API)
79 * lsmcli capabilities (lsmcli command line).
80
81
83 By default, this plugin requires access to the targetd server's TCP
84 18700 port.
85
86
88 lsmcli(1), lsmd(1), [1] https://github.com/agrover/targetd
89
90
92 Please report bugs to <libstoragemgmt-devel@lists.sourceforge.net>
93
94
96 Gris Ge <fge@redhat.com>
97 Tony Asleson <tasleson@redhat.com>
98
99
100
101targetd_lsmplugin 1.9.4 July 2017 targetd_lsmplugin(1)