Datacenter User Guide

Version 2.2 | Published May 16, 2024 ©

Replicator

Datacenter supports datasets of type Replicator, and such data can be used to use one Datacenter as input for another.

This is particularly useful when a Datacenter machine has to be removed from public internet, but still needs to fetch data from an online Provider. In this scenario, a Datacenter machine can be connected to the internet and the provider, and the protected machine, not on the internet but reachable from the first machine, setup with one or more Replicator datasets pointing to the online machine.

Info: For security reasons, to allow a Datacenter service to be reachable by other machines, a HTTPS certificate must be correctly configured. Therefore, currently only Datacenter machines that run a secure (HTTPS) service can be replicated. A service running an unsafe HTTP service can still be replicated, but only on the localhost (on the same machine).

Note: When connecting to a Datacenter service that runs as HTTPS, the certificate used on that machine must be valid, signed by an authority and in general, must pass a standard authentication procedure. Failing to do so, may result in the connection to that machine being refused by the connecting Replicator dataset, due to security issues.

Follow these steps to configure a Replicator dataset:

  1. Create a new dataset of type Replicator, specifying a name and (optionally) a prefix to use to identify the dataset and its values:

    images/download/thumbnails/149925166/image-2024-1-25_16-21-18.png
  2. Click Add. The dataset is added to the list, and it has an initial WARNING status as it contains no dataset to replicate yet.
    images/download/thumbnails/149925166/image-2023-8-15_16-23-11.png

  3. You can now select a host to replicate from the table in the Dataset configuration panel by double clicking a row. The table lists all the recently used hosts.

    images/download/attachments/149925166/image-2024-1-25_16-22-22.png


    Alternatively, you can add a new host by clicking on Add new host on the right-side of the panel, and then clicking on the empty host that is added at the bottom of the table.

    images/download/attachments/149925166/image-2023-8-15_17-0-31.png


    Doing so reveals the new host details, where its properties can be entered.

    images/download/attachments/149925166/image-2024-1-25_16-22-54.png


    You can now double click on the configured host in the host table to select it as source to replicate.

    images/download/attachments/149925166/image-2023-8-15_17-4-26.png
  4. By clicking on the card in the Dataset configuration panel, the Dataset parameters will be shown on the right side of the screen

    images/download/attachments/149925166/image-2024-1-26_15-30-28.png


    1. The HTTPS toggle can be used to specify a host that runs an HTTPS Datacenter service.

    2. If the specified host runs a Datacenter, the datasets created on that machine are listed in the dropdown Dataset menu available in the Dataset parameters section.

      images/download/thumbnails/149925166/image-2024-1-26_15-30-51.png
  5. After selecting a dataset, its entries are added to the Dataset Entries table.
    For example, the images below show a Replicator dataset (top) replicating entries from a Fluid dataset (bottom):

    images/download/attachments/149925166/image-2024-1-25_16-28-19.png


    images/download/attachments/149925166/image-2024-1-25_16-28-47.png


Info: When replicating a Dataset, each edit on the original dataset source (for example, disabling an entry or modifying a value) is immediately reflected in the Replicator dataset. Changes done on the Replicator dataset; however, do not reflect on the original source dataset.


Please refer to the Filtering and Manipulating the Dataset Entries page to learn how to enable, disable and edit the entries added.