File Server (fs)

Description

A service role used for redundant long-term file storage on system servers. It can be configured as an attachment storage for collections in the dynamic data model (DMS).

Each file is placed simultaneously on all servers of the site where the role is active.

Table 1. System characteristics

Code

fs

Operation mode

Service

Redundancy mode

Active-Active

Site types

All

Layer

Configuration

Placement

Internal

State preservation and recovery on restart

Yes

Application

era_fs

Limitations

  • Does not perform delayed periodic synchronization. (TODO)

Parameters

Table 2. Parameters
Name Type Default Description

name

str

required

Name. May consist of Latin letters and digits and must start with a letter.

roletype

str

required

Role type. Possible values: "fs".

ext

json

empty

Additional role options. Contains a JSON object or list.

enabled

bool

empty

Role activity flag. When set to false, the role does not participate in validation and is not started.

limit_of_cores

int

empty

Limit on the number of CPU logical cores used. Default: 0 - unlimited.

logging_default_level

int

empty

Default logging level set specifically for the role instance (microservice type). More

allow_divergence

bool

false

Flag allowing parameter differences in roles of the same group. Default: false - not allowed.

roleid

int

required

Role identifier.
Unique across the entire system, regardless of site or server. Cannot be changed.
An integer from 1 to 9999.

separate

bool

required

Flag indicating whether the role is allocated to a separate node.

Configuration example

Configuration management is performed in an application available to master domain administrators. The application hides the full configuration content, but it is still available through the API.

The configuration contains a section describing all instances of all roles. Parameters are defined for each specific role instance.

Node example
{
  "name": "fs1",
  "roleid": 11350,
  "roletype": "fs",
  "separate": true
}

See also