---

HMC Manual Reference Pages  - CHLICKEY (1)

---

chlickey - change license key information

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

chlickey -m managed-system -o a {-p partition-name | --id partition-ID}
{-a "attributes" | -f file} [-l {disk | sftp | usb}] [-d directory]
[-h host-name] [-u user-ID] [--passwd password] [-k SSH-private-key]
[--help]

chlickey adds license key information to a running IBM i partition.

-m	The name of the managed system which has the IBM i partition to which to add license key information. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-o	The operation to perform. The only valid value is a to add license key information.
-p	The name of the IBM i partition for which to perform the operation. You can either use this option to specify the name of the partition for which to perform the operation, or use the --id option to specify the partition’s ID. The -p and the --id options are mutually exclusive.
--id	The ID of the IBM i partition for which to perform the operation. You can either use this option to specify the ID of the partition for which to perform the operation, or use the -p option to specify the partition’s name. The --id and the -p options are mutually exclusive.
-a	The license key information to add. The information consists of attribute name/value pairs, which are in comma separated value (CSV) format. The information must be enclosed in double quotes. The format of the information is as follows: attribute-name=value,attribute-name=value,... Valid attribute names: prdid lictrm Specify in Vx, VxRy, or VxRyMz format, where x and y can be a number from 0 through 9, and z can be a number from 0 through 9 or a letter from A through Z feature [serial] Defaults to *LOCAL [prcgrp] Specify in Pxx format where xx is a number from 00 to 99 Defaults to 999 usglmt Specify *NOMAX for no limit [expdate] Specify in 1YYMMDD format Defaults to 9999999 which correlates to *NONE [vnddta] Defaults to blank which correlates to *NONE lickey The -a and the -f options are mutually exclusive.
-f	The name of the license key file. The -a and the -f options are mutually exclusive.
-l	The location of the license key file. Valid values are disk for the HMC hard disk, sftp for a remote secure FTP (SFTP) server, and usb for a USB data storage device. If the location of the license key file is on a USB data storage device, the device must be connected to the HMC and must be mounted with the mount command before this command is issued. The lsmediadev command can be used to display the mount point for the USB device. This option is required when a license key file is used. Otherwise, this option is not valid.
-d	The directory that contains the license key file. This option is required when the license key file is located on a USB data storage device. If the license key file is located on the HMC hard disk or a remote SFTP server, this option defaults to the user’s home directory if not specified.
-h	The host name or IP address of the SFTP server where the license key file is located. This option is required when the license key file is located on a remote SFTP server. Otherwise, this option is not valid.
-u	The user ID to use to log in to the SFTP server. This option is required when the license key file is located on a remote SFTP server. Otherwise, this option is not valid.
--passwd	The password to use to log in to the SFTP server. If both this option and the -k option are omitted and the license key file is located on a remote SFTP server, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. This option is only valid when the license key file is located on a remote SFTP server.
-k	The name of the file that contains the SSH private key. If the file name is not fully qualified, the file must exist in the user’s home directory on the HMC. Use the ssh-keygen command to generate the public and private SSH key pair. The ssh-keygen command is not allowed to write to the .ssh directory in the user’s home directory on the HMC, so when you run the command on the HMC, you must specify both the directory and the file name for the private key. If you generate a key with a passphrase, you will be prompted to enter the passphrase when you run any HMC command that uses the key. If both this option and the --passwd option are omitted and the license key file is located on a remote SFTP server, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when the license key file is located on a remote SFTP server.
--help	Display the help text for this command and exit.

Add the specified license key information:

chlickey -m sys1 -o a -p i1 -a "prdid=1MYPROD,lictrm=V3,usglmt=1,
feature=5101,lickey=1234567890ABCDEF12"

Add license key information from a file on a remote SFTP server (you will be prompted to enter the user’s password):

chlickey -m 9080-M9S*1234567 -o a --id 1 -f licKeyFile -l sftp
-h sftpserver -u sftpuser -d /home/sftpuser/lickeys

Add license key information from a file on a remote SFTP server and use SSH keys for authentication:

chlickey -m sys1 -o a -p lp-i-1 -f licKeyFile -l sftp -h 9.3.123.25
-u sftpuser -k /home/hmcuser/keys/id_rsa

Add license key information from a file on a USB data storage device (the USB device must already be connected to the HMC):

lsmediadev (to obtain mount points)

mount /media/sdb1

chlickey -m sys1 -o a -p p1 -f licKeyFile -l usb -d /media/sdb1

None

None

IBM Austin

lsmediadev