SLAPI is a command-line tool that communicates with Spectra Logic tape libraries using their XML command reference. This provides a simple way to administer and monitor Spectra Logic tape libraries in large data centers.
In order to use SLAPI, you must have python3 installed on your system. On RHEL distributions, it would be simplest to ensure your systems have the EPEL repository enabled. Our RHEL7-based systems have python34 installed.
$ yum install python34-requests
<snip>
===============================================================================
Package Arch Version Repository Size
===============================================================================
Installing:
python34-requests noarch 2.12.5-3.el7 epel 110 k
Installing for dependencies:
python34-chardet noarch 2.3.0-5.el7 epel 237 k
python34-idna noarch 2.7-2.el7 epel 108 k
python34-pysocks noarch 1.6.8-6.el7 epel 30 k
python34-six noarch 1.11.0-3.el7 epel 33 k
python34-urllib3 noarch 1.19.1-5.el7 epel 132 k
Transaction Summary
===============================================================================
Install 1 Package (+5 Dependent packages)
<snip>
Unless overridden by --config, SLAPI will pick up a system-wide configuration file in /etc/slapi.conf or a user-specific configuration file in ~/.slapi/slapi.conf.
The configuration file is a simple INI file. If you specify --server, the section with that exact same name will be read; if you do not specify a server, the [DEFAULT] section will be read instead and the server key in that section will be used. Do not specify server in named sections; it will not override what you pass on the CLI.
Keys that are not specified in named sections will fall back to the key in [DEFAULT] if present there.
The following keys are supported in each section:
| Key | Notes |
|---|---|
| username | REQUIRED. On CLI, this is --user. |
| password | REQUIRED. Allowed to be empty (but the key must still be present). The escape character is %, so a percent sign in your password will need to be escaped as %%. |
| server | Does NOT override --server, so it's best to not specify this outside of [DEFAULT]. |
| port | Port on which to communicate with the library. Default is 443, or 80 if insecure=true. |
| insecure | Communicate with the library over http:// instead of https://. true or false; defaults to false (use https://). |
| verbose | Increase the verbosity for the output. true or false. |
Comments are allowed, the comment prefix is #.
Here is a sample configuration file with two libraries:
[DEFAULT]
server = tfinity01.mydomain.com
username = su
# % escaped as %%
password = ThisPwdHasOnlyOne%%.
verbose = false
insecure = true
[theoneweneveruse.mydomain.com]
username = su
password = supersecret!In this example, library theoneweneveruse will also use insecure (http://) communications, because it inherits the insecure key from [DEFAULT] (as well as the verbose key).
Currently the documentation for SLAPI is provided with the help option.
$ slapi --help
See CONTRIBUTING.md
SPDX-License-Identifier: GPL-2.0-or-later
LLNL-CODE-769480