vrID

The following operations can be performed on "vrID":

add | rm | set | unset | bind | unbind | show

add vrID

Adds a VMAC address to the NetScaler appliance.A Virtual MAC address (VMAC) is a floating entity, shared by the nodes in an HA configuration.

Synopsys

add vrID <id> [-priority <positive_integer>] [-preemption ( ENABLED | DISABLED )] [-sharing ( ENABLED | DISABLED )] [-tracking <tracking>] [-ownerNode <positive_integer>] [-trackifNumPriority <positive_integer>]

Arguments

id

Integer that uniquely identifies the VMAC address. The generic VMAC address is in the form of 00:00:5e:00:01:<VRID>. For example, if you add a VRID with a value of 60 and bind it to an interface, the resulting VMAC address is 00:00:5e:00:01:3c, where 3c is the hexadecimal representation of 60.

Minimum value: 1

Maximum value: 255

priority

Base priority (BP), in an active-active mode configuration, which ordinarily determines the master VIP address.

Default value: 255

Minimum value: 1

Maximum value: 255

preemption

In an active-active mode configuration, make a backup VIP address the master if its priority becomes higher than that of a master VIP address bound to this VMAC address.

If you disable pre-emption while a backup VIP address is the master, the backup VIP address remains master until the original master VIP's priority becomes higher than that of the current master.

Possible values: ENABLED, DISABLED

Default value: ENABLED

sharing

In an active-active mode configuration, enable the backup VIP address to process any traffic instead of dropping it.

Possible values: ENABLED, DISABLED

Default value: DISABLED

tracking

The effective priority (EP) value, relative to the base priority (BP) value in an active-active mode configuration. When EP is set to a value other than None, it is EP, not BP, which determines the master VIP address.

Available settings function as follows:

• NONE - No tracking. EP = BP

• ALL - If the status of all virtual servers is UP, EP = BP. Otherwise, EP = 0.

• ONE - If the status of at least one virtual server is UP, EP = BP. Otherwise, EP = 0.

• PROGRESSIVE - If the status of all virtual servers is UP, EP = BP. If the status of all virtual servers is DOWN, EP = 0. Otherwise EP = BP (1 - K/N), where N is the total number of virtual servers associated with the VIP address and K is the number of virtual servers for which the status is DOWN.

Default: NONE.

Possible values: NONE, ONE, ALL, PROGRESSIVE

Default value: NONE

ownerNode

Assign a cluster node as the owner of this VMAC address. If no owner is configured, owner node is displayed as ALL and one node is dynamically elected as the owner.

Default value: -1

Minimum value: 0

Maximum value: 31

trackifNumPriority

Priority by which the Effective priority will be reduced if any of the tracked interfaces goes down.

Default value: 0

Minimum value: 1

Maximum value: 255

Example

add vrID 1

rm vrID

Removes a specified VMAC entry or all VMAC entries from the NetScaler appliance.

Synopsys

rm vrID (<id> | -all)

Arguments

id

Integer value that uniquely identifies the VMAC address.

Minimum value: 1

Maximum value: 255

all

Remove all the configured VMAC addresses from the NetScaler appliance.

set vrID

Modifies parameters related to a VMAC address on the NetScaler appliance.

Synopsys

set vrID <id> [-priority <positive_integer>] [-preemption ( ENABLED | DISABLED )] [-sharing ( ENABLED | DISABLED )] [-tracking <tracking>] [-ownerNode <positive_integer>] [-trackifNumPriority <positive_integer>]

Arguments

id

Integer value that uniquely identifies the VMAC address. The generic VMACaddressis in the form of 00:00:5e:00:01:<VRID>. For example, if you add a VRID with a value of 60 and bind it to an interface, the resulting VMAC address is 00:00:5e:00:01:3c, where 3c is the hexadecimal representation of 60.

Minimum value: 1

Maximum value: 255

priority

Base priority (BP), in an active-active mode configuration, which ordinarily determines the master VIP address.

Default value: 255

Minimum value: 1

Maximum value: 255

preemption

In an active-active mode configuration, make a backup VIP address the master if its priority becomes higher than that of a master VIP address bound to this VMAC address.

If you disable pre-emption while a backup VIP address is the master, the backup VIP address remains master until the original master VIP's priority becomes higher than that of the current master.

Possible values: ENABLED, DISABLED

Default value: ENABLED

sharing

In an active-active mode configuration, enable the backup VIP address to process any traffic instead of dropping it.

Possible values: ENABLED, DISABLED

Default value: DISABLED

tracking

The effective priority (EP) value, relative to the base priority (BP) value in an active-active mode configuration. When EP is set to a value other than None, it is EP, not BP, which determines the master VIP address.

Available settings function as follows:

• NONE - No tracking. EP = BP

• ALL - If the status of all virtual servers is UP, EP = BP. Otherwise, EP = 0.

• ONE - If the status of at least one virtual server is UP, EP = BP. Otherwise, EP = 0.

• PROGRESSIVE - If the status of all virtual servers is UP, EP = BP. If the status of all virtual servers is DOWN, EP = 0. Otherwise EP = BP (1 - K/N), where N is the total number of virtual servers associated with the VIP address and K is the number of virtual servers for which the status is DOWN.

Default: NONE.

Possible values: NONE, ONE, ALL, PROGRESSIVE

Default value: NONE

ownerNode

Assign a cluster node as the owner of this VMAC address. If no owner is configured, owner node is displayed as ALL and one node is dynamically elected as the owner.

Default value: -1

Minimum value: 0

Maximum value: 31

trackifNumPriority

Priority by which the Effective priority will be reduced if any of the tracked interfaces goes down.

Default value: 0

Minimum value: 1

Maximum value: 255

Example

set vrID 1 -priority 100

unset vrID

Use this command to remove vrID settings.Refer to the set vrID command for meanings of the arguments.

Synopsys

unset vrID <id> [-priority] [-preemption] [-sharing] [-tracking] [-ownerNode] [-trackifNumPriority]

bind vrID

Binds the specified interfaces to a VMAC configuration.

Synopsys

bind vrID <id> (-ifnum <interface_name> ... | -trackifNum <interface_name> ...)

Arguments

id

Integer that uniquely identifies the VMAC address. The generic VMAC address is in the form of 00:00:5e:00:01:<VRID>. For example, if you add a VRID with a value of 60 and bind it to an interface, the resulting VMAC address is 00:00:5e:00:01:3c, where 3c is the hexadecimal representation of 60.

Minimum value: 1

Maximum value: 255

ifnum

Interfaces to bind to the VMAC, specified in (slot/port) notation (for example, 1/2).Use spaces to separate multiple entries.

trackifNum

Interfaces which need to be tracked for this vrID.

Example

add vrID 1

unbind vrID

Unbinds specified interfaces from a VMAC configuration.

Synopsys

unbind vrID <id> (-ifnum <interface_name> ... | -trackifNum <interface_name> ...)

Arguments

id

Integer value that uniquely identifies the VMAC address. The generic VMAC address is in the form of 00:00:5e:00:01:<VRID>. For example, if you add a VRID with a value of 60 and bind it to an interface, the resulting VMAC address is 00:00:5e:00:01:3c, where 3c is the hexadecimal representation of 60.

Minimum value: 1

Maximum value: 255

ifnum

Interfaces to unbind from the VMAC, specified in (slot/port) notation (for example, 1/2). Use spaces to separate multiple entries.

trackifNum

Interfaces which need to be tracked for this vrID.

show vrID

Displays the settings of all VRIDs configured on the NetScaler appliance, or of the specified VRID. To display the settings of all the VRIDs, run the command without any parameters. To display the settings of a particular VRID, specify the VRID.

Synopsys

show vrID [<id>]

Arguments

id

Integer value that uniquely identifies the VMAC address.

Minimum value: 1

Maximum value: 255

Outputs

ifaces

Interfaces bound to this VRID.

type

Indicates whether this VRID entry was added manually or dynamically. When you manually add a VRID entry, the value for this parameter is STATIC. Otherwise, it is DYNAMIC.

vlan

The VLAN in which this VRID resides.

priority

Base priority (BP), in an active-active mode configuration, which ordinarily determines the master VIP address.

effectivePriority

The effective priority of this VRID.

preemption

In an active-active mode configuration, make a backup VIP address the master if its priority becomes higher than that of a master VIP address bound to this VMAC address.

If you disable pre-emption while a backup VIP address is the master, the backup VIP address remains master until the original master VIP's priority becomes higher than that of the current master.

sharing

In an active-active mode configuration, enable the backup VIP address to process any traffic instead of dropping it.

tracking

The effective priority (EP) value, relative to the base priority (BP) value in an active-active mode configuration. When EP is set to a value other than None, it is EP, not BP, which determines the master VIP address.

Available settings function as follows:

• NONE - No tracking. EP = BP

• ALL - If the status of all virtual servers is UP, EP = BP. Otherwise, EP = 0.

• ONE - If the status of at least one virtual server is UP, EP = BP. Otherwise, EP = 0.

• PROGRESSIVE - If the status of all virtual servers is UP, EP = BP. If the status of all virtual servers is DOWN, EP = 0. Otherwise EP = BP (1 - K/N), where N is the total number of virtual servers associated with the VIP address and K is the number of virtual servers for which the status is DOWN.

Default: NONE.

flags

Flags.

IPAddress

The IP address bound to the VRID.

state

State of this VRID.

stateflag

operationalOwnerNode

Run time owner node of the vrid.

ownerNode

Assign a cluster node as the owner of this VMAC address. If no owner is configured, owner node is displayed as ALL and one node is dynamically elected as the owner.

trackifNum

Interfaces which need to be tracked for this vrID.

trackifNumPriority

Priority by which the Effective priority will be reduced if any of the tracked interfaces goes down.

devno

count

Example

show vrid