activatefeature

Use the activatefeature command to activate a feature such as encryption (using a license key or keyfile) or feature trial period.

Syntax

activatefeature [ -trial { feature_id | feature_name } ] [ -licensekey key ] [ -licensekeyfile filepath ]

Parameters

-trialfeature_id | feature_name

(Optional) Activates the trial period for the feature of the specified ID that uses an unsigned 16-bit integer:

Valid integer values are 0, 1, and 3.
Valid names are turbo_performance, easy_tier, and remote_mirroring.

-licensekeykey

(Optional) Provides the license key to activate a feature that contains 16 hexadecimal characters organized in four groups of four numbers with each group separated by a hyphen (such as 0123-4567-89AB-CDEF).

-licensekeyfilefilepath

(Optional) Provides the full path-to-file containing all required license information by using an alphanumeric string that contains 1 - 256 characters.

Description

All parameters are mutually exclusive.

When encryption is enabled, license keys must be added to the system before a candidate enclosure can be added to that system.

A license key file can contain one or more license keys. If you specify a key file, every key in the file is applied to the system. The license key is checked against the node or control enclosure serial number, machine type, and model. If no valid keys exist in the file, the command cannot complete successfully on the system. If you cannot apply a key successfully to the system, the command adds any remaining keys.

You must have one key for each node or control enclosure. Specify activatefeature -licensekeyfile with an .xml file that contains all node or control enclosure keys. Or, specify activatefeature -licensekey one time per node or control enclosure.

If a feature is already activated and you activate a feature again by using a key, the command completes successfully.

Remember:

You cannot complete a trial when a feature is activated.
You can activate a feature while a trial is in progress.

An invocation example

activatefeature -trial 1

The resulting output:

Activation of a trial is a one time operation.  Are you sure you wish to continue? Yes

An invocation example

activatefeature -licensekey 0123-4567-89AB-CDEF

The resulting output:

No feedback

An invocation example

activatefeature -licensekeyfile /tmp/keyfile.xml

The resulting output:

No feedback