numam-spdk/doc/spdkcli.md
Karol Latecki 3d8a0b19b0 doc: Fix Markdown MD032 linter warnings
"MD032 Lists should be surrounded by blank lines"
Fix this markdown linter error by inserting newlines or
adjusting text to list points using spaces.

Signed-off-by: Karol Latecki <karol.latecki@intel.com>
Change-Id: I09e1f021b8e95e0c6c58c393d7ecc11ce61c3132
Signed-off-by: Karol Latecki <karol.latecki@intel.com>
Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/434
Tested-by: SPDK CI Jenkins <sys_sgci@intel.com>
Reviewed-by: Shuhei Matsumoto <shuhei.matsumoto.xt@hitachi.com>
Reviewed-by: Tomasz Zawadzki <tomasz.zawadzki@intel.com>
Reviewed-by: Maciej Wawryk <maciejx.wawryk@intel.com>
2020-02-06 09:46:06 +00:00

1.8 KiB

SPDK CLI

Spdkcli is a command-line management application for SPDK. Spdkcli has support for a limited number of applications and bdev modules, and should be considered experimental for the v18.04 release. This experimental version was added for v18.04 to get early feedback that can be incorporated as spdkcli becomes more fully-featured for the next SPDK release.

Install needed dependencies

All dependencies should be handled by scripts/pkgdep.sh script. Package dependencies at the moment include:

  • configshell

Run SPDK application instance

./scripts/setup.sh
./app/vhost/vhost -c vhost.conf

Run SPDK CLI

Spdkcli should be run with the same privileges as SPDK application. In order to use SPDK CLI in interactive mode please use:

scripts/spdkcli.py

Use "help" command to get a list of available commands for each tree node.

It is also possible to use SPDK CLI to run just a single command, just use the command as an argument to the application. For example, to view current configuration and immediately exit:

scripts/spdkcli.py ls

Optional - create Python virtual environment

You can use Python virtual environment if you don't want to litter your system Python installation.

First create the virtual environment:

cd spdk
mkdir venv
virtualenv-3 ./venv
source ./venv/bin/activate

Then install the dependencies using pip. That way dependencies will be installed only inside the virtual environment.

(venv) pip install configshell-fb

Tip: if you are using "sudo" instead of root account, it is suggested to do "sudo -s" before activating the environment. This is because venv might not work correctly when calling spdkcli with sudo, like "sudo python spdkcli.py" - some environment variables might not be passed and you will experience errors.