Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


DRX requires configuration of individual replication resources and global settings required to perform drx. Configuration for individual resources is done in the proxy section of each replication configuration file, and global settings are configured through the drx.conf file.

All configuration below is based on working with Block Replication (BSR). For integration with File Replication (FSR), see see Configuring File Replication file replication in the appendix.

  • If BSR is installed locally, you do not need to change the path to its configuration file as DRX automatically recognizes it through an environment variable. /etc/bsr.conf is the default path and can be changed through drx.conf.
  • It describes replication connections, setting buffer sizes and options, etc. By default, it's written in the same format as the BSR configuration file, and you'll usually end up modifying some of the contents of bsr.conf that was already written when BSR was installed locally (see Format of the BSR configuration file).

...

  • Connections: Set the DRX inbound IP and outbound IP addresses to work with replication.
  • Buffers: Set buffer size per resource (channel)
    • memlimit
    • rx-memlimit
  • Compression/Encryption: Set compression/encryption features ON/OFF

...

Info
title1:1 replication
  • proxy on [ proxy on hostname ] section of on [hostname] section 
    • inside [ proxy inside ip address]:[ port ]
    • outside [ proxy inside ip address ]:[ port]
  • proxy section
    • memlimit
    • plugin section
      • compressor [zlib | lz4 | iqa] level [1~9]
      • crypto openssl
      • rx-memlimit


Info
title1:N replication
  • host [ hostname] address [ host ip address ]:[port] via proxy on [proxy on hosname] section of connection section 
    • inside [ proxy inside ip address]: [ port ]
    • outside [ proxy inside ip address ]: [ port]
  • proxy section
    • memlimit
    • plugin section
      • compressor [zlib | lz4 | iqa] level [1~9]
      • crypto openssl
      • rx-memlimit

Local configuration

  • With DRX installed and running on node1 and node2 local machines, the contents of "bsr.conf" on node1 and node2 are the same on both nodes.
  • The following is an example of a 1:1 replication configuration and a 1:2 replication configuration.
  • Note that the respective port information must be exceptionally handled by the firewall and configured so that there are no redundant ports.

...

typepropertydefault valuedescription
normallangenglishDRX language settings file
  • Located in "base-dir/lang" of the configuration.
  • ex) korean.ini
base-dir

DRX install path

Default path where DRX is installed

bsr-conf-path

Windows:

  • ../etc/bsr.conf

Linux:

  • /etc/bsr.conf
Specify the path to bsr.conf
fsr-conf-path

Windows:

  • ../etc/bsr.conf

Linux:

  • /etc/bsr.conf
Specify the path to fsr.conf
connect-timeout10

Timeout value in seconds after connecting to a remote DRX, while sending and receiving initialization packets

bwlimit0 (unlimited)Bandwidth limit on sending (incoming bandwidth controlled by bwlimit value on remote DRX)
ip-verificationon

on: Allow only the IP connections set in dbd.conf.
off: Allow connections for all IPs.

ulimit-open-files-count0

Applies to Linux only and sets the number of files the process can open.

Values : -1 (10240), 0 (same as system setting), Specify yourself (1-65536)

ipc-port9100Specify internal ipc port values for the CLI to control the drx (supported in version 1.3.1 and later).
logloglevel-fileinfo

Specify the log level that is written as a file

  • Location: stored in the logs folder of the installation path
loglevel-consoleinfoSpecify the log level that is output to the screen in foreground mode
logfile-max-size10MFile size limit per log file
logfile-max-count10Maximum number of log files kept by type
performance-logoffWhether to save performance statistics log
compress/encrypt



block-size63K

Block size to be used for compression/encryption

  • Note: The size of the transfer buffer for compression/encryption is set to twice the block-size value and is set to 1MB maximum.
min-raw-block-size1KMinimal packet size to send as plain text even when compression/encryption is set.
process-thread-count-1 (auto)

Number of threads to use when processing multi-thread packets.

※ It is intended for tuning and debugging, so it is not recommended to make any changes. 

...

drx.conf sample

drx.conf

BSR Proxy configuration
#
[global]
language settings file
# lang=korean

Default path where DRX is installed
# base-dir=/opt/DRX

Specify the path to bsr.conf
# bsr-conf-path=c:\program files\DRX\bsr.conf

Bandwidth limit on sending
# bwlimit=100M

Block size to be used for compression/encryption
# block-size=100K

Minimal packet size to send as plain text
# min-raw-block-size=256K 

Timeout value
# connect-timeout=10

# Confirmation of binding IP that listens for connection
# ip-verification=off

# log levels: off < trace < debug < info < warning < error < critical
Specify the log level that is output to the screen in foreground mode
# loglevel-console=info

Specify the log level that is written as a file
# loglevel-file=info

File size limit per log file
# logfile-max-size=10M

Maximum number of log files kept by type
# logfile-max-count=10

Whether to save performance statistics log
# performance-log=off

# multi-threaded packet processing. default is auto(-1), disable to 0
# process-thread-count=8


...