HMC Manual Reference Pages - LSLIC (1)

NAME

lslic - list Licensed Internal Code levels

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

lslic {-m managed-system | -e managed-frame [--allsystems] | -w | -c}
[-t {sys | power | syspower | powerfru | sriov}]
[-r {ibmwebsite | ftp | sftp | dvd | disk | mountpoint | usb}
[-h host-name] [-u user-ID] [--passwd password] [-k SSH-private-key]
[-d directory]
[-F [attribute-names] [--header]] [--help]

DESCRIPTION

lslic lists Licensed Internal Code (LIC) levels installed, activated, and accepted. The LIC levels that are available to be retrieved from a repository can also be listed.
lslic can also list the LIC levels currently in the management console hard disk repository.

OPTIONS

-m The name of the managed system for which LIC levels are to be listed. 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.

-e The name of the managed frame for which LIC levels are to be listed. The name may either be the user-defined name for the managed frame, 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 frame. The tttt-mmm*sssssss form must be used if there are multiple managed frames with the same user-defined name.

--allsystems List Licensed Internal Code levels on all managed systems in the managed frame specified with the -e option.

-w List Licensed Internal Code levels for all managed frames which contain High Performance Switches.

-c List Licensed Internal Code levels currently in the management console hard disk repository.

-t The type of LIC levels to list. Valid values are sys for Managed System LIC levels only, power for Power LIC levels only, syspower for both Managed System and Power LIC levels, powerfru for Power FRU levels, or sriov for Single Root I/O Virtualization (SR-IOV) adapter levels.
If this option is omitted, it will default to syspower for the -m and -e --allsystems options, and to power for the -e and -w options. This option is not allowed with the -c option.

-r The repository to query for LIC levels that are available to be retrieved. Valid values are ibmwebsite for the IBM service website, ftp for a remote FTP site, sftp for a remote secure FTP (SFTP) site, dvd for the DVD drive on the management console, disk for the internal hard disk drive on the management console, mountpoint for the specified mount point on the internal hard disk drive on the management console, or usb for a USB flash memory device.

-h The host name or IP address of the remote FTP or SFTP server.
This option is required when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site. This option is not valid otherwise.

-u The user ID to use to log in to the remote FTP or SFTP site.
This option is required when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site. This option is not valid otherwise.

--passwd The password to use to log in to the remote FTP or SFTP site.
If this option is omitted when displaying LIC levels that are available to be retrieved from a remote FTP site, you will be prompted to enter the password. If both this option and the -k option are omitted when displaying LIC levels that are available to be retrieved from a remote SFTP site, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive.
This option is only valid when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site.

-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 management console.
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 management console, so when you run the command on the management console, 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 management console command that uses the key.
If both this option and the --passwd option are omitted when displaying LIC levels that are available to be retrieved from a remote SFTP site, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive.
This option is only valid when displaying LIC levels that are available to be retrieved from a remote SFTP site.

-d The directory to use on the remote FTP or SFTP site, or the mount point location on the internal management console hard disk drive. If this option is not specified for FTP or SFTP, the /opt/ccfw/data directory will be used.
This option is only valid when displaying LIC levels that are available to be retrieved from a mount point or a remote FTP or SFTP site.

-F A delimiter separated list of attribute names for the desired attribute values to be displayed for each LIC level. If no attribute names are specified, then values for all of the attributes for each LIC level will be displayed.
When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option.
This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.

--header Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.

--help Display the help text for this command and exit.

EXAMPLES

Display Managed System LIC levels:
lslic -t sys -m mysystem
Display Power LIC levels:
lslic -t power -m 9406-570*1020304
Display Managed System and Power LIC levels and display levels available on the IBM service website:
lslic -t syspower -m mysystem -r ibmwebsite
Display Managed System LIC levels and display levels available from a remote FTP server:
lslic -t sys -m mysystem -r ftp -h ftphost.domainname
-u myuser --passwd mypasswd
Display Managed System LIC levels and display levels available from a remote SFTP server using SSH keys for authentication:
lslic -t sys -m system1 -r sftp -h sftpServer -u user1
-k /home/hmcuser1/keys/id_rsa -d liclevels/840
Display Managed System and Power LIC levels for all managed systems in the managed frame:
lslic -e myframe --allsystems -t syspower
Display LIC levels for all managed frames which contain High Performance Switches:
lslic -w
Display LIC levels for all managed frames which contain High Performance Switches and display levels available on the IBM service website:
lslic -w -r ibmwebsite
Display Power FRU levels for a managed system:
lslic -m mysystem -t powerfru
Display Power FRU levels for a managed frame:
lslic -e 9458-100*02AB33C -t powerfru
Display Power FRU levels for all managed frames which contain High Performance Switches:
lslic -w -t powerfru
Display the firmware levels for all SR-IOV adapters in a managed system:
lslic -t sriov -m mysystem
Display the LIC levels currently in the management console hard disk repository:
lslic -c

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

HMC Manual Reference Pages - LSLIC (1)

NAME

CONTENTS

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

ENVIRONMENT

BUGS

AUTHOR

SEE ALSO

-m	The name of the managed system for which LIC levels are to be listed. 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.
-e	The name of the managed frame for which LIC levels are to be listed. The name may either be the user-defined name for the managed frame, 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 frame. The tttt-mmm*sssssss form must be used if there are multiple managed frames with the same user-defined name.
--allsystems	List Licensed Internal Code levels on all managed systems in the managed frame specified with the -e option.
-w	List Licensed Internal Code levels for all managed frames which contain High Performance Switches.
-c	List Licensed Internal Code levels currently in the management console hard disk repository.
-t	The type of LIC levels to list. Valid values are sys for Managed System LIC levels only, power for Power LIC levels only, syspower for both Managed System and Power LIC levels, powerfru for Power FRU levels, or sriov for Single Root I/O Virtualization (SR-IOV) adapter levels. If this option is omitted, it will default to syspower for the -m and -e --allsystems options, and to power for the -e and -w options. This option is not allowed with the -c option.
-r	The repository to query for LIC levels that are available to be retrieved. Valid values are ibmwebsite for the IBM service website, ftp for a remote FTP site, sftp for a remote secure FTP (SFTP) site, dvd for the DVD drive on the management console, disk for the internal hard disk drive on the management console, mountpoint for the specified mount point on the internal hard disk drive on the management console, or usb for a USB flash memory device.
-h	The host name or IP address of the remote FTP or SFTP server. This option is required when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site. This option is not valid otherwise.
-u	The user ID to use to log in to the remote FTP or SFTP site. This option is required when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site. This option is not valid otherwise.
--passwd	The password to use to log in to the remote FTP or SFTP site. If this option is omitted when displaying LIC levels that are available to be retrieved from a remote FTP site, you will be prompted to enter the password. If both this option and the -k option are omitted when displaying LIC levels that are available to be retrieved from a remote SFTP site, you will be prompted to enter the password. The --passwd and -k options are mutually exclusive. This option is only valid when displaying LIC levels that are available to be retrieved from a remote FTP or SFTP site.
-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 management console. 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 management console, so when you run the command on the management console, 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 management console command that uses the key. If both this option and the --passwd option are omitted when displaying LIC levels that are available to be retrieved from a remote SFTP site, you will be prompted to enter the password. The -k and --passwd options are mutually exclusive. This option is only valid when displaying LIC levels that are available to be retrieved from a remote SFTP site.
-d	The directory to use on the remote FTP or SFTP site, or the mount point location on the internal management console hard disk drive. If this option is not specified for FTP or SFTP, the /opt/ccfw/data directory will be used. This option is only valid when displaying LIC levels that are available to be retrieved from a mount point or a remote FTP or SFTP site.
-F	A delimiter separated list of attribute names for the desired attribute values to be displayed for each LIC level. If no attribute names are specified, then values for all of the attributes for each LIC level will be displayed. When this option is specified, only attribute values will be displayed. No attribute names will be displayed. The attribute values displayed will be separated by the delimiter which was specified with this option. This option is useful when only attribute values are desired to be displayed, or when the values of only selected attributes are desired to be displayed.
--header	Display a header record, which is a delimiter separated list of attribute names for the attribute values that will be displayed. This header record will be the first record displayed. This option is only valid when used with the -F option.
--help	Display the help text for this command and exit.