uicfg command

This command displays and configures the management module user interface settings.

Table 1. uicfg command
Function What it does Command Valid targets
Display management module user interface settings Displays the user interface settings for the management module. Returned values indicate enabled or disabled status for the following interfaces:
  • -cli
  • -snmp
  • -tcm (TCP command mode)
  • -stcm (secure TCP command mode)
  • -web (web interface)
 uicfg 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable command-line interface Enables or disables the management module command-line interface (using Telnet or SSH). uicfg -cli state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable SNMPv1 and SNMPv3 Enables or disables SNMPv1 and SNMPv3 connections to the management module. uicfg -snmp state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable TCP command mode Enables or disables TCP command mode (used by IBM Systems Director) for the management module. uicfg -tcm state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set number of TCP command mode connections Enable or disable the TCP command mode, or sets the maximum number of connections explicitly.
Note: Any number of connections (1 through 20) displays a status of enabled. Zero connections displays a status of disabled.
uicfg -tcm port_mode

where port_mode is enabled (1 connection), disabled (no connections), or a number between 0 and 20, inclusive, that indicates the maximum number of non-secure TCP session connections.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable secure TCP command mode Enables or disables secure TCP command mode (used by IBM Systems Director) for the management module. uicfg -stcm state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Set number of secure TCP command mode connections Enable or disable the secure TCP command mode, or sets the maximum number of connections explicitly.
Notes:
  • On a write operation, the maximum number of connections can be set explicitly (0-20), or it can be enabled (1 connection) or disabled (0 connections).
  • On a read operation, disabled means 0 connections, and enabled means 1 or more connections.
  • The total session count of TCM and STCM is limited to 20.
uicfg -stcm port_mode

where port_mode is enabled (1 connection), disabled (no connections), or a number between 0 and 20, inclusive, that indicates the maximum number of secure TCP session connections.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Enable / disable web interface Enables or disables the management module web interface. uicfg -web state

where state is enabled or disabled.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
                           -T system:mm[x]

where x is the primary management-module bay number.
Example: To disable Secure TCP command mode for the management module, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  uicfg -stcm disabled
To display the user interface configuration for the management module, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
                  uicfg

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

               system:mm[1]> uicfg -stcm disabled
Warning: Communication with IBM Systems Director via Secure TCP Command Mode
has been disabled.
OK
system:mm[1]> uicfg
-cli enabled (telnet only)
-snmp enabled
-stcm enabled
-tcm disabled
-web enabled
system:mm[1]>
Parent topic: Command syntax