CLI Configuration Guide for Omada SDN Controller (v5.9.9 and above)

Starting from version 5.9, Omada SDN Controller has supported the CLI Configuration feature, which allows you to create and issue configuration profiles using CLI. This feature is designed as a complementary approach when some features or settings are not available on the GUI.

Omada SDN Controller supports two types of CLI Configuration: Site CLI, and Device CLI.

■ Site CLI: configuration profiles will be issued to all devices that support CLI Configuration

■ Device CLI: configuration profiles will be issued to selected devices that support CLI Configuration.

Currently, only Omada switches support CLI Configuration. For more information about the CLI commands for Omada switches, please refer to the CLI Reference Guide.

Before using CLI configuration, be sure to read the following precautions and User Guide carefully to avoid any unexpected errors. If you encounter any problems, you can contact TP-Link technical support.

1. Precautions

1.1 General Precautions

1. The GUI and CLI configuration should be planned globally according to the actual network topology and requirements.

2. Please do not use CLI Configuration to configure the functions that are already available on the GUI, as this may cause conflicts and make the devices’ settings inconsistent with your expectations.

a. When adopting a new device, the Controller will apply configurations to the device in the order of GUI, Site CLI, and then Device CLI. If there is a configuration conflict, the configuration applied last takes effect.

b. CLI profiles (including Site CLI profiles and Device CLI profiles) will only be issued to devices once after applied, unless the “Apply Again” button in the Application Result is clicked to trigger the full configurations application.

c. When a device upgrades its firmware, the Controller will apply the full configurations to the device in the order of GUI, Site CLI, and then Device CLI.

d. Please note that the later configuration may override the previous configuration, resulting in different running configurations for different devices after the same function has been modified multiple times via GUI, Site CLI, or Device CLI.

3. Omada Controller will not verify the existing GUI and CLI configurations of devices. Be sure to check the existing configurations before performing new configurations. Otherwise, unexpected results may occur after the configurations are applied, and the devices may even go offline.

4. To avoid configuration conflicts, if you do need to configure a feature using the CLI, it is recommended that you do not configure it via GUI at the same time.

5. To avoid disconnection of devices from the Controller due to configuration errors or conflicts, it is recommended to configure VLANs, VLAN Interfaces, IP Addresses, ACLs, etc. only through the GUI, and avoid modifying the relevant configurations through the CLI.

1.2 Commands that do not take effect

Please be aware that some commands may not work properly due to hardware resource allocation in Controller mode. Even if the CLI profiles containing these commands can be correctly issued and listed in the running config, they may not take effect because the device does not have hardware resources to run them.

CLI commands of the following function modules cannot be configured or take effect, and should be avoided:

• Protocol VLAN
• L2PT
• ERPS
• MAC/IP/Packet Content/IPv6 ACL
• IPv4 IMPB
• IPv6 IMPB
• DHCPv4 Filter
• DHCPv6 Filter
• DoS Defend

2. Site CLI

Overview

Site CLI enables batch configurations of all devices that support CLI configuration on the site via command lines.

Configuration

1. Go to Settings > CLI Configuration > Site CLI.

2. Click Create New Site CLI Profile and create a CLI profile according to your needs.

Note:

• The # character is a special command, which indicates entering the configure mode. Please use it in a separate line. If you add other commands after it in the same line, they will be ignored. • If a command starts with the ! character, the command will be ignored.

Name	Specify the name of the CLI profile.
Description	(Optional) Enter a description for identification.
CLI	Enter the command lines manually.
Import CLI from Device	Click and select a device that supports CLI configuration to import its running config.
Import CLI from File	Click and select an existing command file to import command lines.

3. Click Save to add the profile. The new profile is in inactive state and will not be applied to devices.

4. Click Apply to apply the CLI. The profile will change to active state and apply configurations to all devices that support CLI configuration on the site.

Note:

Once the profile becomes active, you will be unable to edit it.

To check whether the profile is successfully applied to devices and takes effect, click View CLI Details to view the configuration results on the Devices > Application Result page.

Note:

Deleting a CLI profile will not take effect on existing configurations on devices. To delete the configurations, use the “no” command.

3. Device CLI

Overview

Device CLI enables batch configuration of specific devices via command lines.

Device CLI supports variables. You can use the %x% format to define a variable x, and then set different values for different switches. When the Controller applies the Device CLI configuration to switches, it will automatically modify the variable %x% to the values you set.

Configuration

1. Go to Settings > CLI Configuration > Device CLI. Click Create New Device CLI Profile and create a CLI profile according to your needs.

Note:

•The # character is a special command, which indicates entering the configure mode. Please use it in a separate line. If you add other commands after it in the same line, they will be ignored. •If a command starts with the ! character, the command will be ignored.

Name	Specify the name of the CLI profile.
Description	(Optional) Enter a description for identification.
CLI	Enter the command lines manually. You can enter %xxx% in the CLI template to define variables.
Import CLI from Device	Click and select a device that supports CLI configuration to import its running config.
Import CLI from File	Click and select an existing command file to import command lines.

2. Click Next. Select the devices to apply the CLI profile.

3. Click Save to add the profile. The new profile is in inactive state and will not be applied to devices.

4. Click Apply to apply the CLI. The profile will change to active state and apply configurations to the devices you selected.

Note:

Once the profile becomes active, you will be unable to edit it.

To check whether the profile is successfully applied to devices and takes effect, click View CLI Details to view the configuration results on the Devices > Application Result page.

Note:

Deleting a CLI profile will not take effect on existing configurations on devices. To delete the configurations, use the “no” command.