lsfeature

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

Syntax

 lsfeature  [  -delim  delimiter  ]   [  -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 possible 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 one-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 clustered system (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 activated, a new row is displayed for each license associated with that feature.

The status of all of keys for any given 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 used in feature activation with a string consisting of 16 hexadecimal characters organized in four groups of four numbers with each group 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 must be 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 associated with the key contains at least one node that has been added to the cluster and the node is either online of offline at the time the view is queried.
  • The enclosure associated with the key contains at least one node that is currently 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 2 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-112
1  encryption active 3A87-463E-B5DF-9969                       31G00KG    2076-124

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

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