BSR User's Guide - eng

Block Sync Replication (BSR) is a solution for software real-time replication of block devices on a host over a network.

The code of BSR is based on Windows DRBD (https://github.com/mantechnology/wdrbd ), which is a fork of drbd (http://www.drbd.org) and is an open source project built with a common cross-platform engine that supports both Windows and Linux platforms. It inherits all the basic concepts and features of Windows DRBD and complements the problems and features of the existing drbd to provide a solution to build a more stable and faster replication environment.

This user guide is organized as follows.

Overview Introduces the basics and key features of BSR replication.

Environment Describes the supported platforms and specifications. Before installing, you should refer to this content to check the required specifications and points to note.

Installation This section describes the installation process and precautions for Windows and Linux.

Configuration Describes various configuration methods and provides examples of configurations. You should know the basics of creating resources and what to look out for.

Working Describes the procedures and methods for actual operation. Among them, the basic procedures for operating resources and configuring them for efficient synchronisation are essential to understand.

Troubleshooting Describe the various failure situations encountered during operation and the procedures to deal with them. Covers disk failures, node failures, split-brain, and compatibility issues.

Optimization Describes how to optimise replication performance. Explains it in terms of throughput and latency.

Internals Describes in detail the internal workings of the BSR replication engine. If you want to understand BSR in more depth, we recommend reading this chapter.

Appendices Describes recent changes, configuration file formats, CLI commands, and more, and is updated with each bsr version revision.

BSR is an open source community (https://github.com/mantechnology/bsr, https://github.com/mantechnology/bsr/issues ) and anyone is free to contribute and participate in its development.

For questions regarding bsr, please contact Mantech at bsr@mantech.co.kr.