The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
You can configure the Cisco Edge 340 Series in CLISH, which is used for the local CLI configuration. The CLI uses only those commands that are specific to the Cisco Edge 340 Series. Although the syntax is similar to the Cisco IOS CLI, these commands are incompatible with Cisco IOS commands.
You can use CLISH in two modes:
Use the CLI to configure these device settings:
Follow these configuration guidelines when using CLISH:
Note If you log in to the Cisco Edge 340 Series as ordinary user, and you want to enter CLISH as the root user, use the Linux command su -, where - means to switch ordinary user to root user, and use the environment variables of root. If more than 10 minutes passed by without any activity after you enter the privileged mode, you will exit the privileged mode automatically. Notice the prompt > and #; > means user mode, and # means privileged mode.
Use the interface system configuration command to enter this mode. Use the exit global configuration command to return to the system configuration mode.
– WiFi AP interface configuration mode
Use the interface system configuration command to enter this mode. We recommend that before you configure any wireless settings, you use the wireless-mode WiFi configuration command to set the 802.11 wireless mode. Use the exit global configuration command to return to the system configuration mode.
Use the ssid system configuration command to enter this mode. Use the exit global configuration command to return to the system configuration mode.
ssid NEWAP1
broadcast ssid on
broadcast ssid off
exit
Figure 3-1 shows the logic sequence of the CLISH functional structure.
Figure 3-1 Logic Sequence of the CLISH Functional Structure
This sections contains the commands of the following modes:
Note Syntax description, command default, command mode, usage guidelines, and examples are provided only for commands that are not self-explanatory.
This section contains user configuration mode commands. Table 3-1 describes the functions these commands perform.
|
|
---|---|
Diagnoses basic network connectivity, and verifies if the remote device is reachable. |
|
To enter the global configuration mode, use the enable command in the user configuration mode.
Use the enable command and enter the password of the root user to switch to the global configuration mode.
To exit the configuration mode that you are in, use the exit command in any configuration mode.
Ethernet interface configuration
WiFi AP interface configuration
Use exit to leave a configuration mode and return to the previous configuration mode.
To display a brief description of the help system, use the help command in the user configuration mode.
The help command displays a list of available commands, along with a brief description of each. To display additional details for a specific command, enter the command name followed by the -? option.
To diagnose basic network connectivity on a Cisco Edge 340 Series device, use the ping command in the user configuration mode or the global configuration mode.
ping {[ip | ipv6 | arp] hostname | ip_address }
Sends Internet Control Message Protocol (ICMP) IPv4 messages to network hosts (default). |
|
The ping command sends an echo request packet to an address then waits for a reply. Ping output can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
To discover the routes that packets will pass through when traveling to their destination address, use the traceroute command in the user configuration mode or the global configuration mode.
traceroute [ protocol ] destination [ [ resolve ] source ip_address | interface interface_name ]
The traceroute command works by taking advantage of the error messages generated by devices when a datagram exceeds its hop limit value.
The traceroute command first sends probe datagrams with a hop limit of 1. Including a hop limit of 1 with a probe datagram causes the neighboring devices to discard the probe datagram and send back an error message. The traceroute command sends several probes with increasing hop limits and displays the round-trip time for each.
The traceroute command sends out one probe at a time. Each outgoing packet might result in one or more error messages. A time-exceeded
error message indicates that an intermediate device has seen and discarded the probe. A destination unreachable
error message indicates that the destination node has received and discarded the probe because the hop limit of the packet has reached a value of 0. If the timer goes off before a response comes in, the traceroute command prints an asterisk (*).
The traceroute command is terminated when the destination responds, when the hop limit is exceeded, or when the user interrupts the trace with the escape sequence. By default, to invoke the escape sequence, simultaneously press and release the Ctrl, Shift, and 6 keys, and then press the X key.
This section contains global configuration mode commands. Table 3-2 describes the functions these commands perform.
To enter the global configuration mode, use the configure terminal in the global configuration mode.
To save the running configuration as the startup configuration file, use the copy running-config startup-config command in the global configuration mode.
To export a configuration file to the USB storage or a local directory, use the export-config command in the global configuration mode.
export startup-config to destination
Destination that you want to export the configuration file to. The destination can be either a USB or a local directory. |
You can export a configuration file to either a USB or a local directory. If you choose to export a configuration file to the USB, the configuration is automatically detected, mounted, and exported to the USB.
To import a configuration file from a USB or a local directory, use the import-config command in the global configuration mode.
import startup-config from source
Location of the configuration file that you want to import. The source can be either a USB or a local directory. |
You can import a configuration file from either a USB or a local directory. If you choose to import a configuration file from a USB, the configuration is automatically detected, mounted, and imported from the USB.
To halt and perform a cold restart, use the reboot command in the global configuration mode.
To restore default factory configuration, use the restore command in the global configuration mode.
To display running system information, use the show command in the global configuration mode.
This section contains system configuration mode commands. Table 3-3 describes the functions these commands perform.
To configure the auto login of the system, use the auto-login command in the system configuration mode.
auto-login { enable | disable }
To enable or disable bluetooth on the Cisco Edge 340 Series device, use the bluetooth command in the system configuration mode.
To set the time zone for display purposes, use the clock command in the system configuration mode.
Continent or ocean. Valid values are Africa, America, Antarctica, Arctic, Asia, Atlantic, Australia, Europe, Indian, Mideast, and Pacific. |
To configure the relation between two monitors, use the display command in the system configuration mode.
display type { hdmi | vga } relation type {hdmi | vga}
Configures relation between the two monitors. Valid values are same-as, right, left, below, and above. |
To execute user configuration or global configuration commands in the global configuration mode or other configuration modes, use the do command in any configuration mode.
User configuration or global configuration command to be executed. |
A user configuration or global configuration command is not executed from a configuration mode.
Use this command to execute user configuration or global configuration commands (such as show, copy, and export) while configuring your routing device. After the command is executed, the system will return to the configuration mode that you were using.
To configure high-definition multimedia (HDMI) resolution or rotation, use the hdmi command in the system configuration mode.
hdmi { resolution resolution_value | rotation rotation_value }
Rotation that you want to set. Valid values are normal, right, inverted, and left. |
To configure the hostname of the Cisco Edge 340 Series device, use the hostname command in the system configuration mode.
To enter the Ethernet interface configuration mode to configure the Gigabit Ethernet interface, or to enter WiFi AP interface configuration mode to configure the wireless interface, use the interface command in the system configuration mode.
interface { ethernet ge | wireless bvi1 }
Use the interface command to enter the Ethernet interface configuration mode or the WiFi AP interface configuration mode.
Use the exit command to leave the Ethernet interface configuration mode or the WiFi AP interface configuration mode.
Table 3-4 lists the Ethernet interface configuration mode commands.
Table 3-5 lists the WiFi AP interface configuration mode commands.
To configure the device language, use the language support command in the system configuration mode.
language support language_value
Language for the device. Valid values are zh_CH.utf8, en_US.utf8, ko_KR.utf8, and ja_JP.utf8. |
To set the log size, use the log command in the system configuration mode.
Sets the log size. Default unit is MB. The valid range is from 1 to 10000. Default is 10 MB. |
To enable or disable the monitor type of HDMI or VGA, use the monitor command in the system configuration mode.
monitor type {hdmi | vga} {on | off}
To remove the configuration for a command or set the command to default, use the no command in the system configuration mode.
To configure the Network Time Protocol (NTP) server that is used by the Cisco Edge 340 Series device, use the ntp command in the system configuration mode.
ntp {refresh { on | off } | server ip_address }
To configure the proxy server, use the proxy-server command in the system configuration mode.
proxy-server server [type] [ port port_number]
(optional) Type of proxy server. Valid values are no_for, all, http, ftp, and https. |
|
(optional) Specifies the proxy port number. The range is from 0 to 65535. |
To configure a Secure Shell (SSH) user, use the ssh command in the system configuration mode.
To set the Service Set Identifier (SSID) name and enter the SSID configuration mode to configure the security settings for the access point of the device, use the ssid command in the system configuration mode.
SSID name for the access point. The name can include all the ASCII characters except ' \ " ? =, and space. |
Use the exit command to leave the SSID configuration mode.
Table 3-6 lists the SSID configuration mode commands.
To configure the Video Graphics Array (VGA) resolution or rotation, use the vga command in the system configuration mode.
vga { resolution resolution | rotation rotation }
Rotation that you want to set. Valid values are normal, right, inverted, and left. |
To set the WiFi mode of the Cisco Edge 340 Series device, use the wifi-mode command in the global configuration mode.
wifi-mode {WiFiAP | WiFiSta | NonWiFi}
If you choose the AP mode, the Cisco Edge 340 Series device will work in the AP mode immediately, and only the commands that are specific to the AP mode are visible. If you choose the client mode, the Cisco Edge 340 series device will work in the client mode immediately, and only the commands that are specific to the client mode are visible.
This section contains Ethernet interface configuration mode commands. Table 3-4 describes the functions these commands perform.
To configure the duplex mode for the Gigabit Ethernet (GE) interface, use the duplex command in the Ethernet interface configuration mode.
To set the IP address for an interface, use the ip address command in the Ethernet interface configuration mode.
ip address { dhcp | ip_address }
IP address negotiated through the Dynamic Host Configuration Protocol (DHCP). |
|
To set the IPv6 address for an interface, use the ipv6 address command in the Ethernet interface configuration mode.
ipv6 address { dhcp | ipv6_address }
To specify the default gateway for the Cisco Edge 340 Series device, use the ip default-gateway command in the Ethernet interface configuration mode.
To specify the IPv6 default gateway for the Cisco Edge 340 Series device, use the ipv6 default-gateway command in the Ethernet interface configuration mode.
ipv6 default-gateway ipv6_address
To configure the speed for an interface, use the speed command in the Ethernet configuration mode.
speed { auto | 10 | 100 | 1000 }
This section contains WiFi AP interface configuration mode commands. Table 3-5 describes the functions these commands perform.
To enable or disable MAC Service Data Unit (MSDU) aggregation, use the aggregation-msdu command in the WiFi AP interface configuration mode.
To configure wireless separation for clients that are connected to the same Service Set Identifier (SSID), use the ap-isolation command in the WiFi AP interface configuration mode.
To configure Wi-Fi Multimedia (WMM) power save mode for an access point, use the apsd command in the WiFi AP interface configuration mode.
WiFi AP interface configuration
You can configure the apsd command only when the WMM is enabled.
Use the wmm command to enable WMM.
To configure auto block, use the auto-block command in the WiFi AP interface configuration mode.
To enable or disable the task of declining a BA request, use the ba-decline command in the WiFi AP interface configuration mode.
To configure the beacon interval for an access point, use the beacon-interval command in the WiFi AP interface configuration mode.
Period that you want to configure the beacon interval with. The range is between 20 and 1000 milliseconds. The default is 100 milliseconds. |
WiFi AP interface configuration
To configure CTS-to-self protection for an access point, use the bg-protection command in the WiFi AP interface configuration mode.
bg-protection { auto | on | off }
Note This command applies to the 802.11b/g mixed mode, 802.11n/g mixed mode, and 802.11b/g/n mixed mode.
The default is automatic selection of CTS-to-self protection.
WiFi AP interface configuration
CTS-to-self protection minimizes collisions among clients in a mixed mode environment, but reduces throughput performance.
To configure the channel width in a scenario there an access point functions in the 802.11n mode, use the channel bandwidth command in the WiFi AP interface configuration mode.
channel bandwidth { 20 | 20/40 }
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
Configures automatic selection of a 20-MHz or a 40-MHz channel width. |
The default is automatic selection of a 20-MHz or a 40-MHz channel width.
WiFi AP interface configuration
The default setting should work well for most networks.
A 40-MHz channel provides a higher throughput performance for 802.11n clients.
802.11b and 802.11g clients can function only with a 20-MHz channel.
The setting of the channel bandwidth command affects the options for the mcs command.
To configure a channel number, which sets the frequency for an access point, use the channel number command in the WiFi AP interface configuration mode.
channel number { auto | number }
WiFi AP interface configuration
We recommend that you either use the default channel number or the automatic selection of the channel number and only change the channel number if you experience interference in the network.
To configure the Delivery Traffic Indication Message (DTIM) interval for an access point, use the data-beacon-rate command in the WiFi AP interface configuration.
The range is between 1 and 255 milliseconds. The default is 1 millisecond. |
WiFi AP interface configuration
The DTIM interval is a multiple of the beacon interval. Before you change the DTIM interval, consider the types of clients in the network: laptops might function better with a short interval, but mobile phones might function better with a long interval.
A long interval allows clients to save power, but may delay multicast and broadcast traffic.
A short interval decreases the delivery time of multicast and broadcast traffic, but may increase power consumption by clients.
The setting of the beacon-interval command affects the data-beacon-rate command.
To configure the control sideband that is used for the extension or secondary channel when an access point functions in the 802.11n mode, use the extension channel command in the WiFi AP interface configuration mode.
extension channel { upper | lower }
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
WiFi AP interface configuration
This command takes effect only when you configure a 40-MHz channel width.
When the main channel number is in the lower range (for example, in the 1 to 4 range), use the upper extension channel.
When the main channel number is in the upper range (for example, in the 10 to 13 range), use the lower extension channel.
When the main channel number is in the middle range (for example, in the 5 to 9 range), use either the upper extension channel or the lower extension channel.
Use the channel bandwidth command to configure the channel width.
Use the channel number command to configure the main channel number.
To configure the Frag threshold, use the frag-threshold command in the WiFi AP interface configuration mode.
Configures the Frag threshold value. The range is from 256 to 2346. |
To configure the guard interval period between packets when the access point functions in the 802.11n mode, use the guard-interval command in the WiFi AP interface configuration mode.
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
WiFi AP interface configuration
Use a 400-ns interval to increase the throughput performance for 802.11n clients, but may result in some packet errors and multipath interference.
Use an 800-ns interval to minimize packet errors and multipath interference, but decrease the throughput performance for 802.11n clients.
The setting of the guard-interval command affects the options for the mcs command.
To enable or disable Internet Group Management Protocol (IGMP) snooping on a wireless interface, use the igmp-snoop command in the WiFi AP interface configuration mode.
To configure the high throughput Modulation and Coding Scheme (MCS) rate when an access point functions in the 802.11n mode, use the mcs command in the WiFi AP interface configuration mode.
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
WiFi AP interface configuration
This table shows the MCS index numbers with their potential data rates in Mbps based on MCS, guard interval, and channel width.
|
|
|
||
|
|
|
|
|
We recommend that you use automatic selection of the MCS index number. Change the MCS index to a fixed number only if the Received Signal Strength Indication (RSSI) for the clients in the network can support the selected MCS index number.
The setting of the channel bandwidth command affects the options for the mcs command.
The setting of the guard-interval command affects the options for the mcs command.
To configure the high throughput Modulation and Coding Scheme (MCS) rate on multicast frames when an access point functions in the 802.11n mode, use the multicast-mcs command in the WiFi AP interface configuration mode.
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
This table shows the MCS index numbers with their potential data rates in Mbps based on MCS, guard interval, and channel width.
|
|
|
||
|
|
|
|
|
To configure the PHY mode on multicast frames when an access point functions in the 802.11n mode, use the multicast-phy-mode command in the WiFi AP interface configuration mode.
multicast-phy-mode { 0 | 1 | 2 | 3 }
Specifies Orthogonal Frequency Division Multiplexing (OFDM) (802.11g). This is the default. |
|
To configure greenfield mode or the mixed mode when an access point functions in the 802.11n mode, use the operating-mode command in the WiFi AP interface configuration mode.
operating-mode { greenfield | mixed }
Note This command applies to the 802.11n mode.
WiFi AP interface configuration
Use the greenfield mode if there are only 802.11n clients in the coverage area. If you use the greenfield mode when 802.11b, 802.11g, and 802.11n clients coexist in the same coverage area, packet collisions might occur.
Use the mixed mode when 802.11b, 802.11g, and 802.11n clients coexist in the same coverage area.
To configure Aggregate MAC Service Data Unit (A-MSDU) packet aggregation when an access point functions in the 802.11n mode, use the packet aggregation command in the WiFi AP interface configuration mode.
packet aggregation { on | off }
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
WiFi AP interface configuration
Enable packet aggregration if network traffic consists primarily of data.
Disable packet aggregration if network traffic consists primarily of voice, video, or other multimedia traffic.
To configure the Reverse Direction Grant (RDG) when an access point functions in the 802.11n mode, use the rdg command in the WiFi AP interface configuration mode.
Note This command applies to the 802.11n mode or the 802.11n mixed mode.
WiFi AP interface configuration
When RDG is enabled, a transmitter that has reserved the channel transmission opportunity allows the receiver to send packets in the reserved direction. When RDG is disabled, packets can be transmitted only in one direction during the channel transmission opportunity reservation.
Enable RDG for better throughput performance of 802.11n traffic.
To configure the Request to Send (RTS) threshold, use the rts-threshold command in the WiFi AP interface configuration mode.
To configure the short-slot time when the access point functions in the 802.11g mode or the 802.11g mixed mode, use the short-slot command in the WiFi AP interface configuration mode.
Note This command applies to the 802.11g mode or the 802.11g mixed mode.
WiFi AP interface configuration
Enable the short-slot time for better throughput performance for 802.11g clients.
If there are mostly 802.11b clients in the network, disable the short-slot time.
To configure the space time block coding (STBC), use the stbc command in the WiFi AP interface configuration mode.
To configure the transmit burst (Tx burst) for an access point, use the transmit burst command in the WiFi AP interface configuration mode.
WiFi AP interface configuration
Leave Tx burst on for better throughput performance.
Disable Tx burst if you notice wireless interference in the network.
To configure the preamble for an access point, use the transmit preamble command in the WiFi AP interface configuration mode.
transmit preamble { long | short | auto }
WiFi AP interface configuration
Use the long preamble setting for compatibility with legacy 802.11 systems operating at 1 and 2 Mb/s.
Configure a short preamble setting to improve throughput performance.
To configure the power at which an access point radio transmits its wireless signal, use the transmit power command in the WiFi AP interface configuration mode.
WiFi AP interface configuration
For transmission of the wireless signal over a long distance, use the 100 percent setting.
For transmission of the wireless signal over a short distance, for example, when all the clients are in a small room, lower the percentage.
To configure the 802.11 wireless mode for an access point, use the wireless-mode command in the WiFi AP interface configuration mode.
wireless-mode { 0 | 1 | 2 | 4 | 6 | 7 | 8 | 9 | 11 |}
WiFi AP interface configuration
802.11b/g mixed mode—Select this mode if you have devices in the network that support 802.11b and 802.11g.
802.11b mode—Select this mode if all the devices in the wireless network only support 802.11b.
802.11a mode for 5GHz only—Select this mode if all the devices in the wireless network only support 802.11a in the 5GHz band.
802.11g mode—Select this mode if all the devices in the wireless network only support 802.11g.
802.11n mode for 2GHz only—Select this mode if all the devices in the wireless network only support 802.11n in the 2GHz band.
802.11b/g/n mixed mode—Select this mode if you have devices in the network that support 802.11b, 802.11g, and 802.11n.
802.11b/g mixed mode—Select this mode if you have devices in the network that support 802.11b and 802.11g.
To configure Wi-Fi Multimedia (WMM) for an access point, use the wmm command in the WiFi AP interface configuration mode.
WiFi AP interface configuration
WMM provides QoS for wireless traffic. If there is a lot of mixed media traffic (voice, video, data), enable WMM.
Use the apsd command to configure WMM power save mode.
This section contains Service Set Identifier (SSID) configuration mode commands. Table 3-6 describes the functions these commands perform.
Note Configuration for SSID will take effect after exiting the SSID configuring mode.
To enable or disable broadcast of the SSID name, use the broadcast ssi d command in the SSID configuration mode.
Disable broadcast of the SSID for enhanced security. Only wireless clients who know the SSID can connect to the access point.
Enable broadcast of the SSID for wider availability and easier access.
To configure open, shared, or Wired Equivalency Privacy (WEP) authentication and associated encryption for an access point, use the encryption mode command in the SSID configuration mode.
encryption mode { open | shared } type { none | wep { key { 1 | 2 | 3 | 4 } { hex number | ascii phrase }}}
For shared access without encryption, the WEP hexadecimal number or passphrase is used only for authentication.
For shared access with WEP encryption, the WEP hexadecimal number or passphrase is used for both authentication and encryption.
This example shows how to configure shared authentication and WEP encryption, using key 3 and the passphrase 3uifsfis-_0r5:
To configure Wi-Fi Protected Access (WPA) authentication and associated encryption for an access point, use the encryption mode command in the SSID configuration mode.
encryption mode { wpapsk | wpa2psk | wpapskwpa2psk } type { tkip | aes | tkipaes }
pass-phrase phrase
This example shows how to configure combined WPA and WPA2 authentication with combined TKIP and AES encryption, using the passphrase safE478_Ty33Yep-:
To configure Wi-Fi Protected Access (WPA) authentication and associated encryption for an access point, use the encryption mode command in the SSID configuration mode.
encryption mode { wpa | wpa2 | wpa1wpa2 } type { tkip | aes | tkipaes }
Note The encryption mode (802.1x) should be used in combination with RADIUS server.
Configures combined WPA and WPA2 with 802.1x authentication. |
|
Configures Temporal Key Integrity Protocol (TKIP) encryption. |
|
The default mode is wpa2psk access, tkipaes encryption, and the password is Cisco123.
This example shows how to configure combined WPA and WPA2 authentication with combined TKIP and AES encryption, using the 802.1x authentication method:
To configure the related information of a RADIUS server, use the radius-server in the SSID configuration mode.
radius-server hostname [auth-port port_number] [key secret]
This example shows how to configure the related information of a RADIUS server:
Use the following show commands in the user configuration mode to display the configuration on a Cisco Edge 340 Series device:
Use the following show commands in the global configuration mode to display the configuration on a Cisco Edge 340 Series device: