cluster enable

Function

The cluster enable command enables the cluster function.

The undo cluster enable command disables the cluster function.

Format

cluster enable

undo cluster enable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

By default, the cluster function is disabled.

When a backup device joins the cluster, it obtains cluster service configurations from the master device and clears its own service configurations.

After the cluster function is enabled, if a device joins a cluster, cluster negotiation starts. The device will become the master or backup node in the cluster based on the negotiation result.

Master device

All cluster-supported functions are configured on the master device. After the configuration is completed, the master device delivers the configuration to other cluster members.

C_NoX_M is displayed at the front of the command-line prompt of the master device, in which X indicates the ID of the device in the cluster, for example, C_No2_M.
Backup device

When a backup device joins the cluster, it obtains cluster service configurations from the master device and clears its own service configurations.

C_NoX_S is displayed at the front of the command-line prompt of the backup device, in which X indicates the ID of the device in the cluster, for example, C_No3_S.

Precautions

Before enabling the cluster function, set cluster negotiation parameters on the device. After enabling the cluster function, modify negotiation parameters on the management master device if needed.

You cannot directly modify the following commands after enabling the cluster function. To modify them, disable the cluster function first.

cluster node bind
cluster ip-list

The execution of the undo cluster enable command results in:

The device generates an alarm indicating that it will leave the cluster.
The device sends a leaving message and leaves the cluster.
The device deletes the routing policy cluster_rt automatically.
The cluster state machine is initialized.
The existing configuration of the device will not be deleted.

Example

# Enable the cluster function.

<sysname> system-view
[sysname] cluster enable