Section general

Description

General configuration settings that do not apply to other sections.

Partition parameters

Table 1. Partition parameters
Specification Description

Key: generaldomain
Mandatory: yes
Default: — 

Main domain alias from section "tds"

Key: version
Mandatory: yes
Default: — 

Configuration Version. Represents a strict value known to the system. Currently "3.0"

Key: master_admin_login
Mandatory: no
Default: — 

Master Admin Login.
Credentials skip requests to the system under the administrator role.
The account itself does not exist in the domain.

Key: master_admin_pwd
Mandatory: no
Default: — 

Master Admin Password.
May be specified as an encrypted value.
You can encrypt and decrypt the password via API.
The cipher key depends on the current system instance.

Key: logging_min_disk_space
Mandatory: no
Default: 3

Minimum amount of free disk space at which logging will be disabled, in GB.

Key: logging_role_store_days
Mandatory: no
Default: 2

The number of days for which log files are stored in the working directory of the role node.

Key: logging_role_max_size
Mandatory: no
Default: 100

Maximum size of log files that can be occupied by a single role node (log directory in the role node’s working directory), in GB.

Key: logging_default_level
Mandatory: no
Default: "INFO"

Default logging level applied to all nodes.

Applies to those nodes that do not have a default logging level set by the configuration settings server or site, or the current logging level is not set using the API or from the master domain administrator application.

The default level is applied before running role/microservice applications.
It is important to remember that individual microservices have their own logging level settings for specific logs. For example, SIP signaling trn logs, media gateway debug logs, websocket web server trace.

Possible values:

  • CRASH

  • ERROR

  • WARNING

  • INFO

  • TRACE

  • DEBUG

Key: sip_stat_timeout_callinfo
Mandatory: no
Default: 1200

Storage time in seconds for call statistical information. Applies to monitoring requests /api/monitor/v1/trace/calls.
By default, data is saved for 20 minutes.
The longer the time - the longer in time from the moment of making a call the data can be provided by the monitoring request. At the same time, more RAM is required in the nodes of the cip alarm system.

Applies to those nodes for which no value is set by the configuration setting server or site.

Possible values from 0 to 86400. 0 - no saving is performed.

Key: sip_stat_timeout_closure
Mandatory: no
Default: 12600

Time to store in seconds the statistical information about the mappings between Call-Id of phone calls of one session to calculate closures. It is used when building call diagrams.
Also stores information about Call-Id call relationships to system domains to enable diagramming in work domains on their own calls.
By default, data is saved for 3.5 hours.
The longer the time - the longer in time from the moment of making a call can be built closures and diagrams on SIP-signaling session. At the same time, more RAM is required in the SIP signaling nodes.

Applies to those nodes for which no value is set by the configuration setting servers or site.

Possible values from 0 to 86400. 0 - no saving is performed.

Key: cdr
Mandatory: no
Default: true

cdr-event switch. Used for test loops and call generators in load benches. Without cdr events the load is significantly reduced, but there is no functionality of cti events, ccs events of interaction with call center, call recording.

Key: check_quorum
Mandatory: no
Default: false

Default quorum accounting switch.
Applies as the default value unless otherwise specified in site-specific properties.
If the parameter is not set globally and is not defined in the settings of a particular site, the quorum mechanism is not applied to that site.

Quorum - a group of actively linked and accessible servers on a site totaling more than half.
The use of quorum ensures the integrity of data at the moment when the site is scattered into several parts, due to the fact that functioning is maintained only on the part that has a quorum, and such at any given time is not more than one.
The quorum detection algorithm is executed in nodes where a master instance of any of the roles reserved in Active-Passive mode is started or running - at the time of activation and every 10 seconds during operation.

Key: odd_referee
Mandatory: no
Default: — 

The address or domain name of the third-party server that acts as an odd arbitrator in determining quorum among an even number of servers.
The arbitration server is verified by sending a ping request.
Applies as the default value unless otherwise specified in the site properties.
If the parameter is not set globally and is not defined in the settings of a particular site, when determining the quorum at that site, it is assumed that the arbitration server is available and a quorum is available.
The arbitration server is used only if the number of configured servers on the site is even and exactly half of them are available.

Key: pwd_hash_alg
Mandatory: no
Default: — 

Hash function for storing user passwords. By default, the parameter is absent and the hash function is not used, user passwords are stored in the database in clear form. Similar to the value "none".
In case sha, sha256, sha384, sha512, md5 are specified - when the user password is changed, it is placed in the database in hashed form, and the checked value is hashed during verification.
Any other value - disables hashing.
When the parameter is changed, the data in the database are not changed and require new passwords for all users.
In case of using external authorization scripts (password verification in an external system), user account passwords stored in the database are not used in normal mode, and can be used only in case of errors in the script assignment or operation.

Example of field value

{
  ...
  "general": {
    "generaldomain": "td_main",
    "master_admin_login": "superduke",
    "master_admin_pwd": "megaPassword42",
    "version": "3.0"
  },
  ...
}