Product Documentation

Link Configuration

Jan 03, 2013

show links

Syntax: show links
[-verbose]

Displays all of the currently defined links. The verbose parameter if specified will output a detailed listing of the settings for each link being displayed.

show link

Syntax: show link
-name “name”

Displays a detailed listing of the settings for the link specified by the name parameter.

rename link

Syntax: rename link
-old “oldname” 
-new “newname”

Renames the specified link.

remove link

Syntax: remove link
{-all, -name “name”}

Deletes either the named link or all links.

remove link-filter

Syntax: remove link-filter
-link “name” 
{-all, -filter-position “number”}

Removes either all link filters for the specified link or the filter at the position specified by 'number'.

Valid filter positions range from 1 to N (where N is the number of filters in the current list).

move link

Syntax: move link
-name “name” 
{ -direction {up, down} -count “count”, 
-position {bottom, top, “number”} }

Moves the named link either relative to the current position (using the direction parameter) or absolutely (using the position parameter).

Valid integer positions range from 1 to N (where N is the number of links in the current list).

add link

Syntax: add link
[-position {bottom, top, “number”}] 
-name “name” 
-type {LAN, WAN} 
-max-in-bandwidth “rate” [{bps, kbps, mbps, gbps}] 
-max-out-bandwidth “rate” [{bps, kbps, mbps, gbps}] 
{-match-all-traffic, “filter-criteria-list”}
where “filter-criteria-list” is
[-adapters ([-exclude] “adapter-name”),...] 
[-source-ips ([-exclude] “ip”),...] 
[-destination-ips ([-exclude] “ip”),...] 
[-vlans ([-exclude] “vlan”),...] 
[-wccp-service-groups ([-exclude] “id”),...] 
[-source-macs ([-exclude] “mac”),...] 
[-destination-macs ([-exclude] “mac”),...]

Creates a new link with the specified name, type, bandwidth rates and a single filter rule which can be either a “match all traffic” type rule or a rule based upon the criteria specified for adapters, source-ips, destination-ips, VLANs, WCCP service groups, source macs and destination macs. Double quotes can be used as delimiters for the link name (which may contain spaces).

If no position parameter is specified, the new link will be inserted at the top of the current list of links. Valid position arguments are “top”, “bottom” or a number in the range from 1 to N (where N is the number of links in the current list). To add an entry to the bottom of the list specify “bottom”.

The units for the bandwidth rate will default to mbps if nothing is specified. Bandwidth rates must be at least “56 kbps” and cannot exceed “1 Gbps”. If the “match all traffic” filter rule is not specified, then at least one filter criteria option must be specified.

VLANs are specified by VLAN group numbers which range from 1 to 4094. WCCP service group values range from 51 to 99. MAC addresses should be entered as 2 digit hex terms separated by “-”’s, for example, “00-0C-F1-56-98-AD”.

add link-filter

Syntax: add link-filter
-link “name” 
[-filter-position {bottom, top, “number”}] 
[-adapters ([-exclude] “adapter-name”),...] 
[-source-ips ([-exclude] “ip”),...] 
[-destination-ips ([-exclude] “ip”),...] 
[-vlans ([-exclude] “vlan”),...] 
[-wccp-service-groups ([-exclude] “id”),...] 
[-source-macs ([-exclude] “mac”),...] 
[-destination-macs ([-exclude] “mac”),...]

Creates a new link filter in the link specified by the name parameter. If no filter position parameter is specified, the new filter will be inserted at the bottom of the current list of filters. If a filter position is specified, then the new filter will be inserted at that position in the list. Valid integer positions range from 1 to N (where N is the number of filters in the list).

For the adapters, source-ips, destination-ips, VLANs, WCCP-service-groups, source-macs, and destination-macs parameters, if a setting is not provided, then any value for these fields will be considered a match. All of these parameters provide the ability to specify a comma separated list of items. Each item may indicate that instead of a match operation on the item being performed that an exclude operation is done instead.

VLANs are specified by VLAN group numbers which range from 1 to 4094. WCCP service group values range from 51 to 99. MAC addresses should be entered as 2 digit hex terms separated by “-”’s, for example, “00-0C-F1-56-98-AD”.

set link

Syntax: set link
-name “name” 
[-type {LAN, WAN}] 
[-max-in-bandwidth “rate” [{bps, kbps, mbps, gbps}]] 
[-max-out-bandwidth “rate” [{bps, kbps, mbps, gbps}]]

Changes the definition of an existing link. Double quotes can be used as delimiters for the link name (which may contain spaces). At least one of the link attributes must be set.

The units for the bandwidth rate will default to mbps if nothing is specified. Bandwidth rates must be at least “56 kbps” and cannot exceed “1 Gbps”.

set link-filter

Syntax: set link-filter
-link “name” 
-filter-position “number” 
{-match-all-traffic, “filter-criteria-list”}
where “filter-criteria-list” is
[-adapters {match-all, ([-exclude] “adapter-name”),...]} 
[-source-ips {match-all, ([-exclude] “ip”),...]} 
[-destination-ips {match-all, ([-exclude] “ip”),...]} 
[-vlans {match-all, ([-exclude] “vlan”),...]} 
[-wccp-service-groups {match-all, ([-exclude] “id”),...]} 
[-source-macs {match-all, ([-exclude] “mac”),...]} 
[-destination-macs {match-all, ([-exclude] “mac”),...]}

Change the definition of the existing link filter specified by the name and filter-position parameters. Multiple filter settings may be changed at once and the other settings will be left unchanged. At least one of the link filter attributes must be set. Valid filter positions range from 1 to N (where N is the number of filters in the list).

VLANs are specified by VLAN group numbers which range from 1 to 4094. WCCP service group values range from 51 to 99. MAC addresses should be entered as 2 digit hex terms separated by “-”’s, for example, “00-0C-F1-56-98-AD”.