# stasadm

stasadm

1

stasadm

STorage Appliance Services admin functions

                stasadm
                OPTIONS
                COMMAND
                OPTIONS

## Description

`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 one 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.

## Commands

The following commands are understood:

`hostnqn`

- 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.

`hostid`

- 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-symname [SYMNAME]`

- Set the host symbolic name.

  The symbolic name is an optional parameter that can be used for explicit registration with a discovery controller.

`clear-symname`

- Clear the host symbolic name.

## Options

The following options are understood:

`-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.

## Exit status

On success, 0 is returned; otherwise, a non-zero failure code is returned.

## Examples

### Generate `/etc/nvme/hostnqn`

    $ stasadm hostnqn --file /etc/nvme/hostnqn

### Generate `/etc/nvme/hostid`

    $ stasadm hostid -f /etc/nvme/hostid

### Configure the host's symbolic name

    $ stasadm set-symname LukeSkywalker

## See Also

nvme-stas

7