vlan command

This command configures and displays the VLAN (virtual local area network) settings for the CMM.

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 vlan command errors for a list of error messages that are specific to the vlan command.

Note: When viewing the vlan entries, settings preceded by an option (for example, -i) can be modified and settings preceded by a label (for example, IPv4 address:) are fixed.
Table 1. vlan 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 all VLAN settings Displays all VLAN settings for specified command target.
Note: The command issued by itself will display all entries, the global state, the commit timeout, and whether the current configuration has been committed.
vlan
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Display VLAN settings for specific VLAN ID Displays VLAN settings for the specified VLAN ID of the command target. vlan -vi index

where index is the VLAN entry index number.

Lenovo Flex System chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Apply CMM VLAN settings Applies changes made to the CMM VLAN configuration.
Note: You must commit CMM VLAN configuration changes before the commit timeout expires or the previous configuration is restored.
vlan -commit
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.
CMM commit timeout Sets a custom timeout value for applying CMM VLAN configuration changes. If CMM VLAN configuration changes are not committed before the commit timeout expires, the previous configuration is restored. vlan -cto timeout

where timeout is from 1 to 255 minutes, 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 global VLAN state Enables or disables the global VLAN state.
Note:
  • The value of the global VLAN state does not change individual VLAN settings.
  • All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -state state
where state is
  • enabled
  • 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set VLAN state for non-fixed entry Sets the VLAN state of the specified non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index -state state
where
  • index is the VLAN entry index number.
  • state is
    • enabled
    • disabled
    • restart
This command can only be run by users who have one or more of the following command authorities.
  • For the Lenovo Flex System chassis target:
    • Supervisor
    • Blade configuration
  • For the primary CMM target:
    • Supervisor
    • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Delete all non-fixed VLAN entries Deletes all non-fixed VLAN entries.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -delete
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.
Delete specific VLAN entry Deletes the specified VLAN entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-delete

where index is the VLAN entry index number.

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.
Create VLAN entry Creates the specified VLAN entry.
Note:
  • -vi and -vid must both be set to create an entry.
  • The -state and -n (name) are set as optional parameters.
  • A default entry name is used if -n is not specified.
  • All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-vid vlan_id
where
  • index is an unused VLAN entry index number.
  • vlan_id is the number from 1 to 4,094, inclusive.
This command can only be run by users who have one or more of the following command authorities.
  • For the Lenovo Flex System chassis target:
    • Supervisor
    • Blade configuration
  • For the primary CMM target:
    • Supervisor
    • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set VLAN ID Sets a new ID for the specified VLAN entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-vid id
where
  • index is the VLAN entry index number.
  • id is the number from 1 to 4,094, inclusive.
This command can only be run by users who have one or more of the following command authorities.
  • For the Lenovo Flex System chassis target:
    • Supervisor
    • Blade configuration
  • For the primary CMM target:
    • Supervisor
    • Chassis configuration
See Commands and user authority for additional information.
Lenovo Flex System chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set SOL access state Enables or disables SOL access for the specified VLAN entry.
Note:
  • Before enabling SOL access, you must first to disable it on the VLAN where it is enabled.
  • If only one VLAN is in use, you cannot disable SOL access.
  • If both VLANs are in use, disabling or enabling SOL access on one VLAN enables or disables -SOL access on the other VLAN, so that SOL is always enabled on at least one VLAN.
  • All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-sol state
where
  • index is the VLAN entry index number.
  • 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set VLAN tagging state (fixed entry) Enables or disabled VLAN tagging for the default (fixed) entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-tag state
where
  • index is 1 (the fixed VLAN entry index number).
  • 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.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set VLAN entry name Sets a name for the specified VLAN entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-n name
where
  • index is the VLAN entry index number.
  • name is the quote-delimited VLAN entry name, of 1 to 31 characters in length.
  • For the Lenovo Flex System chassis target:
    • Supervisor
    • Blade configuration
  • For the primary CMM target:
    • Supervisor
    • Chassis configuration
Lenovo Flex System chassis:
  • system
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Set VLAN IPv4 configuration method to static Sets the IPv4 configuration method for the specified VLAN non-fixed entry to static.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-c method
where
  • index is the VLAN entry index number.
  • method is static.
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 VLAN IP address (IPv4) Sets the IPv4 address for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-i ip_address
where
  • index is the VLAN entry index number.
  • ip_address is a valid IPv4 IP address.
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 VLAN subnet (IPv4) Sets the IPv4 subnet for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-s subnet
where
  • index is the VLAN entry index number.
  • subnet is the IPv4 subnet.
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 VLAN gateway (IPv4) Sets the IPv4 gateway for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-g gateway
where
  • index is the VLAN entry index number.
  • gateway is the IPv4 gateway.
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 VLAN IPv4 subnet route Sets a custom value for the specified IPv4 subnet route of the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-sr xsubnet_route
where
  • index is the VLAN entry index number.
  • x is the subnet route number 1, 2, or 3.
  • subnet_route is the IPv4 subnet route.
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 VLAN IPv4 subnet mask Sets a custom value for the specified IPv4 subnet mask for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-sm xsubnet_mask
where
  • index is the VLAN entry index number.
  • x is the subnet route number 1, 2, or 3.
  • subnet_mask is the IPv4 subnet mask.
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 VLAN IPv6 configuration method to static Sets the IPv6 configuration method for the specified VLAN non-fixed entry to static. vlan -vi index-c6 method
where
  • index is the VLAN entry index number.
  • method is static.
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 VLAN IP address (IPv6) Sets the IPv6 address for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-i6 ip_address
where
  • index is the VLAN entry index number.
  • ip_address is a valid IPv6 IP address.
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 VLAN IPv6 prefix length Sets the IPv6 prefix length for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-p6 prefix_length
where
  • index is the VLAN entry index number.
  • prefix_length is the IPv6 prefix length, between 1 and 128 (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 VLAN gateway (IPv6) Sets the IPv6 gateway for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-g6 gateway
where
  • index is the VLAN entry index number.
  • gateway is the IPv6 gateway.
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 VLAN IPv6 subnet route Sets a custom value for the specified IPv6 subnet route of the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-sr6 xsubnet_route
where
  • index is the VLAN entry index number.
  • x is the subnet route number 1, 2, or 3.
  • subnet_route is the IPv6 subnet route.
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 VLAN IPv6 subnet prefix length Sets a custom value for the specified IPv6 subnet prefix length for the specified VLAN non-fixed entry.
Note: All changes to the CMM configuration must be applied using the vlan -commit command option, before the commit timeout expires.
vlan -vi index-sp6 xprefix_length
where
  • index is the VLAN entry index number.
  • x is the subnet route number 1, 2, or 3.
  • prefix_length is the IPv6 subnet prefix length, between 1 and 128 (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.

Example:

To display all VLAN settings, while the CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type
vlan
To disable the global VLAN state, while the CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type
vlan -state disabled
To delete the VLAN entry with an index number of 2, while the CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type
vlan -delete -vi 2
To apply (commit) all changes made to VLAN settings, while the CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type
vlan -commit
To display the VLAN settings for the compute node with a VLAN ID of 1, while the CMM in bay 2 is set as the persistent command environment, at the system:mm[2]> prompt, type
vlan -vi 1

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

view all CMM VLAN entries:

system:mm[2]> vlan
-state enabled
-cto 2

-vi 1
-n VLAN-1
-state enabled
-vid 1
-sol enabled
-tag disabled
IPv4 config method: static
IPv4 address: 9.37.64.201
IPv4 subnet: 255.255.252.0
IPv4 gateway: 9.37.64.1
IPv6 config method: static
IPv6 address: ::
IPv6 prefix length: 0
IPv6 gateway: ::

-vi 2
-n temp vlan
-state disabled
-vid 2000
-sol disabled
-c static
-i 192.168.70.125
-s 255.255.255.255
-g 0.0.0.0
-sr1 0.0.0.0
-sm1 255.255.255.255
-sr2 0.0.0.0
-sm2 255.255.255.255
-sr3 0.0.0.0
-sm3 255.255.255.255
-c6 static
-i6 1122::3344
-p6 0
-g6 ::
-sr61 ::
-sp61 0
-sr62 ::
-sp62 0
-sr63 ::
-sp63 0

The current configuration has been committed.
system:mm[2]> vlan -state disabled
All changes must be committed using -commit before the commit timeout expires.
OK
system:mm[2]> vlan -delete -vi 2
All changes must be committed within 20 minutes using -commit.
OK
system:mm[2]> vlan -commit
OK
system:mm[2]> vlan -vi 1
-vi 1
-n VLAN-1
-state disabled
-vid 10
system:mm[2]