bsr installation package is available for Windows and Linux. For Linux, CentOS (RHEL) 6.4 or higher rpm package and Ubuntu 16.04 LTS or higher deb package are distributed. To obtain the installation package, please contact Mantech(dev3@mantech.co.kr)
Notice
If bsr runs together with drbd installed, there is a conflict about system resource usage. If drbd was previously installed on your system, you need to uninstall it.
Windows
Installation
You can easily install it by running the installer for Windows and following the steps in the installation wizard. After installation is complete, you will need to reboot your system.
Information
When the installation is completed successfully, the directory is configured as below.
bin
Contains binary programs that make up the bsr.etc
Path to the configuration file.jre
Path to the Java runtime environment for the installation package.bsrservice
Path to the bsr service binary.
The bsr service performs initialization to perform replication. If service is interrupted, replication may be interrupted, so take care in controlling the service.
Windows' bsr uses local ports 5678 and 5679 internally to perform TCP loopback communication. To change this default port, you need to change the key value in the following registry path and restart the system.
path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\bsr\
key: netlink_tcp_port, daemon_tcp_port
Update
If you reinstall a new version of a package while BSR is installed, the update installation is performed automatically.
Re-installing the existing version by deleting it from the program and function of the control panel can be cumbersome since rebooting is required after deletion. It is not recommended to update after deleting from the control panel.
Delete
Deleting bsr can delete the bsr package from Programs and Features in Control Panel. The machine needs to be rebooted after deletion.
Linux
Linux distributes kernel modules and utility packages separately, so each must be installed individually and bsr services must be configured separately.
Secure boot support
bsr signs and distributes kernel module files for secure boot support. And you can use the kernel module only by registering the public signing key distributed with the rpm package on secure boot mode. The public signing key is installed in /etc/pki/mantech/ and register the public key as follows.
#mokutil --import /etc/pki/mantech/bsr_signing_key_pub.der
input password:
input password again:
The password can be freely selected and will be applied after reboot.
Installation
Kernel Module
CentOS
[root@bsr-01 bsr]# rpm -ivh kmod-bsr-1.6_3.10.0_957-A3.el7.x86_64.rpm
Ubuntu
Ubuntu package uses Dynamic Kernel Module Support (DKMS), and the following package installation is required for this.
root@ubuntu:/home/mantech# apt-get install git build-essential debhelper dkms docbook-xsl help2man python-all python-dbus python-gobject dh-systemd flex autoconf automake
Install the bsr-dkms package.
root@ubuntu:/home/mantech# dpkg -i bsr-dkms_1.6-A3_all.deb
If the installation fails due to a dependency problem, you can use the command below to solve the dependency problem and retry.
root@ubuntu:/home/mantech# apt-get -f -y install
Utility
CentOS
[root@bsr-01 x86_64]# rpm -ivh bsr-utils-1.6-A3.el7.x86_64.rpm
Ubuntu
root@ubuntu:/home/mantech# dpkg -i bsr-utils_1.6-A3_amd64.deb
Load
Load the bsr module.
[root@bsr-01 bsr]# modprobe bsr
Service configuration
The bsr service must be configured to automatically start bsr whenever the system starts.
CentOS 6
chkconfig bsr on
service bsr start
CentOS 7
systemctl enable bsr
systemctl start bsr
Information
After installation, check whether the installation is normal through module information.
[root@bsr-01 bsr]# modinfo bsr
filename: /lib/modules/2.6.32-754.24.3.el6.x86_64/extra/bsr/bsr.ko
license: GPL
alias: block-major-147-*
license: GPL
version: 1.6.0-PREALPHA3
description: bsr - Block Sync and Replication v1.6.0-PREALPHA3
author: Man Technology Inc. dev3@mantech.co.kr
retpoline: Y
srcversion: 8A7DAFDEC0E6383AFB76501
depends: libcrc32c
vermagic: 2.6.32-754.24.3.el6.x86_64 SMP mod_unload modversions
parm: minor_count:Approximate number of bsr devices (1-255) (uint)
parm: disable_sendpage:bool
parm: allow_oos:DONT USE! (bool)
parm: use_fast_sync:bool
parm: debug_fast_sync:bool
parm: enable_faults:int
parm: fault_rate:int
parm: fault_count:int
parm: fault_devs:int
parm: two_phase_commit_fail:int
parm: usermode_helper:string
[root@bsr-01 x86_64]# bsradm -V
BSRADM_BUILDTAG=GIT-hash:\ e3fff1406638405bef558c540c2622b24fc4e5f4\ build\ by\ root@centos803,\ 2020-03-09\ 02:02:01
BSRADM_API_VERSION=2
BSR_KERNEL_VERSION_CODE=0x000000
BSR_KERNEL_VERSION=0.0.0
BSRADM_VERSION_CODE=0x010600
BSRADM_VERSION=1.6.0-PREALPHA3
Update
Kernel Module
CentOS
[root@bsr-01 bsr]# rpm -Uvh kmod-bsr-1.6_3.10.0_957-A4.el7.x86_64.rpm
Ubuntu
root@ubuntu:/home/mantech# dpkg -i bsr-dkms_1.6-A4_all.deb
Utility
CentOS
[root@bsr-01 bsr]# rpm -Uvh bsr-utils-1.6-A4.el7.x86_64.rpm
Ubuntu
root@ubuntu:/home/mantech# dpkg -i bsr-utils_1.6-A4_amd64.deb
Delete
CentOS
rpm -e kmod-bsr
rpm -e bsr-utils
Ubuntu
dpkg -r bsr-dkms
dpkg -r bsr-utils