ports command

This command sets and displays the network port configuration settings for the CMM and I/O modules.

Note:
  • Changes to the -ftpe, -snmp1ae, -snmp3ae, -snmpte, -sshe, -ftpp, -ftpdp, -httpp, -httpsp, -snmpap, -snmptp, -sshp, -tcme, -telnete, -telnetp, -telnett, or -tftpp settings become active immediately. Changes to the remaining settings become active after the next reset of the CMM.
  • The CMM HTTP and HTTPS ports are open at all times. Port behavior is determined by the CMM HTTPS port setting, which can be affected by the CMM chassis security policy setting:
    • When the CMM HTTPS port is enabled, the HTTP port (port 80) remains open and redirects to the HTTPS port (port 443). When the chassis security policy is set to secure, the CMM HTTPS port is automatically enabled and its setting cannot be changed.
    • When the CMM HTTPS port is disabled, the HTTPS port (port 443) remains open and redirects to the HTTP port (port 80).

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or ports command errors for a list of error messages that are specific to the ports command.

Table 1. ports command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display network port settings Displays the network port settings for the CMM. Returned values are:
  • -cimp cim_prt_num
  • -ftpp FTP_prt_num
  • -ftpdp FTP_data_prt_num
  • -httpp HTTP_prt_num
  • -httpsp HTTPS_prt_num
  • -slpp SLP_prt_num
  • -snmpap SNMP_agent_prt_num
  • -snmptp SNMP_traps_prt_num
  • -sshp SSH_prt_num
  • -stcmp secure_tcmp
  • -tcmp TCP_cmd_md_port
  • -telnetp _Telnet_prt_num
  • -tftpp TFTP_prt_num
  • -cime cim_prt_state
  • -ftpe FTP_state
  • -sftpe sec_FTP_state
  • -httpse HTTPS_prt_state
  • -ntpe NTP_state
  • -slpe SLP_state.
  • -snmp1ae SNMPv1_agent_state
  • -snmp3ae SNMPv3_agent_state
  • -snmpte SNMP_traps_state
  • -sshe SSH_prt_state
  • -stcme secure_TCP_cmd_mode
  • -tcme TCP_cmd_mode_state
  • -telnete Telnet_prt_state-
  • -tftpe TFTP_state
  • -ftpt FTP_timeout
  • -tcmt TCP_cmd_mode_timeout
  • -telnett Telnet_prt_timeout
Note:
  • The following will not be available if the CMM chassis security level is set to secure with the security command:
    • HTTP
    • FTP
    • SNMPv1
    • Telnet
    • TFTP
    • Non-secure TCP command mode
  • HTTPSE can only be disabled by disabling all web access using the uicfg command.
 ports
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display open CMM ports Displays the CMM ports that are currently open.
Note: The following will not be available if the CMM security level is set to secure with the security command:
  • HTTP
  • FTP
  • SNMPv1
  • Telnet
  • TFTP
  • Non-secure TCP command mode
 ports -open
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Reset network port settings Resets all network port settings for the CMM to the default values. Default values are:
  • -ftpp: 21
  • -ftpdp: 20
  • -cimp: 5989
  • -httpp: 80
  • -httpsp: 443
  • -slpp: 427
  • -tcmp: 6090
  • -snmpap: 161
  • -snmptp: 162
  • -sshp: 22
  • -stcmp: 6091
  • -telnetp: 23
  • -tftpp: 69
Note: The following will not be available if the CMM security level is set to secure with the security command:
  • HTTP
  • FTP
  • SNMPv1
  • Telnet
  • TFTP
  • Non-secure TCP command mode
 ports -reset
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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set FTP port number Sets the port number for the CMM FTP port.
Note:
  • The FTP port will not be available if the CMM chassis security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -ftpp FTP_prt_num

where FTP_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set FTP data port number Sets the port number for the CMM FTP data port.
Note:
  • The FTP data port will not be available if the CMM chassis security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -ftpdp FTP_data_prt_num

where FTP_data_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set HTTP port number Sets the port number for the CMM HTTP port.
Note:
  • The HTTP port will not be available if the CMM security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -httpp HTTP_prt_num

where HTTP_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set HTTPS port number Sets the port number for the CMM HTTPS port.
Note:
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -httpsp HTTPS_prt_num

where HTTPS_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set CIM port number over HTTPS Sets the port number for using the CMM common information model (CIM) over HTTPS.
Note:
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -cimp cim_prt_num

where cim_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set SLP port number Sets the SLP port number.
Note:
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -slpp SLP_prt_num

where SLP_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set SNMP agent port number Sets the port number for the CMM SNMP agent port.
Note:
  • SNMPv1 ports will not be available if the CMM security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -snmpap SNMP_agent_prt_num

where SNMP_agent_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set SNMP traps port number Sets the port number for the CMM SNMP traps port.
Note:
  • SNMPv1 ports will not be available if the CMM security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -snmptp SNMP_traps_prt_num

where SNMP_traps_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set command mode port number Sets the TCP command mode port number.
Important: The optional Flex System Manager software requires this port to be 6090.
Note:
  • Non-secure TCP command mode ports will not be available if the CMM security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -tcmp TCP_cmd_md_prt_num

where TCP_cmd_md_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set secure command mode port number Sets the secure TCP command mode port number.
Note:
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -stcmp secure_tcmp

where secure_tcmp is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set SSH port number Sets the port number for the CMM SSH port.
Note:
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -sshp SSH_prt_num

where SSH_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set Telnet port number Sets the port number for the CMM Telnet port.
Note:
  • The Telnet port will not be available if the CMM chassis security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -telnetp Telnet_prt_num

where Telnet_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set TFTP port number Sets the port number for the CMM TFTP port.
Note:
  • The TFTP port will not be available if the CMM security level is set to secure with the security command.
  • You cannot configure a port to a number that is already in use.
  • Changes to port numbers take effect immediately.
  • Changing port numbers will affect ongoing operations using the service at that port.
 ports -tftpp TFTP_prt_num

where TFTP_prt_num is from 1 to 65535, inclusive. If you enter a value outside this range, an error will be displayed.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable FTP Enables or disables FTP for the CMM.
Note: The FTP port can not be enabled if the CMM chassis security level is set to secure with the security command.
 ports -ftpe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable SFTP Enables or disables secure FTP for the CMM. ports -sftpe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable HTTPS port Enables or disables the CMM HTTPS port.
Note: Disabling the HTTPS port automatically enables HTTP.
 ports -httpse state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable CIM over HTTPS Enables or disables CIM over HTTPS for the CMM. ports -cime state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable NTP Enables or disables NTP for the CMM. ports -ntpe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disables SLP Enables or disables SLP for the CMM. ports -slpe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable SNMPv1 agent Enables or disables the SNMPv1 agent for the CMM.
Note: The SNMPv1 agent can not be enabled if the CMM chassis security level is set to secure with the security command.
 ports -snmp1ae state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable SNMPv3 agent Enables or disables the SNMPv3 agent for the CMM. ports -snmp3ae state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable SNMP traps Enables or disables the SNMP traps for the CMM. ports -snmpte state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable SSH port Enables or disables the CMM SSH port. ports -sshe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable TCP command mode and set number of connections Turns the TCP command mode on or off, or sets the maximum number of connections explicitly.
Note:
  • Any number of connections (1 through 20) displays a status of on. Zero connections displays a status of off.
  • Non-secure TCP command mode can not be enabled if the CMM chassis security level is set to secure with the security command.
  • The total session count of TCM and STCM is limited to 20.
ports -tcme port_mode

where port_mode is on (1 connection), off (no connections), or a number between 0 and 20, inclusive, that indicates the maximum number of 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable secure TCP command mode and set number of connections Turns the secure TCP command mode on or off, or sets the maximum number of connections.
Note:
  • On a write operation, the maximum number of connections can be set explicitly (0-20), or it can be turned on (1 connection) or off (0 connections).
  • On a read operation, off means 0 connections, and on means 1 or more connections.
  • The total session count of TCM and STCM is limited to 20.
ports -stcme port_mode

where port_mode is on (1 connection), off (no connections), or a number between 0 and 20, inclusive, that indicates the maximum number of 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable Telnet port Enables or disables the CMM Telnet port.
Note: Telnet can not be enabled if the CMM chassis security level is set to secure with the security command.
 ports -telnete state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Enable / disable TFTP Enables or disables TFTP for the CMM.
Note: TFTP can not be enabled if the CMM security level is set to secure with the security command.
 ports -tftpe state

where state is on or off .

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set FTP timeout Sets the FTP timeout value for the CMM. ports -ftpt timeout

where timeout is from 0 seconds (no timeout) to 4294967295 seconds, inclusive.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set TCP command-mode timeout Sets the TCP command-mode timeout value for the CMM. ports -tcmt timeout

where timeout is from 0 seconds (no timeout) to 4294967295 seconds, inclusive.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set Telnet port timeout Sets the Telnet port timeout value for the CMM. ports -telnett timeout

where timeout is from 0 seconds (no timeout) to 4294967295 seconds, inclusive.

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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display network port settings for I/O module Displays the network port settings for the I/O module. These settings can include:
  • cable compatibility
  • cable length
  • cable type
  • data rate
  • label
  • port index
  • port media
  • port width
  • protocol
  • speed
  • speed setting
  • available speeds
  • state
  • state setting
  • type
  • vendor
Note: Other device specific values might be returned.
 ports
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Enable or disable port for I/O module Enables or disables specified port on specified I/O module. ports -port_index -state state
where
  • port_index is from 1 to 65535, inclusive.
  • state is on or off .
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.
Sets speed of port for I/O module Sets speed of specified port on I/O modules that support this feature. ports -port_index -speed speed_setting

where

  • port_index is from 1 to 65535, inclusive.
  • speed_setting specifies the port speed, in terms of:
    • multiplier
    • units, m or g for megabits or gigabits
    • duplex mode, h or f for half or full
    For example:
    • 100mh sets the port speed to 100 Mbps half-duplex.
    • 10gf sets the port speed to 10 Gbps full-duplex.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • I/O module configuration
See Commands and user authority for additional information.
I/O module:
  • switch[x]
  • where x is the I/O-bay number.

Example:

To display the CMM network port settings, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
ports -T mm[p]
To disable FTP for the CMM, while the Lenovo Flex System chassis is set as the persistent command environment, at the system> prompt, type 
ports -ftpe off -T mm[p]

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

system> ports -T mm[p]
-cimp 5989
-ftpp 21
-ftpdp 20
-httpp 80
-httpsp 443
-slpp 427
-snmpap 161
-snmptp 162
-sshp 22
-stcmp 6091
-tcmp 6090
-telnetp 23
-tftpp 69
-cime on
-ftpe off
-httpse on
-ntpe off
-sftpe on
-slpe on
-snmp1ae on
-snmp3ae on
-snmpte on
-sshe on
-stcme off
-tcme on
-telnete off
-tftpe off
-tcmt 300
-telnett 300
-ftpt 300
system> ports -ftpe off -T mm[p]
Changes to -sshe, -sshp, -telnetp, -telnete,
-telnett, -snmpte, -tcme, -tcmp, -tcmt, -stcme, -stcmp,
-httpp,-httpse, -httpsp, -ftpe or -tftpe will become active immediately.
OK
system>
Parent topic: Command reference