# Configuration

Create sites and add repositories in the web-based configuration. Using the ELO Indexserver URL, specify which repositories data is replicated from. A replication set is created automatically in the configuration when you add a new repository. Each replication set stands for one repository. The replication set is a characteristic that you assign to individual repositories in order to replicate them in another repository. The individual entries (folders, documents) to be replicated are selected in the ELO Java Client or ELO Web Client using the "Assign replication sets" function. With this function, you select the repository you want to export the entries to. This means you select a repository the entries are replicated to.

Important

Replication sets and their assignments in the repository that were created in a version older than ELO Replication 12 will be deleted when migrating to ELO Replication 23. Before performing a migration, create an overview of replication sets and their assignments so you can reconfigure them in version 23.

To configure ELO Replication for the first time, log on at any site and configure the settings as desired. These settings are saved in a configuration file. You can send the configuration file to other sites. This means you only have to configure replication manually at one site.

# Overview

To configure ELO Replication at at least two sites, perform the following steps. For more information on the individual steps, refer to the chapters Installation and the following sections.

  1. Install at site 1 and site 2.

  2. Configure site 1.

  3. Publish replication at site 1.

  4. Send configuration file to site 2.

  5. Insert configuration file at site 2.

  6. Publish replication at site 2.

  7. Assign replication sets at site 1 and/or site 2.

Information

Once you have performed steps 1 - 7, you can manually start an export from the local repository for test purposes. The export starts immediately, regardless of the configured schedule. Select Start export on the ELO Replication overview page. Once you have performed steps 1 - 7, you can manually start an export from the local repository for test purposes. The export starts immediately, regardless of the configured schedule. Select Start export on the ELO Replication overview page.

'Start export' button

# Initial logon

# Information

Once you have installed ELO Replication, you can set up a replication network in the configuration. The first time you log on to ELO Replication, proceed as follows:

# Step by step

  1. Open your browser and go to the ELO Application Server overview page.

    ELO Application Server

  2. To open the configuration, select /rp.

  3. Log on to ELO Replication with your Apache Tomcat administrator account.

    Set site

  4. The first time you log on, you will have to set a site name. If you already have a configuration file for ELO Replication, you can select it here.

Information

For more detailed information on inserting a configuration file, refer to the chapter Create/insert a configuration for other sites.

# Result

Once you have set your site, draft mode opens. Here, you can configure and edit a new replication as well as publish drafts.

Draft mode

# Next step

To show the setting options, select the site.

Information

For more detailed information on setting up a replication network, refer to the additional sections in the chapter Configuration.

# Draft mode (overview)

In draft mode, you can configure and edit a new replication as well as publish drafts.

Please note

Bi-directional replication is possible between two sites. Serial replication between multiple sites in a loop is not possible.

Draft mode; overview

1 Viewer pane: Here, you will see the sites and connections in the replication network. Your local site is marked with a pin icon. The site currently selected that you are changing the settings for is shown in yellow.

2 Back: If you don't want to publish a draft yet or want to continue editing it at a later point in time, exit draft mode by clicking the back arrow. The draft is saved. You return to the overview page.

3 Selection: If this button is enabled, you can select a site with the mouse in the viewer pane and move it. A dialog box appears on the right for each selected site where you can enter the data for the site.

4 New site/new connection: If this button is enabled, you can add new sites and connections.

To add a new site, click anywhere in the viewer pane.

Before you add a connection, you need to set up an interface in the site settings. For more information, refer to the Site settings chapter. To add a new connection, place the mouse on a site. The connection icon appears. Press and hold down the left mouse button and drag the connection to another site.

5 Delete: If this button is enabled, you can delete sites and connections.

6 Scheduler for automatic transfer: This button opens the scheduler for automatic transfer. For more information, refer to the Scheduler for automatic transfer chapter.

7 Site settings: If you select a site in the viewer pane, the setting options for the site appear here. Your entries are saved automatically as soon as you leave an input field. For more information on these settings, refer to the chapters Site settings and Scheduler for automatic transfer.

8 Dark mode/light mode: You can choose between a dark or light screen background or use the browser default.

Dark mode

9 Language: Select the display language here You can choose between German and English.

10 Status information: This area contains information about monitoring the replication process. The package processing status is displayed as well as the number of data packages currently in the processing queue. The status when forwarding to the ELO Indexserver and to other sites is also displayed. This includes the number of data packages in the transmission queue.

Status information; monitoring replication

The link to http monitoring endpoint contains machine-readable information about the status page. This can be used for automatic monitoring.

http monitoring endpoint

11 Settings: This contains the version number and runtime details for ELO Replication. You can also select a period of time after which the saved transfer protocol files from the TransmissionDetailsHistory folder in the ELO directory.

Status display

12 Log off: Select this button to log off of ELO Replication.

13 Publish: To enable a replication, select Publish. For more information, refer to the chapter Publish replication.

14 Discard: To delete a draft or discard your changes, select Discard.

# Site settings

# Overview

In the configuration, you can add sites. A dialog box appears for each site where you can enter the data for the site. Your entries are saved automatically as soon as you leave an input field.

You can enter the configuration settings for all participating sites from your site. A configuration file with your settings is created automatically for each site. Download the configuration file by selecting Download configuration on the overview page. Send the configuration file to the relevant site. There, the administrator logs on to ELO Replication and uploads the configuration file. You can find more information in the section Create/insert a configuration for other sites.

Configuration settings

Name: Enter the name of the site.

# Interfaces

Click the plus icon to add an interface.

Schema: Select SSH or BundleExchange.

Once you have made a selection, a rectangle appears over the site in the viewer pane. You can move the rectangle with the mouse to connect two sites. To add a new connection, enable the New connection button and place the mouse on a site. The connection icon appears. Press and hold down the left mouse button and drag the connection to a rectangle of another site. You can only connect interfaces of the same schema. You can only place one rectangle per schema for a single site. This rectangle can be used to add connections to multiple sites. To delete a rectangle, enable the Delete button and click on the rectangle.

SSH schema

IP address or server name: Enter the IP address or the name of the server ELO Replication is installed on.

Port: Enter the port for establishing the connection.

Please note

Do not change the firewall rules created by the ELO Server Setup in Microsoft Windows by adding the ELO Replication port. The ELO Server Setup may overwrite the rule in the future. You have to create a new rule for ELO Replication in the firewall settings.

The port must be enabled for ELO Replication.

BundleExchange schema

Site with 'BundleExchange' schema

BundleExchange enables data transmission between sites that do not share a network connection. In the configuration, specify a source folder and a target folder for file transfer. Enter the full folder path, e.g. C:\Replication\Target. ELO Replication writes files to the target folder in rBundle format for transferring to other sites. The target folder is monitored by ELO Replication. All rBundle files in this folder are processed as incoming file transfers. Data is transferred between the source and target folders using a third-party application that you must install yourself.

Information

You can add additional options for transferring data by creating and integrating plug-ins and by selecting them from the drop-down menu.

# Repositories

Click the plus icon to add repositories. A replication set is automatically created for each repository, which you can assign to an entry in the ELO Java Client or the ELO Web Client.

'Repositories' setting

Name: Enter the name of the repository.

Indexserver URL: Enter the URL to the ELO Indexserver.

Scheduler for automatic transfer: Define when to export data from the repository. In the drop-down menu you will find the preconfigured intervals Default and No automatic export, as well as all intervals you have created. To create new intervals or change existing ones, select the pencil icon. For detailed information, refer to the Scheduler for automatic transfer chapter.

Information

The scheduler for automatic data transfer allows you to control the export of data. If you do not want to export data from the selected repository, select the No automatic import schedule. In this case, there is no scheduled data export from the repository; instead, data will only be automatically imported into the repository. If necessary, you can trigger data export manually.

Conflict handling: To prevent conflicts during the replication process, you can choose from three different options:

  • Retain local: If changes are made at both sites, the local changes are retained and changes imported during the replication process are discarded.
  • Overwrite local: If changes are made at both sites, the local changes are discarded and changes imported during the replication process are applied.
  • Latest change: This is the default setting. If changes are made at both sites, the most recent changes are always applied.

'Repositories' setting; conflict handling

# Scheduler for automatic transfer

The scheduler for automatic transfer allows you to define when to export data from the repository. In the drop-down menu you will find the preconfigured intervals Default and No automatic export, as well as all intervals you have created.

Please note

The specified interval time refers to the local time of the respective server. All servers hosting repositories involved in replication must be in sync in terms of time for the comparison via timestamp to work.

Please note

The scheduler calculates in hours. For example, if you enter a time from 8:00 a.m. to 6:00 p.m., replication begins at 8:00 a.m. and ends at 6:59 p.m.

# 'Default' interval

In the Default interval, data is exported from the repository: every 60 minutes, from 8 a.m. to 6 p.m., from Monday to Friday.

# 'No automatic export' interval

The scheduler for automatic data transfer allows you to control the export of data. If you do not want to export data from the selected repository, select the No automatic import schedule. In this case, there is no scheduled data export from the repository; instead, data will only be automatically imported into the repository. If necessary, you can trigger data export manually.

# 'Scheduler for automatic transfer' menu

To create new intervals or change existing ones, select the pencil icon.

'Scheduler for automatic transfer' menu

The Scheduler for automatic transfer menu opens. Clicking the plus icon adds a new schedule. Clicking the eraser icon deletes a schedule.

The input options Simple and Expert are available for the scheduler for automatic transfer. With the input option Simple, you can choose from default intervals and customize them. With the input option Expert, you can control the scheduler for automatic transfer more precisely using variables.

Only one of the two options can be enabled. To use the expert input option, go to the Expert tab and check the Use expert mode box.

# 'Simple' input option

Add a new schedule with the plus icon.

'Simple' input option

In the Repeat every field, set an interval for exporting data.

In the fields Limit from … to …, you specify during which hours replication should take place. In the example above, replication takes place in the morning at 8:00, 8:15, 8:30, and 8:45.

In the fields Between ... and ..., set the days of the week to repeat replication.

# 'Expert' input option

With the input option Expert, you can control the scheduler for automatic transfer more precisely using variables.

Add a new schedule with the plus icon.

'Expert' input option

# Syntax

Field Input
Minute 0-59
Hour 0-23
Day of the month 1-31
Weekday 1-7 (1 is Sunday)
Month 1-12

Please note

You can set the days in two fields: Day of the month or Weekday. To avoid competing entries, set the days in either the Day of the month or Weekday field. In the other field, enter the variable ?. The field with the variable ? is not run.

# Variables

Variable Meaning
* Always run (every...)
*/n Run every n
n,x,y Run at/on n, x, and y
n-x Run from n to x (x included)
? Field is not run; only applies to Day of the month and Weekday

The following presents two examples of expert scheduling:

# Example 1

Example 1 of expert scheduling

In this example, replication takes place:

  • Every 15 minutes
  • From 6:00 a.m. to 8:45 p.m.
  • From Sunday to Thursday
  • Every month

The field Day of the month is not evaluated as it contains the variable ?.

# Example 2

Example 2 of expert scheduling

In this example, replication takes place:

  • In minute 0 and 30
  • From 8 a.m.
  • From the 1st to the 10th day of the month
  • In February

The field Weekday is not evaluated as it contains the variable ?.

# Time display of the next data export

Time of the next data export

After creating the schedule and publishing the replication, you can see when the time of the next data export is scheduled in the overview page of each site.

# Publish replication

To enable a replication, you have to publish your draft. In draft mode, select Publish.

Please note

During initial configuration, you will have to publish the replication at all participating sites. In case of later changes, you only have to publish the new draft at one site. The changes are automatically applied to all sites.

If you add a new site for an active replication, you will have to upload the configuration file at the new site and publish the replication there.

'Publish' button

Please note

You cannot publish a draft until you have completed all entries. You can check this with the status message that is displayed at the bottom of the window.

Changes: Correct: Your entries are complete. You can publish the draft.

Changes: Incomplete: You still need to make entries. An error message is displayed in the corresponding section and you can select Navigate to error to go straight to the incomplete input field.

Error message on incomplete input

# Create/insert a configuration for other sites

# Information

You can enter the configuration settings for all participating sites from your site. A configuration file with your settings is created automatically for each site. Download the configuration file by selecting Download configuration on the overview page. Send the configuration file to the relevant site. There, the administrator logs on to ELO Replication and uploads the configuration file.

Please note

During initial configuration, you will have to upload a configuration file at all sites. In case of later changes, you only have to publish the new draft at one site. The changes are automatically applied to all sites. For more information, refer to the chapter Edit configuration.

If you add a new site for an active replication, you will have to upload the configuration file at the new site and publish the replication there.

# Site 1: Download configuration file

Requirement: You have completed site configuration and published the replication at site 1.

  1. On the overview page, select an external site you have already configured.

    'Load configuration' button

  2. Select the Load configuration button.

    The configuration is downloaded as a JSON file. The site name is used as the file name.

  3. Send the configuration file to the administrator at the other site.

# Site 2: Upload configuration file

  1. Log on to ELO Replication with your Apache Tomcat administrator account.

Information

You do not have to enter a site name. The site name from the configuration file is automatically applied.

Upload configuration file

  1. Insert the configuration file.

  2. Confirm the site.

    Confirm site

    Once you have confirmed the configuration file, draft mode opens. You will see the sites in the replication network. The settings from the configuration file were applied.

  3. To enable the replication for your site, select Publish.

# Result

The replication sets are created. The SSH port is started.

# Next step

Once you have published the replication at the participating sites, you have to assign the individual entries replication sets. This means you determine what entries are replicated and where. For more detailed information, refer to the chapters Assign replication sets and Replication set inheritance.

# Replication set inheritance

Replication sets are automatically created in the configuration when you add a new repository. Each replication set stands for one repository. The replication set is a characteristic that you assign to individual repositories in order to replicate them in another repository. The individual entries (folders, documents) to be replicated are selected in the ELO Java Client or ELO Web Client using the Assign replication sets function.

Information

You only have to assign replication sets at one site. The assigned replication sets are also configured at the other sites through replication.

# Default: Inheritance to parent folder

Replication sets are inherited upward to parent folders in the repository structure.

Example: If you assign the folder C including its child entries a replication set, the entries marked in yellow are replicated. The replication set is inherited to the parent folders.

Inheritance to parent folder

# 'Start point for replication' option

To prevent the replication sets from being inherited to the parent folders, select the Start point for replication option in the Metadata dialog box of the entry you want to replicate. The Start point for replication option allows you to replicate parts of repositories that are not filed to identical repository structures.

Please note

In the ELO Java Client, this function is only available for folders.

Please note

Enable the Start point for replication option before assigning the entry a replication set.

'Metadata' dialog box; 'Start point for replication' option

Example: You have enabled the Start point for replication option for the C folder. If you then assign the C folder including its child entries a replicated sets, only the folder C and its child entries are replicated (marked yellow). The replication set is not inherited to the parent folders.

Folder as 'Start point for replication'

During the next replication process, the C folder is filed to the following path in the target repository: // Administration // Replication Base. From there, the administrator moves the folder to the desired site in the target repository. This only has to be performed during the initial replication process. The replication remembers the repository structure.

# Assign replication sets

# Information

Replication sets are automatically created in the configuration when you add a new repository. Each replication set stands for one repository. The replication set is a characteristic that you assign to individual repositories in order to replicate them in another repository. The individual entries (folders, documents) to be replicated are selected in the ELO Java Client or ELO Web Client using the Assign replication sets function. This means you select a repository the entries are replicated to. The name of a replication set in the ELO client is made up of the site name and the name of the repository.

Information

The following uses screenshots of the ELO Java Client.

Information

You only have to assign replication sets at one site. The assigned replication sets are configured at the other sites through replication.

ELO Java Client; 'Assign replication sets' function

You will find the Assign replication sets functions in Ribbon > Organize > Properties.

# Requirements

You need the right Assign replication sets. This right is enabled in the ELO Administration Console.

Please note

You should log which entries you assign which replication sets.

Please note

Documents with the status Version control disabled cannot be replicated. You will find the document status at Ribbon > Organize > Metadata > 'Options' tab.

# Step by step

  1. In the ELO client, select the entry you want to assign a replication set to.

  2. On the ribbon, select Organize > Properties > Assign replication sets.

    The Assign replication sets dialog box opens.

  3. Select Add.

    'Add replication set' dialog box

    The Add replication set dialog box opens.

    You will see all the replication sets defined in the configuration. The name of the replication set is made up of the site name and the name of the repository.

    Information

    The local replication set, that is the replication set where the entries are located, is assigned automatically. You do not have to add it manually.

  4. Select one or more replication sets and confirm with OK.

    Transfer of replication sets to the selection list

    The replication sets appear in the Assign replication sets dialog box.

    Please note

    Replication sets are inherited upward to parent folders in the repository structure. To prevent inheritance, select the Start point for replication option in the Metadata dialog box of the entry you want to replicate. In the ELO Java Client, this function is only available for folders. You will find more information in the chapter Replication set inheritance.

    The following options are available:

    Including child entries: If this option is enabled, the replication set is also assigned to the child entries of the selected entry.

    Set: All the listed replication sets are assigned to the entry.

    Differences: This option should only be used in combination with the Include child entries option. Differences: If you removed replication sets from the list and/or added replication sets to the list, this change is passed on to the entries. Replication sets from the list that were not changed are not passed on. The replication sets of the entries that were not changed are retained.

    Example: 'Differences' option

    In the example above, a folder and its child folders have different replication sets. The Assign replication sets dialog box opens for the folder. The Include child entries option is enabled. The Blue, Orange, and Pink replication sets are already assigned to the folder. The Green replication set is added. The Differences option is selected. The Green replication set is added to the list again. This change is passed on to the folder and its child folders. Replication sets from the list that were not changed are not passed on. The Blue, Orange, and Pink replication sets are not assigned again. This means the child folder is not assigned the Pink replication set. The replication sets of the entries that were not changed are retained. Folders and child folders retain their original replication sets and are additionally assigned the Green replication set.

    Cut: The replication sets are assigned to the entry. The replication sets that are not within this intersection are removed. This option should only be used in combination with the Include child entries option. Use the Cut option if, for example, it is unclear due to the set Start point for replication which replication sets are assigned to the child entries and you only want to inherit the replication sets selected in the dialog box. In contrast to the Set option, with the Cut option you cannot assign any new replication sets. With the Cut function, you can delete replication sets from child entries that are not contained in the parent entry.

    Example: 'Cut' option

    In the example above, a folder and its child folders have different replication sets. The Assign replication sets dialog box opens for the folder. The Include child entries option is enabled. The Blue, Orange, Pink, and Yellow replication sets are already assigned to the folder. The Orange replication set is deleted. The Cut option is selected. The replication sets are assigned. The replication sets that do not overlap between the initial status and the reassignment are removed. Only the Orange replication set is removed from the folder. With the child folder, the Orange, Green, and Yellow replication sets do not overlap between the initial status and the reassignment. For this reason, the child folder is not assigned the Yellow replication set. The Orange and Green replication sets are removed from the child folder.

  5. Make the desired changes to the settings and confirm with OK.

# Result

You have assigned the selected replication sets. During the next replication process, the selected entry will be replicated.

# Outlook

You can check the transfer status on the ELO Replication overview page.

Repository icon in the transfer overview

On the overview page, select a site. The transfer overview opens on the right. You will recognize a replication based on the repository icon in the Type column. Successful transfer is indicated by two check marks in the Status column. For more information, refer to the chapter Monitoring.

# Edit configuration

# Information

You can edit the configuration of a published replication. During editing, the replication remains active. To apply your changes to the published replication, select Publish in draft mode.

Information

If you publish a new draft, the changes are automatically applied to all sites. You do not have to update the configuration manually at the different sites.

If you add a new site, you will have to upload the configuration file at the new site and publish the replication there. You can find more information in the section Create/insert a configuration for other sites.

# Step by step

Edit draft

  1. On the overview page, select Edit draft.

    Draft mode opens.

    For more detailed information on the configuration settings, refer to the Draft mode (overview), Site settings, and Scheduler for automatic transfer chapters.

  2. Make the desired changes. Your changes are saved automatically as soon as you leave an input field.

  3. To end editing, you have the following options:

    • Publish changes: To apply your changes to the published replication, select Publish.
    • Discard changes: To delete your changes, select Discard. The published replication is not changed.
    • Save draft: If you don't want to publish the new draft yet or want to continue editing it at a later point in time, exit draft mode by clicking the back arrow or log off. Your draft is saved automatically. The published replication is not changed. To continue editing, select Edit draft on the overview page.

# Result

You have edited the replication.

# Outlook

If you've published a new draft, the changes are automatically transferred to all sites. You can check the transfer status on the ELO Replication overview page.

Transfer overview

On the overview page, select a site. The transfer overview opens on the right. You will recognize that a new draft is being transferred based on the gear icon in the Type column. Successful transfer is indicated by two check marks in the Status column. For more information, refer to the chapter Monitoring.

# Pause transmission

# Information

You can pause transmission during a replication process. In this case, the Scheduler for automatic transfer is temporarily disabled. During this time, you can perform actions such as maintenance work on the ELO system without having to change the scheduler configuration in ELO Replication.

# Step by step

'Pause export' button

  1. Select the Pause export button. This pauses the export of data from the repository.

    'Continue export' button

  2. Select the Continue export button.

# Result

The scheduler for automatic transfer is enabled again and the export of data is resumed.

Dernière mise à jour: 17 juin 2024 à 14:07