local_lsmplugin(1)

✨ NAME ✨

local_lsmplugin — the LibstorageMgmt Local Pseudo plugin, aka the friend who knows everybody and handles the intros 💅

---

🦋 DESCRIPTION 🦋

Okay so picture this: you wanna manage your local storage system but you do NOT wanna deal with figuring out which real plugin is supposed to handle it. That's literally the whole point of the LibStorageMgmt local plugin, bestie. It does the matchmaking for you.

The local_lsmplugin executable file is the thing the libStorageMgmt daemon runs when a client user specifies the local plugin in the URI. It's giving backstage pass energy.

Right now, the local plugin wraps these plugins:

• MegaRAID plugin — megariad_lsmplugin(1).
• SmartArray plugin — hpsa_lsmplugin(1).
• Adaptec plugin — arcconf_lsmplugin(1).
• NFS plugin — nfs_lsmplugin(1).

Heads up: a specific binary tool may be required for some of these! 👀 Please check the error message or the manpage of the plugins listed above.

Also, to load the NFS plugin, the kernel module nfsd should be loaded. Not optional, no cap. 🌸

---

🌈 URI 🌈

To use this plugin, you set your URI to this format:

local://

or

local://?parameter_name=<value>

💖 URI parameters 💖

These URI parameters are supported by this plugin:

• ignore_init_error=true — this one tells the plugin to ignore errors when initializing real plugins. But listen: if no valid system is found, an error will still be raised. So it's not a free pass, it's a "let's keep going anyway" pass. By default, all errors will be raised.
• only=<plugin_name> — this forces the local plugin to load only one specific real plugin. Very main character, very "I only work with these people." By default, all plugins will be loaded if supported hardware has been found.
• <plugin_name>_<uri_parameter_name>=<value> — this format is how you pass URI parameters down to a real plugin. For example, to pass the storcli=/usr/bin/storcli URI parameter to the MegaRAID plugin, you would use megaraid_storcli=/usr/bin/storcli. See how the plugin name gets glued onto the front? 🫶 That's the whole trick.

---

👑 ROOT PRIVILEGE 👑

This plugin requires both the lsmd daemon and the API client running as root user. Both. Not one. Both. 😭

Please check manpage lsmd.conf(5) for details.

---

⭐ SUPPORTED HARDWARES ⭐

Please refer to these manpages for the hardware support status:

• MegaRAID plugin — megariad_lsmplugin(1).
• SmartArray plugin — hpsa_lsmplugin(1).
• Adaptec plugin — arcconf_lsmplugin(1).
• NFS plugin — nfs_lsmplugin(1).

Wanna get the detailed support status? Query it like this, bestie:

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

---

🔥 FIREWALL RULES 🔥

This plugin only executes tools on localhost. No network connection required. Zero. None. Your firewall can stay unbothered, it's not that kind of party. 💜

---

🎀 SEE ALSO 🎀

lsmcli(1), lsmd(1)

---

🙈 BUGS 🙈

Please report bugs to <libstoragemgmt-devel@lists.fedorahosted.org>

(Yes, actually email them. They're nice, I promise.)

---

🌸 AUTHOR 🌸

Gris Ge <fge@redhat.com>

---

And that's the whole page, babe — local_lsmplugin version 1.10.3, from way back in July 2017, still iconic, still doing the most so you don't have to. 🧚✨