uplink
uplink
enforce {ethernet| cellular |wifi | none}
failover-internet
failover-internet-check-timeout
failover-internet-pkt-lost-cnt <count>
failover-internet-pkt-send-freq <frequency>
failover-vpn-timeout <seconds>
preemption
uplink-priority {cellular <priority> | ethernet <priority>| [port <Interface-number> <priority>]|wifi <priority>}
no…
Description
This command configures uplink connections.
Syntax
|
Parameter |
Description |
Range |
Default |
||||||||||||
| uplink | Enables the uplink configuration sub-mode. | — | — | ||||||||||||
|
enforce {ethernet|cellular |wifi | none} |
Enforces the specified uplink connection. You can specify the following types of uplink:
|
ethernet, cellular, wifi, none | None | ||||||||||||
| failover-internet |
Enables uplink switchover based on the availability of the Internet. When enabled, the IAP continuously sends ICMP packets to some well-known Internet servers. If the request is timed out due to a bad uplink connection or uplink interface failure, and the public Internet is not reachable from the current uplink, the IAP switches to a different connection. |
— |
Disabled |
||||||||||||
| failover-internet-check-timeout | The number of seconds after which the Internet based uplink verification times out. | 0-3600 | 10 | ||||||||||||
|
failover-internet-pkt-lost-cnt <count> |
Configures the number of packets that are to be lost when verifying the uplink availability using the Internet. | 1—1000 | 10 | ||||||||||||
|
failover-internet-pkt-send-freq <frequency> |
Configures the frequency in seconds, at which the ICMP packets are sent to verify the uplink availability using the Internet. | 1—3600 | 30 | ||||||||||||
| failover-vpn-timeout <seconds> | Configures a duration to wait for an uplink switch based on VPN status. | — | 180 seconds | ||||||||||||
| preemption | Enables pre-emption when no uplinks are enforced. When enabled, if the current uplink is active, the IAP periodically tries to use a higher priority uplink, and switches to a higher priority uplink even if the current uplink is active. | — | Disabled | ||||||||||||
|
uplink-priority {cellular <priority>|ethernet <priority>| [port <Interface-number> <priority>]| wifi <priority>} |
Sets an uplink priority. You can specify the type of uplink to configure and assign a priority. If Ethernet uplink needs to be prioritized, specify the interface port number. |
Integer | Eth0 | ||||||||||||
|
no… |
Removes the configuration. | — | — |
Usage Guidelines
Use this command to set preferences for enforcing uplinks or enabling preemption and to configure uplink switchover.
Enforcing uplinks
The following configuration conditions apply to the uplink enforcement:
| | When an uplink is enforced, the IAP uses the specified uplink regardless of uplink preemption configuration and the current uplink status. |
| | When an uplink is enforced and multiple Ethernet ports are configured and uplink is enabled on the wired profiles, the IAP tries to find an alternate Ethernet link based on the priority configured. |
| | When no uplink is enforced and preemption is not enabled, and if the current uplink fails, the IAP tries to find an available uplink based on the priority configured. |
Uplink Preemption
When no uplink is enforced and preemption is enabled, and if the current uplink fails, the IAP tries to find an available uplink based on in the priority configured. If current uplink is active, the IAP periodically tries to use a higher priority uplink and switches to the higher priority uplink even if the current uplink is active.
Uplink Priority
When uplink priority is configured, the IAP tries to get a higher priority link every ten minutes even if the current uplink is up. This does not affect the current uplink connection. If the higher uplink is usable, the IAP switches over to that uplink. Preemption is enabled by default.
Uplink Switchover
The default priority for uplink switchover is Ethernet and then 3G/4G. The IAP has the ability to switch to the lower priority uplink if the current uplink is down.
Uplink Switching based on VPN Status
Instant supports switching uplinks based on the VPN status when deploying mixed uplinks (Eth0, 3G/4G,Wi-Fi). When VPN is used with multiple backhaul options, the IAP switches to an uplink connection based on the VPN connection status instead of only using Eth0, the physical backhaul link.
The following configuration conditions apply to uplink switching:
| | If the current uplink is Eth0 and the VPN connection is down, the IAP will retry to connect to VPN. This retry time depends on the configuration of primary/backup and fast-failover for VPN. If all the possibilities fail, then the IAP waits for a vpn-failover-timeout and then a different u plink (3G,Wi-Fi) is selected. |
| | If the current uplink is 3G or Wi-Fi, and Eth0 has a physical link, the IAP periodically suspends user traffic to try and connect to the VPN on the Eth0. If the IAP succeeds, then the IAP switches to Eth0. If the IAP does not succeed, then the IAP restores the VPN connection to the current uplink. |
Switching Uplinks Based on Internet Availability
When the uplink switchover based on Internet availability is enabled, the IAP continuously sends ICMP packets to some well-known Internet servers. If the request is timed out due to a bad uplink connection or uplink interface failure, and the public Internet is not reachable from the current uplink, the IAP switches to a different connection.
Example
The following example configures uplink priority:
(Instant AP)(uplink)# uplink-priority ethernet port 0 1
(Instant AP)(uplink)# end
(Instant AP)# commit apply
Command History
|
Version |
Description |
| Aruba Instant 6.4.0.2-4.1 | This command is modified. |
|
Aruba Instant 6.2.1.0-3.3 |
This command is introduced. |
Command Information
|
IAP Platform |
Command Mode |
|
All platforms |
Configuration mode and uplink configuration sub-mode. |