lsfeature

Use the lsfeature command to list the features that are available for the current system code release. You can also list trial or entitlement information and license keys.

Syntax

lsfeature [ -delimdelimiter ] [ -nohdr ] [ -bytes ]

Parameters

-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
-bytes
(Optional) Displays all capacities as bytes.

Description

This command lists the features that are available for the current system code release. You can also list trial or entitlement information and license keys.

If the feature is unlicensed, a single entry for the feature (showing it as inactive) is displayed. If the feature has licenses that are activated, a new row is displayed for each license that is associated with that feature.

The status of all of keys for any feature are the same. For example, this means that all encryption license keys are displayed as inactive until all enclosures that require a license are licensed. Once licensed, all encryption license keys are displayed as active.

This table provides the attribute values that can be displayed as output view data.
Table 1. lsfeature outputs
Attribute Possible Values
id Indicates the unique ID (2-character) feature number.
name Indicates the feature name with a 16-character alphanumeric string:
  • easy_tier
  • remote_mirroring
  • flashcopy_upgrade
  • turbo_performance
  • encryption
state Indicates the current state of the feature:
  • active
  • inactive
  • trial_available
  • trial_active
  • trial_expired
license_key Indicates the key that is used in feature activation with a string that consists of 16 hexadecimal characters that are organized in four groups of four numbers with each group that is separated by a hyphen (such as 0123-4567-89AB-CDEF).
trial_expiration_date Indicates the trial expiration date as long as the state is trial_available or trial_active. This value is displayed in the format YYYYMMDD.
serial_num Indicates the product serial number if the enclosure associated with the license key can be determined.
mtm Indicates the machine type and model if the enclosure associated with the license key can be determined.
Note: A license key's association with an enclosure can be determined if:
  • The enclosure that is associated with the key contains at least one node that is added to the cluster and the node is either online of offline at the time the view is queried.
  • The enclosure that is associated with the key contains at least one node that is a candidate for clustered system membership. The node must be online at the time the view is being queried.

An invocation example

lsfeature

The resulting output:

id name              state           license_key          trial_expiration_date   serial_num mtm
0  turbo_performance trial_available                      20130201
1  easy_tier         trial_active                         20130101
2  flashcopy_upgrade active          0123-4567-89AB-CDEF
3  remote_mirroring  trial_expired                        20130201

An invocation example

In this system, both licenses are for encryption. There are two control enclosures, and the serial number and machine type are displayed:

lsfeature

The resulting output:

id name       state  license_key         trial_expiration_date serial_num mtm
0  encryption active 90AB-D41D-C799-2EF4                       78G00TT    2076-624
1  encryption active 3A87-463E-B5DF-9969                       31G00KG    2076-624

If one of the licenses is removed:

lsfeature

The resulting output:

id name       state    license_key         trial_expiration_date serial_num mtm
0  encryption inactive 90AB-D41D-C799-2EF4                       78G00TT    2076-624

The state is inactive because control enclosures require their own license to activate encryption.