# Cluster Configuration

Cluster configuration is a critical enterprise task because it defines how multiple SmartTSA appliances cooperate as a single logical service endpoint.

# 1. Purpose of Cluster Configuration

A SmartTSA cluster provides:

- High Availability (HA)
- Service continuity
- Automatic redundancy between appliances
- A single access point for client applications


The cluster is identified by a single IP address and behaves as one unified TSA service.

Cluster configuration is required when:

- Deploying more than one SmartTSA appliance
- Setting up HQ + DR redundancy
- Initializing the system for enterprise HA operation


# 2. When Cluster Configuration Must Be Performed

Cluster parameters must be configured:

- **Once only**
- During the **initialization phase** of the system
- Before the cluster becomes operational for production usage


All appliances belonging to the same cluster MUST share the same configuration values.

# 3. Accessing Cluster Configuration Menu

To configure the cluster:

1. Log in to the SmartTSA Administrative Console
2. From the left navigation menu, select:


```
Cluster Configuration
```

This section allows the administrator to define all parameters required for HA clustering.

# 4. Cluster Parameters

The administrator must configure the following core parameters:

## 4.1 External IP Address

### Definition

The **External IP** is the IP address through which the entire cluster is reachable.

Clients will always connect to this IP address (via DNS).

### Key Notes

- It represents the **Cluster IP**
- It must be unique within the network
- It is shared logically by all cluster nodes


## 4.2 Watchdog IP Address (Multicast)

### Definition

The **Watchdog IP** is a multicast IP address used internally by cluster nodes to monitor each other.

Each appliance sends watchdog messages to:

- Check availability
- Detect failures
- Maintain cluster health status


### Requirements

- Must be a valid multicast address
- Must belong to the selectable IP range of the local network
- Must not conflict with other multicast services


## 4.3 Cluster Password

### Definition

The cluster password is used to authenticate communication between SmartTSA nodes.

### Mandatory Rule

⚠️ The password MUST be:

- Exactly the same on all appliances
- Configured consistently across HQ and DR nodes


If passwords do not match, nodes will not join the same cluster.

# 5. Applying Configuration

Once the administrator has filled in:

- External IP
- Watchdog IP
- Password


The configuration is saved and applied to the system.

These operations are typically required only:

- At first initialization
- When adding a new node to an existing cluster


# 6. Operational Considerations

After configuration:

- Each node announces itself on the network
- Multicast MAC forwarding enables request delivery
- Cluster health is maintained via watchdog messages


SmartTSA will operate as:

- One cluster service endpoint
- Multiple redundant appliances