targetd_lsmplugin - Man Page

libStorageMgmt targetd plugin

Description

LibStorageMgmt targetd plugin allows user to manage storage using the targetd storage API [1]. The 'targetd_lsmplugin' executable file is for libStorageMgmt daemon to execute when client user specifies targetd plugin in the URI.

URI

To use this plugin, users should set their URI to this format:

    # HTTP connection
    targetd://<username>@<targetd_server>:<port number>

    # HTTPS connection
    targetd+ssl://<username>@<targetd_server>:<port number>

    # HTTPS connection with certificate file
    targetd+ssl://<username>@<targetd_server>:<port number>?ca_cert_file=<full path and filename>

    # HTTPS connection disabling all certificate checks (not recommended for production)
    targetd+ssl://<username>@<targetd_server>:<port number>?no_ssl_verify=yes
username

The username is the user account configured in targetd configuration file.

targetd_server

The targetd_server is the IP address or DNS name of server running targetd daemon.

port number

The port number is the listening port of the targetd daemon.  The default port of 18700 is used if none is supplied on the URI.

URI parameters

These URI parameters are supported by this plugin:

ca_cert_file=<certificate file>

This URI parameter is for SSL connections only.  For those users that utilize a self signed certificate you can pass the path and file to the certificate that should be used to verify the server certificate.

no_ssl_verify=yes

This URI parameter is for SSL connections only. With this URI parameter, the targetd plugin will not validate servers SSL certificate. It's often used for self-signed CA environment, but it's strongly suggested to remove this URI parameter and install self-signed CA properly, or use cert_file parameter instead.

Supported Software

Linux targetd 0.7.1 or later version. Detailed support status can be queried via:

* lsm.Client.capabilities()  (Python API)
* lsm_capabilities()         (C API)
* lsmcli capabilities        (lsmcli command line).

Firewall Rules

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

See Also

lsmcli(1), lsmd(1), [1] https://github.com/agrover/targetd

Bugs

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

Author

Gris Ge <fge@redhat.com>
Tony Asleson <tasleson@redhat.com>

Info

July 2017 targetd_lsmplugin 1.9.8 libStorageMgmt