lsmcli(1)
NAME
lsmcli - libStorageMgmt command line interface
SYNOPSIS
lsmcli command [GLOBAL OPTIONS]...[COMMAND OPTIONS]...
DESCRIPTION
lsmcli is the command line tool for the libStorageMgmt library. This tool allows users to do one off storage related management operations or to script management of their storage.
PREREQUISITES
* libStorageMgmt daemon.
The daemon 'lsmd' is required by lsmcli.
* URI(Uniform Resource Identifier)
URI is used to identify which plugin to use and how the plugin
should communicate with the storage array. The valid URI format
is:
plugin://<username>@host:<port>?<query_string_parameters>
plugin+ssl://<username>@host:<port>?<query_string_parameters>
Examples, please refer to "LibStorageMgmt User Guide" for more
details:
* Simulator:
sim://
simc://
* NetApp ONTAP:
ontap://username@host
ontap+ssl://username@host
* SMI-S supported arrays (eg. EMC CX/VNX, HDS AMS, IBM
SVC/DS, LSI MegaRAID and others):
smis://username@host:<port>?namespace=<namespace>
smis+ssl://username@host:<port>?namespace=<namespace>
You can pass URI to lsmcli via one of these methods:
* Using '-u, --uri' argument.
* Using 'LSMCLI_URI' environment variable.
* Add this line into $HOME/.lsmcli:
uri=<URI>
* Password
For storage array password authentication you can pass it to
lsmcli via one of the following methods:
* '-P, --prompt' argument to prompt for password.
* 'LSMCLI_PASSWORD' environment variable.
GLOBAL OPTIONS
--version Show program's version number and exit
-h, --help Show this help message and exit. Will show help message
of specific command if specified.
-u <URI>, --uri <URI>
Uniform Resource Identifier (env LSMCLI_URI)
-P, --prompt Prompt for password (env LSMCLI_PASSWORD)
-H, --human Print sizes in human readable format (e.g., KiB, MiB,
GiB, TiB, PiB, EiB)
-t <SEP>, --terse <SEP>
Print output in terse form with "SEP" as a record
separator without header unless '--header' defined.
--header Include the header with terse
-e, --enum Display enumerated types as numbers instead of text
-f, --force Bypass confirmation prompt for data loss operations
-w <WAIT>, --wait=<WAIT>
Command timeout value in ms (default = 30s)
-b Run the command asynchronously instead of waiting for
completion. The lsmcli command will exit with exit
code(7) and job id will be written to STDOUT when a
command is still executing on the storage array. Use
'job-status --id <job id>' to inquire on the progress of
the command. Some arrays or plugins might not support
asynchronous operations, in those circumstances, -b will
be ineffective. Command will wait until finished.
-s, --script Displaying data in script friendly way.
Without this option, data is displayed in this manner
(default):
ID | Name | Element Type ...
------------------------------------------ ...
aggr0 | aggr0 | FS,SYSTEM_RESERVED,POOL ...
iscsi | iscsi | FS,POOL ...
With this option, data is displayed in this manner.
-----------------------------------------------
ID | aggr0
Name | aggr0
Element Type | FS,SYSTEM_RESERVED,POOL
...
-----------------------------------------------
ID | iscsi
Name | iscsi
Element Type | FS,POOL
...
Please note:
To reduce the width of output, NOT all properties will
be displayed in default column display.
COMMANDS
list
List information on LSM objects
--type <TYPE> Required. Valid values are (case insensitive):
VOLUMES, POOLS, FS, SNAPSHOTS, EXPORTS, NFS_CLIENT_AUTH,
ACCESS_GROUPS, SYSTEMS, DISKS, PLUGINS, TARGET_PORTS.
--fs <FS_ID> Required for --type=SNAPSHOTS. List the snapshots of
certain filesystem. PLUGINS will list all supported
plugins of LSM, not only the current one.
--sys <SYS_ID> Search resources from system with SYS_ID. Only supported
when querying these types of resources: VOLUMES, POOLS,
FS, SNAPSHOTS, DISKS, ACCESS_GROUPS.
--pool <POOL_ID>
Search resources from pool with POOL_ID. Only supported
by these types of resources: VOLUMES, POOLS, FS.
--vol <VOL_ID> Search resources from volume with VOL_ID. Only supported
by these types of resources: VOLUMES, ACCESS_GROUPS.
To query volume masking status, please use this command:
lsmcli list --type ACCESS_GROUPS --vol <VOL_ID>
--disk <DISK_ID>
Search resources from disk with DISK_ID. Only supported
by these types of resources: DISK.
--ag <AG_ID> Search resources from access group with AG_ID. Only
supported by these types of resources: ACCESS_GROUPS,
VOLUMES.
To query volume masking status, please use this command:
lsmcli list --type VOLUMES --ag <AG_ID>
--fs <FS_ID> Search resources from file system with FS_ID. Only
supported by these types of resources: FS.
--nfs-export <NFS_EXPORT_ID>
Search resources from NFS export with NFS_EXPORT_ID.
Only supported by these types of resources: EXPORTS.
--tgt <TGT_ID> Search resources from target port with target port ID.
Only supported by these types of resources:
TARGET_PORTS.
job-status
Retrieve information about a job. Please see user guide on how to use.
--job <JOB_ID>
capabilities
Retrieves array capabilities.
--sys <SYS_ID> Required. ID of the system to query for capabilities.
plugin-info
Retrieves plugin description and version for current URI.
volume-create
Creates a volume (AKA., logical volume, virtual disk, LUN).
--name <NAME> Required. Volume name.
--size <SIZE> Required. Volume size (See SIZE OPTION for allowed
formats).
--pool <POOL_ID>
Required. ID of pool.
--provisioning <THINP_TYPE>
Optional. Provisioning type. Valid values are: DEFAULT,
THIN, FULL. DEFAULT means let plugin choose. THIN means
requiring a Thin Provisioning enabled volume. FULL means
requiring a fully allocated volume.
volume-raid-create
Creates a volume on hardware RAID on given disks.
--name <NAME> Required. Volume name. Might be altered or ignored due
to hardware RAID card vendor limitation.
--raid-type <RAID_TYPE>
Required. Could be one of these values: RAID0, RAID1,
RAID5, RAID6, RAID10, RAID50, RAID60. The supported RAID
types of current RAID card could be queried via command
"volume-raid-create-cap".
--disk <DISK_ID>
Required. Repeatable. The disk ID for new RAID group.
--strip-size <STRIP_SIZE>
Optional. The size in bytes of strip on each disks. If
not defined, will let hardware card to use the vendor
default value. The supported stripe size of current RAID
card could be queried via command "volume-raid-create-
cap".
volume-raid-create-cap
Query support status of volume-raid-create command for current hardware
RAID card.
--sys <SYS_ID> Required. ID of the system to query for capabilities.
volume-delete
Delete a volume given its ID
--vol <VOL_ID> Required. The ID of volume to delete.
volume-resize
Re-sizes a volume, requires:
--vol <VOL_ID> Required. The ID of volume to resize.
--size <NEW_SIZE>
Required. The new size of volume.(See SIZE OPTION for
allowed formats). Due to boundary alignment concern,
array might return a volume with slightly bigger size
than requested.
volume-replicate
Creates a new volume and replicates provided volume to it.
--vol <VOL_ID> Required. The ID of volume to replicate.
--name <NAME> Required. The name for new volume to hold replicated
data.
--rep-type <REPL_TYPE> (see VOLUME REPLICATION TYPES)
Required. Valid types of replication are:
CLONE, COPY, MIRROR_ASYNC, MIRROR_SYNC.
--pool <POOL_ID>
Optional. The ID of pool where the new volume should be
created from. If not specified, plugin or array will
choose appropriate pool.
volume-replicate-range
Replicates a portion of a volume to the same volume or to a different
volume.
--src-vol <SRC_VOL_ID>
Required. The ID of replication source volume.
--dst-vol <DST_VOL_ID>
Required. The ID of replication destination volume.
--rep-type <REPL_TYPE> (see VOLUME REPLICATION TYPES)
Required. Appropriate types of replication are:
CLONE, COPY.
--src-start <SRC_START_BLK>
Required. Replication source volume start block number.
Must in pair with --count and --dst-start. If you have
several non-continuous block ranges, you can define
repeatly define this arugument, like '--src-start 0
--dst-start 0 --count 1024 --src-start 2048 --dst-start
2048 --count 2048'
--dst-start <DST_START_BLK>
Required. Replication destination volume start block
number. Must in pair with --count and --src-start.
--count <BLK_COUNT>
Required. The count of replicated block startting from
--src-startblock. Must in pair with --src-start and
--dst-start.
volume-replicate-range-block-size
Size of each replicated block on a system in bytes.
--sys <SYS_ID> Required. ID of the system to query for replicated block
size.
volume-dependants
Returns True if volume has a dependant child, like replication.
--vol <VOL_ID> Required. The ID of volume to query dependency.
volume-dependants-rm
Removes volume dependencies(like replication).
--vol <VOL_ID> Required. The ID of volume to remove dependency.
volume-access-group
Lists the access group(s) that have access to the provided volume.
--vol <VOL_ID> Required. The ID of volume to query access.
volume-mask
Grant access group RW access to certain volume. Like LUN masking
or NFS export.
--vol <VOL_ID> Required. The ID of volume to access.
--ag <AG_ID> Required. The ID of access group to grant.
volume-unmask
Revoke access group RW access to specified volume.
--vol <VOL_ID> Required. The ID of volume to revoke.
--ag <AG_ID> Required. The ID of access group to revoke.
volume-raid-info
Query RAID information for given volume.
--vol <VOL_ID> Required. The ID of volume to query.
pool-member-info
Query RAID information for given pool.
--pool <POOL_ID>
Required. The ID of pool to query.
access-group-create
Create an access group.
--name <AG_NAME>
Required. The human friendly name for new access group.
--init <INIT_ID>
Required. The first initiator ID of new access group.
WWPN or iSCSI IQN.
--sys <SYS_ID> Required. The ID of system where this access group
should reside on.
access-group-add
Adds an initiator to an access group.
--ag <AG_ID> Required. ID of access group.
--init <INIT_ID>
Required. ID of initiator to add. WWPN or iSCSI IQN.
access-group-remove
Removes an initiator from an access group.
--ag <AG_ID> Required. ID of access group.
--init <INIT_ID>
Required. ID of initiator to remove.
access-group-delete
Delete an access group.
--ag <AG_ID> Required. ID of access group to delete.
access-group-volumes
Lists the volumes that the access group has been granted access to.
--ag <AG_ID> Required. The ID of access group to query.
iscsi-chap
Configures ISCSI inbound/outbound CHAP authentication.
--init <INIT_ID>
Required. The ID of iSCSI initiator to configure.
--in-user <IN_USER>
Optional. Inbound CHAP user name.
--in-pass <IN_PASS>
Optional. Inbound CHAP password.
--out-user <OUT_USER>
Optional. Outbound CHAP user name.
--out-pass <OUT_PASS>
Optional. Outbound CHAP password.
fs-create
Creates a filesystem.
--name <NAME> Required. Human friendly name for new filesystem.
--size <SIZE> Required. Volume size(See SIZE OPTION for allowed
formats).
--pool <POOL_ID>
Required. ID of pool to hold the new filesystem.
fs-delete
Delete a filesystem.
--fs <FS_ID> Required. ID of the filesystem to delete.
fs-resize
Resizes a filesystem.
--fs <FS_ID> Required. ID of the filesystem to resize.
--size <NEW_SIZE>
Required. New size of filesystem. See SIZE OPTION for
allowed formats.
fs-export
Export a filesystem via NFS.
--fs <FS_ID> Required. ID of the filesystem to export.
--exportpath <EXPORT_PATH>
Optional. NFS server export path. e.g. '/foo/bar'.
--anonuid <ANONY_UID>
Optional. The UID(User ID) to map to anonymous user.
--anongid <ANONY_GID>
Optional. The GID(Group ID) to map to anonymous user.
--auth-type <AUTH_TYPE>
Optional. NFS client authentication type. This is just a
place holder, not supported yet.
--root-host <ROOT_HOST>
Optional. Repeatable. The host/IP has root access. For
two or more hosts/IPs:
--ro-host <RO_HOST>
Optional. Repeatable. The host/IP has read only access.
For two or more hosts/IPs: '--ro-host hostA --ro-host
hostB'.
--rw-host <RW_HOST>
Optional. The host/IP has read/write access. For two or
more hosts/IPs:
fs-unexport
Remove an NFS export.
--fs <FS_ID> Required. ID of the filesystem to unexport.
fs-clone
Creates a file system clone. The 'clone' means point in time read
writeable space efficient copy of data, AKA. read-writable snapshot.
--src-fs <SRC_FS_ID>
Required. The ID of the filesystem to clone.
--dst-name <DST_FS_NAME>
Required. The name for newly created destination file
system.
--backing-snapshot <BE_SS_ID>
Optional. Make a FS clone using a previously created
snapshot.
fs-snap-create
Creates a snapshot of specified filesystem. A snapshot is defined as a
read only space efficient point in time copy (PIT) of a filesystem.
The source filesystem remains modifiable.
--name <SNAP_NAME>
Required. The human friendly name of new snapshot.
--fs <FS_ID> Required. The ID of filesystem to create snapshot
against.
fs-snap-delete
Deletes a snapshot.
--snap <SNAP_ID>
Required. The ID of snapshot to delete.
--fs <FS_ID> Required. The ID of filesystem.
fs-snap-restore
Restores a FS or specified files to previous snapshot state. This will
discard all the changes to filesystem since snapshot if specific files
are not specified in restore.
--fs <FS_ID> Required. The ID of filesystem to restore.
--snap <SNAP_ID>
Required. The ID of snapshot to restore.
--file <FILE_PATH>
Optional. Repeatable. With this option defined, will
only restore the defined file(s).
--fileas <NEW_FILE_PATH>
Optional. Repeatable. With this option defined, the
restored file will be saved to specified path and
filename, eg. '--file fileA --fileas old_fileA '.
fs-dependants
Returns True if a child dependency (snapshot or clone) exists.
--fs <FS_ID> Required. The ID of filesystem to query.
--file <FILE_PATH>
Optional. Repeatable. Only check for dependencies on
specific file(s), eg. '--file fileA --file pathB'.
fs-dependants-rm
Removes filesystem dependencies(snapshot or clone).
--fs <FS_ID> Required. The ID of filesystem to remove dependency.
--file <FILE_PATH>
Optional. Repeatable. Only remove dependencies on
specific file(s), eg. '--file fileA --file pathB'.
file-clone
Creates a clone of a file (thin provisioned). Note: --src and --dst
need to be paired
eg. '--src fileA --src fileB --dst fileA_clone --dst fileB_clone'.
--src <SRC_FILE_PATH>
Required. Repeatable. Source file to clone (relative
path).
--dst <DST_FILE_PATH>
Required. Repeatable. Destination file for clone
(relative path).
ALIAS
ls
Alias of 'list --type systems'
lp
Alias of 'list --type pools'
lv
Alias of 'list --type volumes'
ld
Alias of 'list --type disks'
la
Alias of 'list --type access_groups'
lf
Alias of 'list --type fs'
lt
Alias of 'list --type target_ports'
c
Alias of 'capabilities'
p
Alias of 'plugin-info'
vc
Alias of 'volume-create'
vrc
Alias of 'volume-raid-create'
vrcc
Alias of 'volume-raid-create-cap'
vd
Alias of 'volume-delete'
vr
Alias of 'volume-resize'
vm
Alias of 'volume-mask'
vu
Alias of 'volume-unmask'
vri
Alias of 'volume-raid-info'
pmi
Alias of 'pool-member-info'
ac
Alias of 'access-group-create'
aa
Alias of 'access-group-add'
ar
Alias of 'access-group-remove'
ad
Alias of 'access-group-delete'
SIZE OPTION
--size <SIZE>
Storage space size. Format is '<number>' + '<prefix>'. Example:
"10GiB", "20.5MB". No postfix indicates bytes. Valid prefixes are:
KiB, # 2^10 Bytes
MiB, # 2^20 Bytes
GiB, # 2^30 Bytes
TiB, # 2^40 Bytes
PiB, # 2^50 Bytes
EiB, # 2^60 Bytes
KB, # 10^3 Bytes
MB, # 10^6 Bytes
GB, # 10^9 Bytes
TB, # 10^12 Bytes
PB, # 10^15 Bytes
EB, # 10^17 Bytes
These prefixes are supported also, but not recommended:
K, M, G, T, P, E, # equal to KiB, MiB, and etc
k, m, g, t, p, e, # equal to KiB, MiB, and etc
FILES
~/.lsmcli lsmcli configuration file, containing name-value pairs
separated by '='. The only currently supported
configuration option is 'uri', such as
'uri=ontap://user@filer.example.com'.
Configuration options in .lsmcli are only used if not
overridden by command-line option or environment
variable.
EXAMPLES (command output omitted for brevity)
Simulator, list pools (no password required)
$ lsmcli -u sim:// -l POOLS
NetApp, list volumes (prompting for password)
$ lsmcli -u ontap://root@host/ -l VOLUMES -P
SMI-S, list systems (prompting for password)
$ lsmcli -u smispy://username@host:5988/?namespace=root/interop \
-l SYSTEMS -P
Targetd, list pools (using env variables for URI and password)
$ export LSMCLI_URI=targetd://username@host:18700
$ export LSMCLI_PASSWORD=<password>
$ lsmcli -l POOLS
NexentaStor, create volume (using environment variables for URI and
password)
$ export LSMCLI_URI='nstor://user@host'
$ export LSMCLI_PASSWORD=<password>
$ lsmcli volume-create --name volume_name --size 1TiB --pool default
SMI-S, create volume (using environment variables for URI and password)
$ export LSMCLI_URI='smispy+ssl://user@host:5989?namespace=root/emc'
$ export LSMCLI_PASSWORD=<password>
$ lsmcli volume-create --name volume_name --size 1TiB --pool default
ENVIRONMENT
LSMCLI_URI The URI for the storage array in question. LSMCLI_PASSWORD The password to use for the array.
VOLUME REPLICATION TYPES
CLONE A point in time, read writeable, space efficent copy
of data.
COPY A full bitwise copy of the data. It occupies the full
space.
MIRROR_SYNC Continously updated, realtime with both copies having
identical data.
MIRROR_ASYNC Continously updated, with a varying amount of delay
and data delta between the source and target.
NOTES
Plugin installation
Plugins are installed individually except for the simulators
which are always included.
Secure sockets layer (SSL)
All of the plugins (except the simulator) support SSL when
communicating from the plugin to the array. This is
accomplished by adding "+ssl" to the plugin and usually by
selecting a different port number from non-SSL communications.
$ lsmcli -u smispy+ssl://username@host:5989/?namespace=interop \
list --type SYSTEMS -P
SSL error: certificate verify failed
When using SMI-S plugin with SSL against self-signed SMI-S
provider, lsmcli normally quit with 'SSL error: certificate
verify failed'. Please contact SMI-S provider support to setup
the self-signed certificate in your system. If you prefer to
bypass the certificate check, add 'no_ssl_verify=yes' at the
end of URI, for example:
smispy+ssl://admin@emc-smi:5989?namespace=root/emc&no_ssl_verify=yes
BUGS
Please report bugs to <libstoragemgmt-devel@lists.fedorahosted.org>
AUTHOR
Tony Asleson <tasleson@redhat.com> Gris Ge <fge@redhat.com>
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
