You are here: Home > CLI Commands > Just_CLI_Topics > uplink

uplink

uplink

cellular

apn <APN-Profile-Pid> <APN-name>

priority <prior>

enable

health-check ip {<fqdn>|<ip>}

load-balance

media-mode

mode {hash-based|round-robbin|session-count|uplink utilization}

threshold-limits

jitter <avg_jitter>

latency <avg_latency>

session-count-percent <sess_percent>

wired

priority <prior>

vlan <id> uplink-id {link1|link2|link3|link4}

backup-link

max-bandwidth <max_bw_utiln>

no {backup-link|max-bandwidth|priority|speed|weight}

priority <wired_vlan_priority>

speed <uplink_speed>

weight <wired_vlan_weight>

Description

Manage and configure the uplink network connection.

Syntax

Parameter

Description

Range

cellular

apn <APN-Profile-Pid> <APN-Name>

priority <prior>

Set the cellular uplink configuration. This parameter has two sub-parameters:

apn: The AP name of the cellular uplink.
<APN-Profile-Pid>: Connection ID in modem dial string (e.g. "*99***x#", where "x" is the appropriate APN-profile-id number in dial-string)
<APN-Name>: AP Name (e.g. internet). Contact your service provider if not known.

priority: Set the priority of the cellular uplink. By default, the cellular uplink is a lower priority than the wired uplink; making the wired link the primary link and the cellular link the secondary or backup link. Configuring the cellular link with a higher priority than your wired link priority will set your cellular link as the primary link.

priority: 1-255

enable

Enable the uplink manager.

load-balance

Load-balance configuration.

media-mode

Enable the Media Mode option to reevaluate the selected uplink for the session if it is identified as a media session. By default, all sessions use the load-balance mode specified by the mode parameter. When you select this option, any time a session is identified as a media session, the uplink is reassigned to the optimal uplink for media sessions, based upon a separate media load-balancing algorithm.

mode hash-based|round-robbin|session-count

Choose one of the following load balancing modes:

Hash based: Hash-based load balancing uses information from the packets being sent, (e.g. the source IP address, destination IP address, protocol and port numbers to determine how to load balance that traffic)

Round Robin: Traffic is equally distributed to all the active uplinks

Session Count: Traffic is balanced between the uplink ports based on the number of sessions managed by each link. The session-distribution is guided by uplink load-balance threshold-limits session-count <> percentage.

threshold-limits

Define latency and session thresholds

     jitter <avg_jitter>

Define the maximum latency allowed for media sessions in media mode. The supported range is 1 - 400 milliseconds, and the default is 20 ms.

1-400 ms

     latency <avg_latency>

Optimize media sessions by defining the maximum latency allowed for media sessions in media mode. The supported range is 1 - 400 milliseconds, and the default is 20 ms.

1-400 ms

     session-count <sess_count>

Specify the maximum percentage of total sessions that can be managed by any active uplink. The default % is equally distributed among the number of wired uplink ports present. That is:

For 4 uplink ports– 25%

For 3 uplink ports– 33%

For 2 uplink ports– 50%

For 1 uplink port– 100%

media-mode

Enable load-balancing of media sessions using jitter, latency, pkt-loss of uplinks (disabled by default)

mode

Configure load-balancing mode. The valid values are hash-based, round-robin, and session-count.

threshold-limits

Set threshold limits for load balancing. The valid values are jitter, latency, and session count percentage.

health-check {ip {<fqdn>|<ip>}

The health-check parameter is introduced to monitor the availability and quality of the connection to a master managed device with the specified FQDNFully Qualified Domain Name. FQDN is a complete domain name that identifies a computer or host on the Internet. or IP address.

wired

Define the wired uplink configuration.

priority <prior>

Define the default priority for wired uplinks.

The default wired priority is 200.

1-255

vlan <id> uplink-id {link1|link2|link3|link4}

Define the VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. ID of the uplink VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN.. A maximum of four wired VLANsVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. can be defined.

1-4094

priority <wired_vlanVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN._priority>

Set the priority of the wired VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. uplink-id. Each uplink type has an associated priority; wired ports have the highest priority by default.

1-255

weight <wired_vlanVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN._weight>

Set a weight for the uplink VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN., which will be used in load balancing.

The default value is 10.

1-100

Usage Guidelines

A managed device that supports multiple 3GThird Generation of Wireless Mobile Telecommunications Technology. See W-CDMA. cellular uplink ports in addition to their standard wired ports provides redundancy in the event of connection failure. However, at a time, only one cellular uplink is supported irrespective of many plugged-in. Also, uplink enable configuration is required to failover to cellular uplink (that is, active-standby operation). So, if a managed device's wired link cannot access the internet, the managed device can fail over to a secondary cellular link and continue routing traffic.

The uplink manager is disabled by default. Issue the uplink enable command to enable the uplink manager.

If uplink load-balance is enabled (active-active operation), and the device fails-over to cellular uplink because all wired uplink ports became unusable (unreachable or interface is down) then uplink load-balancing gets disabled automatically. This is because cellular uplink never participates in load-balancing of WANWide Area Network. WAN is a telecommunications network or computer network that extends over a large geographical distance. traffic. Once any wired uplink port becomes usable again, cellular is disconnected and load-balancing get enabled again.

Both uplink enable and uplink health-check configuration are required for enabling uplink load-balance.

To view the health status of an uplink on a services or managed device, issue the command show uplink in the managed device CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions.. For a managed device, the health status of its uplink connections are also displayed in the Status section of the Dashboard > WAN page of the managed device WebUI.

Related Commands

Command

Description

show uplink

Displays uplink configuration details.

Command History

Release

Modification

ArubaOS 8.1.0.0

The load-balance and wired parameters were added.

ArubaOS 8.0.0.0

Command introduced.

Command Information

Platform

License

Command Mode

All platforms

Base operating system.

Config mode on Mobility Master.

/*]]>*/