> 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/backfill-service.md).

# Backfill Service

Controlling the Tandem Backfill service on each recording server, and configuring its accounts, Management Server connection and security.

## Backfill Service

The BackFill service runs on every recording server in a cluster. It copies missed video between the members after an outage, so a recovered recorder's timeline is complete again.

Configure it on **both** members of each cluster. Backfill runs in both directions, so an unconfigured member can't recover its own gaps.

This page covers the service's own settings on the recording server. Management Client sets backfill behavior— enabling it, the staging drive, and bandwidth throttling. See [Backfill Configuration](https://docs.vega365.com/tandem/configuration/on-the-management-client/backfill-configuration.md).

### The tray icon

You control the service 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%2FN7N7UIFUuasUFAyYJPCD%2FBackfill%20Agent.png?alt=media&amp;token=c6c04e0a-4bdd-40fb-a909-39bd21c5fc67" alt=""><figcaption><p>The BackFill service tray icon</p></figcaption></figure>

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

### The service menu

Right-click the tray icon to open the service menu.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FlPsArDnZXJMiztOJZ2KN%2FBackfill%20Agent%20Options.png?alt=media&amp;token=e5b949ad-5532-4c25-b095-f6180639ccff" alt=""><figcaption><p>The service menu</p></figcaption></figure>

| Option                     | What it does                                                         |
| -------------------------- | -------------------------------------------------------------------- |
| Settings                   | Opens the service configuration — see below                          |
| Start                      | Starts the BackFill service                                          |
| Stop                       | Stops the BackFill service                                           |
| Restart                    | Stops and restarts the BackFill service                              |
| Restart with detailed logs | Restarts the service with more detailed logging, for troubleshooting |
| Show Log                   | Opens the service log                                                |
| Clear Log                  | Clears the service log                                               |
| 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.

Use **Restart with detailed logs** when investigating a backfill problem, and restart normally once you have what you need.

### Settings

Select **Settings** from the service menu to open **BackFillService Settings**.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FWN5q6IHyPoNV5mqiThQu%2FBackfill_Agent_Settings.png?alt=media&amp;token=ba1d261d-7cb4-4c83-aa9d-3a231d36b311" alt="" width="314"><figcaption><p>BackFillService Settings</p></figcaption></figure>

The settings are in four sections. Select a section to expand it.

{% hint style="info" %}
**Each section saves separately.** Select **SAVE** within a section to apply that section's changes before moving to another.
{% endhint %}

#### Service Logon Settings

The Windows account that the BackFill service runs as.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FhDE2cDyxHiQ4s21ZAeOV%2FBackfill_Agent_Settings_Login.png?alt=media&amp;token=6f5725cd-bcce-4b90-ab1b-87690b48ad7f" alt="" width="311"><figcaption><p>Service Logon Settings</p></figcaption></figure>

| Setting  | What it does                               |
| -------- | ------------------------------------------ |
| Username | The Windows account the service runs under |
| Password | The password for that account              |

The service reads and writes recorded video, so this account needs access to the recording server's media storage and to the staging drive used for backfill.

{% hint style="info" %}
Restart the service using the options on the [#the-service-menu](#the-service-menu "mention") after changing credentials.
{% endhint %}

#### Primary Management Server

The connection to the Milestone XProtect Management Server.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FKPOqFUxKkXo4T9QuH2Cz%2FBackfill_Agent_Settings_Ms_Cred.png?alt=media&amp;token=d95b20dc-d44b-4110-9a63-8bdcb1284606" alt="" width="316"><figcaption><p>Primary Management Server</p></figcaption></figure>

| Setting        | What it does                                                                              |
| -------------- | ----------------------------------------------------------------------------------------- |
| Server Address | Address of the Management Server, including the scheme — for example `http://10.1.10.239` |
| Username       | Account the service uses to connect to the Management Server                              |
| Password       | Password for that account                                                                 |

Enter the address with `http://` or `https://`, to match how the Management Server is configured.

{% hint style="info" %}
Restart the service using the options on the [#the-service-menu](#the-service-menu "mention") after changing credentials.
{% endhint %}

#### Security Settings

The HTTPS certificate for the BackFill service's API.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FBZXQDJcSN2NYRD4GFWbp%2FBackfill_Agent_HTTPS.png?alt=media&amp;token=2d0b05f1-f9a7-4d63-806b-eb01c27adf69" alt="" width="314"><figcaption><p>Security Settings</p></figcaption></figure>

| Setting         | What it does                                                                                             |
| --------------- | -------------------------------------------------------------------------------------------------------- |
| API Certificate | The certificate the API uses for HTTPS, selected from the certificates installed on the recording server |

With **(None)** selected, the API runs over HTTP. Select a certificate to run it over HTTPS. You must install the certificate on the recording server before you can select it.&#x20;

{% hint style="info" %}
Restart the service using the options on the [#the-service-menu](#the-service-menu "mention") after providing an API certificate.
{% endhint %}

See the [Hardening Guide](https://docs.vega365.com/tandem/hardening-guide.md).

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

#### Shared Folder Access

Credentials for the SharedData network share, which the members use to exchange configuration data and transfer media during backfill.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FSieJLylFxcZa0K9BZxVk%2FBackfill_Agent_Shared_Folder_Cred.png?alt=media&amp;token=ff131e2e-41f4-4d6d-9179-3b22bfd1268b" alt="" width="314"><figcaption><p>Shared Folder Access</p></figcaption></figure>

| Setting               | What it does                                                                                                                                                  |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Username              | Account used to access the SharedData share                                                                                                                   |
| Password              | Password for that account                                                                                                                                     |
| Encrypt file transfer | Encrypts media and data transferred through the share. This setting is independent of the Username and Password settings. Either can exist without the other. |

{% hint style="info" %}
**Keep the credentials current.** Every section on this page stores a password. If any of these accounts change passwords or expire, the service loses that connection and backfill stops working—silently, until the next outage needs it. Update both members whenever an account changes.
{% endhint %}

{% hint style="info" %}
Restart the service using the options on the [#the-service-menu](#the-service-menu "mention") after changing credentials.
{% endhint %}

#### Proof of successful service configuration

We must see the backfill service icon in green, as shown below.

<figure><img src="https://92057524-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi0mCLda4cGtI3Jwb6IQA%2Fuploads%2FN7N7UIFUuasUFAyYJPCD%2FBackfill%20Agent.png?alt=media&amp;token=c6c04e0a-4bdd-40fb-a909-39bd21c5fc67" alt=""><figcaption></figcaption></figure>
