stasadm — STorage Appliance Services admin functions
stasadm
[OPTIONS...] {COMMAND} [OPTIONS...]
stasadm is used to configure nvme-stas
. The
configuration is saved to /etc/stas/sys.conf
.
Although nvme-stas
' configuration is saved to
/etc/stas/sys.conf
, it's still possible to
interoperate with the configuration of nvme-cli
and libnvme. nvme-stas
allows to
save individual parameters such as the Host NQN and ID outside of
/etc/stas/sys.conf
. This allows, for example,
using the same default Host NQN and ID defined by
nvme-cli and libnvme in
/etc/nvme/hostnqn
and /etc/nvme/hostid
respectively. To tell nvme-stas
that you want to use the
those files, simply use stasadm's
--file=FILE
option.
The following commands are understood:
Generate the Host NQN. This is typically used as a post
installation step to generate /etc/nvme/hostnqn
.
The NVMe base specifications says: “An NQN is
permanent for the lifetime of the host”. For
this reason, the host NQN should only be generated
if /etc/nvme/hostnqn
does not exist
already.
Generate the Host ID. This is typically used as a post
installation step to generate /etc/nvme/hostid
.
Although not explicitly specified in the NVMe
specifications, the Host ID, like the Host NQN, should
be permanent for the lifetime of the host. Only generate
the Host ID if /etc/nvme/hostid
does not exist.
Set the host symbolic name.
The symbolic name is an optional parameter that can be used for explicit registration with a discovery controller.
Clear the host symbolic name.
The following options are understood:
-h
, --help
--version
-fFILE
, --file=FILE
By default, hostnqn and hostid
save the values to /etc/stas/sys.conf
.
This option allows saving to a separate file.
Traditionally, nvme-cli and
libnvme retrieve the default Host NQN
and ID from /etc/nvme/hostnqn
and
/etc/nvme/hostid
respectively. The
--file=FILE
option can be
used to tell nvme-stas
that it should
use those same configuration files.