> For the complete documentation index, see [llms.txt](https://docs.vega365.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vega365.com/tandem/configuration/on-each-recorder/clustering-service.md).

# Clustering Service

Controlling the Tandem Clustering Agent on each recording server, and configuring its security and Management Server connection.

## Clustering Service

The Tandem Clustering Agent runs on every recording server in a cluster. It pairs the recorders, keeps configuration replicated between them, and handles failover.

Configure it on **both** members of each cluster. The settings are per recording server.

### The tray icon

You control the agent from its icon in the Windows notification area on the recording server.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FOEAqMlLaKZwj0bRJTz2d%2FClustering%20Agent.png?alt=media&amp;token=f9155f27-9694-4535-9891-613c03816a6e" alt=""><figcaption><p>The Clustering Agent tray icon</p></figcaption></figure>

If the icon isn't visible, it may be in the overflow area—select the arrow in the notification area to show hidden icons.

### The agent menu

Right-click the tray icon to open the agent menu. The top line shows the service's current status.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2F3SIcpmHGhgxEVUhKDWlE%2FClustering%20Agent%20Options.png?alt=media&amp;token=2b63ed8b-294d-4e26-99d4-d998f4d5a197" alt=""><figcaption><p>The agent menu</p></figcaption></figure>

| Option     | What it does                                                                                                           |
| ---------- | ---------------------------------------------------------------------------------------------------------------------- |
| Start      | Starts the Clustering service                                                                                          |
| Stop       | Stops the Clustering service                                                                                           |
| Restart    | Stops and restarts the Clustering service                                                                              |
| View Logs  | Opens the agent's logs                                                                                                 |
| Settings   | Opens the agent's configuration — see below                                                                            |
| Force Sync | Triggers a configuration sync between the cluster members immediately, rather than waiting for the next scheduled sync |
| About      | Shows version information                                                                                              |
| Exit       | Closes the tray application                                                                                            |

Options that don't apply to the current state are unavailable—for example, **Start** is greyed out while the service is running.

### Settings

Select **Settings** from the agent menu to open the service configuration.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2Fy1VR21xySVF4u849ExqZ%2FClustering_Agent_Settings.png?alt=media&amp;token=a5a50938-c511-4f3c-bb4e-00c6e680e195" alt="" width="347"><figcaption><p>Tandem Agent settings</p></figcaption></figure>

Select **Save changes** to apply, or **Cancel** to discard.

#### Security

| Setting         | What it does                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------ |
| Enable HTTPS    | Runs the agent's API over TLS instead of HTTP                                                          |
| SSL Certificate | The local certificate used for HTTPS, selected from the certificates installed on the recording server |

The agent's API is HTTP by default. Enable HTTPS on any deployment where the cluster members communicate across a network you do not fully control. The certificate must already be installed on the recording server before it can be selected. See Hardening Guide.

Configure HTTPS the same way on both members so they can still communicate.

#### Management Server

| Setting                   | What it does                                               |
| ------------------------- | ---------------------------------------------------------- |
| Management Server Address | Hostname or IP address of the Milestone Management Server  |
| Username                  | Account the agent uses to connect to the Management Server |
| Password                  | Password for that account                                  |
| Use HTTPS                 | Connects to the Management Server over HTTPS               |

The agent uses this connection to read and apply recorder configuration, and to attach the recording server to the Management Server at failover. Configure it on both members, including the headless one—it uses these details when it takes over.

Turn on **Use HTTPS** when the Management Server is configured for encrypted connections.

{% hint style="info" %}
**Keep the credentials current.** If the password on this account changes or expires, the agent loses its connection to the Management Server — and a headless member that cannot connect cannot take over at failover. Update both members whenever the account changes.
{% endhint %}
