feature command

This command manages licensing for advanced features for the advanced management module.

Table 1. feature command
Function	What it does	Command	Valid targets
Display feature list and license status	Displays a list of advanced features for the management module and their licensing status.	`feature`	`-T system:mm[x]` where x is the primary management-module bay number.
Add a feature license	Adds a license for a management module advanced feature. Features on this list are specified using the feature index number that appears at the left of the feature list.	`feature` -index `-add -key` lisc_key where: index is the number for the feature at the left of the feature list displayed by the `feature` command. lisc_key is the 7-character part number of the feature. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis administration See Commands and user authority for additional information.	`-T system:mm[x]` where x is the primary management-module bay number.
Remove a feature license	Removes a license for a management module advanced feature. Features on this list are specified using the feature index number that appears at the left of the feature list.	`feature` -index `-remove` where index is the number for the feature at the left of the feature list displayed by the `feature` command. This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis administration See Commands and user authority for additional information.	`-T system:mm[x]` where x is the primary management-module bay number.
Import datacenter feature licenses	Import a datacenter feature licensing file for use by the BladeCenter unit. The file name to import must specify a qualified location for the licensing file that indicates the protocol to be used. For example, tftp://192.168.0.1/license.csv	`feature -apply` file_location where file_location is a qualified location for the license file of up to 256 characters in length that indicates the protocol to be used (tftp, ftp, ftps, http, or https) and contains any character except the percent sign ( % ) or double-quote ( ″ ). This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis administration See Commands and user authority for additional information.	`-T system:mm[x]` where x is the primary management-module bay number.
Export datacenter feature licenses	Export a BladeCenter feature licensing file for use by other BladeCenter units in the datacenter. The file name to export must specify a qualified location for the licensing file that indicates the protocol to be used. For example, tftp://192.168.0.1/license.csv Note: While the licensing file is exporting, a string of periods will display on the screen to indicate progress; a new period being added every three seconds.	`feature -retrieve` file_location where file_location is a qualified location for the license file of up to 256 characters in length that indicates the protocol to be used (tftp, ftp, ftps, http, or https) and contains any character except the percent sign ( % ) or double-quote ( ″ ). This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis administration See Commands and user authority for additional information.	`-T system:mm[x]` where x is the primary management-module bay number.

Example: To view the feature list, while the BladeCenter unit is set as the persistent command environment, at the system:> prompt, type

                  feature -T mm[1]

To remove the license for the first feature in the list, while the BladeCenter unit is set as the persistent command environment, at the system> prompt, type

               feature -T mm[1] -1 -remove

To export a licensing file to the location tftp://10.11.20.23/IBMtest.csv, while the BladeCenter unit is set as the persistent command environment, at the system> prompt, type

               feature -retrieve -T mm[1] tftp://10.11.20.23/IBMtest.csv

The following example shows the information that is returned from these commands:

               system> feature -T mm[1]
1. IBM BladeCenter Open Fabric Manager
-serial 2304369
License Status: Active
system> feature -T mm[1] -1 -remove
OK
system> feature -T mm[1]
1. IBM BladeCenter Open Fabric Manager
License Status: No License
system> feature -retrieve -T mm[1] tftp://10.11.20.23/IBMtest.csv
................
OK
system>