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

Parameters

None

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.

The ID value is an incremental number (from 0 to 320) representing the feature number. Each ID represents either a license key associated with a feature type or an inactive feature with no associated license key. A single inactive entry represents features that (can, but) have no activated licenses. Other than a single inactive entry, license slots that have no associated licenses have an ID number but are not displayed.

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.
mtm Indicates the machine type and model.

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.