targetd_lsmplugin(1)

1targetd_lsmplugin(1)            libStorageMgmt            targetd_lsmplugin(1)
2
3
4

NAME

6       targetd_lsmplugin -- libStorageMgmt targetd plugin
7
8

DESCRIPTION

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

URI

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

SUPPORTED SOFTWARE

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

FIREWALL RULES

83       By  default,  this  plugin  requires access to the targetd server's TCP
84       18700 port.
85
86

BUGS

92       Please report bugs to <libstoragemgmt-devel@lists.sourceforge.net>
93
94

AUTHOR

96       Gris Ge <fge@redhat.com>
97       Tony Asleson <tasleson@redhat.com>
98
99
100
101targetd_lsmplugin 1.6.2            July 2017              targetd_lsmplugin(1)