Command Reference vA5(1.0) and earlier, Cisco ACE Application Control Engine
FT Group Configuration Mode Commands
Downloads: This chapterpdf (PDF - 75.0KB) The complete bookPDF (PDF - 28.65MB) | Feedback

FT Group Configuration Mode Commands

Table Of Contents

FT Group Configuration Mode Commands

(config-ft-group) associate-context

(config-ft-group) inservice

(config-ft-group) peer

(config-ft-group) peer priority

(config-ft-group) preempt

(config-ft-group) priority


FT Group Configuration Mode Commands

FT group configuration mode commands allow you to configure fault-tolerant (FT) groups that consist of two contexts, each residing on a different ACE. FT groups are part of the ACE redundancy feature. For details about redundancy, see the Virtualization Guide, Cisco ACE Application Control Engine.

To create an FT group and access the FT group configuration mode, use the ft group command in configuration mode. The CLI prompt changes to (config-ft-group). For information about the commands in FT group configuration mode, see the commands in this section.

Use the no form of this command to remove an FT group from the configuration.

ft group group_id

no ft group group_id

Syntax Description

group_id

Unique identifier of an FT group. Enter an integer from 1 to 255.


Command Modes

Configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

All commands in this mode require the Admin user role. For details about role-based access control (RBAC) and user roles, see the Virtualization Guide, Cisco ACE Application Control Engine.

Examples

To create an FT group with a group ID of 1 and access ft-group configuration mode, enter:

host1/Admin(config)# ft group 1
host1/Admin(config-ft-group)#
 
   

To delete the FT group, enter:

host1/Admin(config)# no ft group 1

Related Commands

show ft
show running-config

(config-ft-group) associate-context

To associate a context with a fault-tolerant (FT) group, use the associate-context command. You need to make this association for each of the two redundant contexts in an FT group. Use the no form of this command to remove a context from an FT group.

associate-context name

no associate-context name

Syntax Description

name

Identifier of the context that you want to associate with the FT group. Enter an unquoted text string with no spaces and a maximum of 64 alphanumeric characters.


Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

Before you can remove a context from an FT group, you must first take the group out of service using the no inservice command. See the (config-ft-group) inservice command.

Examples

To associate a context with an FT group, enter:

host1/Admin(config-ft-group)# associate-context C1

Related Commands

show ft
(config) context

(config-ft-group) inservice

To place a fault-tolerant (FT) group in service, use the inservice command. Use the no form of this command to take the FT group out of service.

inservice

no inservice

Syntax Description

This command has no keywords or arguments.

Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

Before you place an FT group in service, be sure that you have associated one or two contexts with the FT group and properly configured the two peers.

Examples

To place an FT group in service, enter:

host1/Admin(config-ft-group)# inservice

Related Commands

This command has no related commands.

(config-ft-group) peer

To associate a peer ACE with a fault-tolerant (FT) group, use the peer command. Use the no form of this command to remove the peer association with the FT group.

peer peer_id

no peer peer_id

Syntax Description

peer_id

Identifier of an existing peer ACE. Enter 1 for the peer ID.


Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

The peer designation is used to denote the remote standby member of the FT group. A context in a redundant configuration can have only one peer context.

Examples

To associate a peer ACE with an FT group, enter:

host1/Admin(config-ft-group)# peer 1

Related Commands

show ft
(config) ft peer

(config-ft-group) peer priority

To configure the priority of a fault-tolerant (FT) group on the remote standby member, use the peer priority command. Use the no form of this command to restore the default priority of 100.

peer priority number

no peer priority number

Syntax Description

number

Priority of the FT group on the standby member. Enter an integer from 1 to 255. The default is 100.


Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

Configure a lower priority on the FT group member (context) that you want as the standby member.

Examples

To configure the priority of the FT group on the standby ACE with a value of 50, enter:

host1/Admin(config-ft-group)# peer priority 50

Related Commands

(config-ft-group) peer
(config-ft-group) preempt

(config-ft-group) preempt

To configure preemption after it has been disabled, use the preempt command. Use the no form of this command to disable preemption.

preempt

no preempt

Syntax Description

This command has no keywords or arguments.

Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

Preemption ensures that the group member with the higher priority always asserts itself and becomes the active member. By default, preemption is enabled.

If you disable preemption and a member with a higher priority is found after the other member has become active, the newly elected member becomes the standby member even though it has a higher priority.

Examples

To reenable preemption after its default setting was disabled, enter:

host1/Admin(config-ft-group)# preempt

Related Commands

show ft
(config-ft-group) priority

(config-ft-group) priority

To configure the priority of the active group member, use the priority command. Use the no form of this command to restore the default priority of 100.

priority number

no priority number

Syntax Description

number

Priority number for the active group member. Enter an integer from 1 to 255. The default is 100.


Command Modes

FT group configuration mode

Admin context only

Command History

ACE Module Release
Modification

3.0(0)A1(2)

This command was introduced.


ACE Appliance Release
Modification

A1(7)

This command was introduced.


Usage Guidelines

You must configure the priority of a group on both peer ACEs. Configure a higher priority for the group on the ACE where you want the active member to initially reside.

Examples

To set the priority of the FT group on the active member to a value of 150, enter:

host1/Admin(config-ft-group)# priority 150

Related Commands

show ft
(config-ft-group) preempt