Working with the Distribution Mode

Background

  • In ElasticXL Cluster:

    The ElasticXL Cluster uses the Distribution Mode to assign incoming traffic to Security Group Members in the ElasticXL Cluster.

    By default, the ElasticXL Cluster automatically configures the Distribution Mode.

  • In Maestro:

    The Quantum Maestro Orchestrators use the Distribution Mode to assign incoming traffic to Security Group Members in each Security Group.

    By default, the Orchestrators automatically configure the Distribution Mode.

  • On Scalable Chassis:

    The Security Switch Modules (SSMs) use the Distribution Mode to assign incoming traffic to Security Group Members in each Security Group.

    By default, the SSMs automatically configure the Distribution Mode.

Supported Distribution Modes

Mode

Instructions

User

(Internal)

Packets are assigned to a Security Group Member based only on the packet's Destination IP address.

If Layer 4 distribution is enabled, the ElasticXL Cluster / Quantum Maestro Orchestrator / Scalable Chassis SSM assigns packets to a Security Group Member based on the packet's Source Port and the Destination IP address.

On Scalable Chassis, this mode applies to one SSM.

Network

(External)

Packets are assigned to a Security Group Member based only on the packet's Source IP address.

If Layer 4 distribution is enabled, the ElasticXL Cluster / Quantum Maestro Orchestrator / Scalable ChassisSSM assigns packets to a Security Group Member based on the packet's Source IP address and Destination Port.

On Scalable Chassis, this mode applies to one SSM.

General

The ElasticXL Cluster / Quantum Maestro Orchestrators / Scalable ChassisSSMs assign packets to a Security Group Member based only on the packet's Source IP address and the Destination IP address.

If Layer 4 distribution is enabled, the ElasticXL Cluster / Quantum Maestro Orchestrators / SSMs assign packets to a Security Group Member based on the packet's Source IP address, Source Port, Destination IP address, and Destination Port.

On Scalable Chassis, this mode applies to all SSMs in the Scalable Chassis.

Auto-Topology

(Per-Port)

Each port for a Security Group Member is configured separately in the User Mode or Network Mode.

On Scalable Chassis, this mode applies to the SSM data interface.

Notes:

  • The default mode is Auto-Topology ((Per-Port)) and the Layer 4 distribution is enabled.

  • The User ((Internal)) Mode and Network ((External)) Mode can work together.

    The supported combinations are:

    • User Mode and User Mode

    • User Mode and Network Mode

    • Network Mode and Network Mode

    In many scenarios, it is possible to optimize the combination of the User Mode and Network Mode to pass traffic through same Security Group Member from the two sides.

Related Commands

Automatic Distribution Configuration (Auto-Topology)

Platform

Default Distribution Mode

ElasticXL Cluster

By default, Security Groups work in the General Mode with Layer 4 distribution enabled.

Maestro

By default, Security Groups work in the General Mode with Layer 4 distribution enabled.

Scalable Chassis

By default, Security Groups work in the Auto-Topology (Per Port) Mode with Layer 4 distribution disabled.

The best Distribution Mode is selected based on the Security Group topology as defined in SmartConsole in the Security Gateway object.

The Distribution Mode is automatically based on these interface types:

  • Physical interfaces, except for management and synchronization interfaces

  • VLAN

  • Bond

  • VLAN on top of Bond

The examples below show how the Distribution Mode can be configured automatically for each interface.

Manual Distribution Configuration (Manual-General)

In some deployments, you must manually configure a Distribution Mode to the General.

In other cases, it may be necessary to force the system to work in the General Mode.

When the Distribution Mode is configured manually (the Manual-General Mode), the Distribution Mode of ElasticXL Cluster / each Maestro Orchestrator / Scalable Chassis SSM is General.

In this configuration, the topology of the interfaces is irrelevant.

Best Practice - Do not manually change the Distribution Mode of a Legacy Virtual System. This can cause performance degradation.

Setting and Showing the Distribution Configuration (set distribution configuration)

Use these Gaia gClish commands on a Security Group to set and show the distribution configuration.

Important - If the Security Group runs in the Legacy VSX mode, run the commands in the context of VS0 only. The commands apply immediately across all Virtual Systems.

Syntax to show the Distribution Configuration

show distribution configuration

Syntax to set the Distribution Configuration

set distribution configuration {auto-topology | manual-general} ip-version {ipv4 | ipv6 | all} ip-mask <Mask>

Parameters

Parameter

Description

auto-topology

Configures the distribution mode to Auto-Topology (Per-Port).

manual-general

Configures the distribution mode to Manual General.

ipv4

Configures the distribution mode for IPv4 traffic only.

ipv6

Configures the distribution mode for IPv6 traffic only.

all

Configures the distribution mode for IPv4 and IPv6 traffic.

ip-mask <Mask>

Must be the same as the distribution matrix size.

Must be specified in the Hex format.

Follow these steps:

  1. Examine the distribution matrix size:

    show distribution verification verbose

    Examine the Matrix Size line.

    Example:

    ...
    Matrix Size 512
    ...

  2. Exit from the Gaia gClish to the Expert mode.

  3. Convert the matrix size from the decimal to the hexadecimal format:

    printf '%x\n' <Matrix Size>

    Example:

    [Expert@HostName-ch0x-0x:0]# printf '%x\n' 512
    200
    [Expert@HostName-ch0x-0x:0]#

  4. Go to the Gaia gClish:

    gclish

  5. Configure the distribution mode with the required mask:

    set distribution ... ip-mask <Matrix Size in HEX>

    Example:

    set distribution ... ip-mask 200

Configuring the Interface Distribution Mode (set distribution interface)

Description

Use these Gaia gClish commands on a Security Group to:

  • Set the interface Distribution Mode - For an interface when the system is not working in the General Mode

  • Show the interface Distribution Mode - If it is assigned by Auto-Topology, or is manually configured

Note - In Legacy VSX mode, you must go to the context of the applicable Virtual System before you can change the interface Distribution Mode.

Run the "set virtual-system <VS ID>" command.

Syntax to set the interface Distribution Mode

set distribution interface <Name of Interface> configuration {user | network | policy}

Syntax to show the interface Distribution Mode

show distribution interface <Name of Interface> configuration

Parameters

Parameter

Description

<Name of Interface>

Interface name as assigned by the operating system.

user

Manually assign the User (Internal) Distribution Mode - based on the Destination IP address.

network

Manually assign the Network (External) Distribution Mode - based on the Source IP address.

policy

Use Auto-Topology to automatically assign the Distribution Mode according to the policy.

Examples

Showing Distribution Status (show distribution status)

Description

Use this Gaia gClish command on a Security Group to show the status report of the Distribution Mode.

Syntax

show distribution status [verbose]

Examples

Running a Verification Test (show distribution verification)

Description

Use this Gaia gClish command on a Security Group to run a verification test of the Distribution Mode configuration.

This test compares the Security Group configuration with the actual results.

You can see a summary or a verbose report of the test results.

Syntax

show distribution verification [verbose]

Examples

Configuring the Layer 4 Distribution Mode and Masks (set distribution l4-mode)

Description

Use these commands in Gaia gClish on a Security Group to:

  • Enable Layer 4 distribution and set new masks for the IP address and the port

  • Disable Layer 4 distribution

  • Show Layer 4 Distribution Mode and masks

Syntax

set distribution l4-mode enabled

set distribution l4-mode disabled

show distribution l4-mode

Examples