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.
Attribute | Possible Values |
---|---|
id | Indicates the unique ID (2-character) feature number. |
name | Indicates the feature name with a 16-character alphanumeric string:
|
state | Indicates the current state of the feature:
|
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. |
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.