Installation
- SungEun Kim
- 1 Windows
- 1.1 Install
- 1.2 Install Path
- 1.3 Load
- 1.4 Service Config.
- 1.5 Uninstall
- 1.6 Update
- 2 RHEL
- 2.1 Install
- 2.2 Install path
- 2.3 Load
- 2.4 Service config.
- 2.5 Uninstall
- 2.6 Update
- 3 Ubuntu
- 3.1 Install
- 3.2 Install path
- 3.3 Load
- 3.4 Service config.
- 3.5 Uninstall
- 3.6 Update
- 4 SUSE
- 4.1 Install
- 4.2 Install path
- 4.3 Load
- 4.4 Service config.
- 4.5 Uninstall
- 4.6 Update
The bsr installation package has packages for Windows and Linux, and for Linux it is distributed as an rpm package for RHEL (CentOS) 6.4 or higher, a deb package for Ubuntu 16.04 LTS or higher, and a SUSE package. To obtain an installation package, please contact Mantech Technology Research Institute (bsr@mantech.co.kr).
caution
If bsr is installed and operated together with drbd, conflicts related to system resource use may occur. If drbd was previously installed on your system, you must uninstall it.
Windows
Install
You can easily install it by running the installer for Windows and following the steps guided by the installation wizard. Once installation is complete, you will need to restart your system.
Install Path
Once installation is completed successfully, the directory will be configured as shown below.
bin
Binary executable files and script (bsrsupport, etc.) files, including the bsr service, are located here.
etc
Configuration file path.
jre
Path to the Java runtime for the installation package.
log
Path to the bsr log file.
Windows bsr uses TCP loopback ports 5678 and 5679 for netlink and service purposes. To change this port, you must 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
Load
The Windows bsr kernel module is automatically loaded when the OS kernel is loaded.
Service Config.
Automatically configured by the bsr installation package.
Uninstall
Uninstall it from Programs and Features in Control Panel. You must restart the system after uninstall.
Update
Updating is the process of deleting an old version of a program and then installing a new version of the program.
If you reinstall a new version of the package while bsr is installed, the update will be installed automatically. You must restart your system after updating.
You can delete the program from the Control Panel and then reinstall it, but you must restart the system after uninstalling. If you immediately reinstall the program without restarting, a system crash may occur due to abnormal installation. Please note this.
RHEL
Install
Utility
Kernel module
Secure boot
During the kernel module installation process, the public key is installed in the /etc/pki/mantech/ path. To register (enroll) the public key in the UEFI console, first request registration (import) as follows.
Reboot after specifying the password. Enroll the public key in the UEFI console at reboot time.
Install path
/usr/sbin/
Binary executable files (bsradm, bsrcon, bsrmeta, bsrmon, bsrsetup, bsrsupport, bsrwatch) are located here.
/usr/lib/bsr/
Path to the script file (bsr service, notify).
/etc/bsr.d/
Path to the configuration file.
/var/log/bsr/
Path to the bsr log.
/usr/lib/modules/{kernel-version}.{version}.x86_64/extra/bsr/
Path to the bsr.ko module file.
Load
Load the bsr kernel module.
Service config.
To automatically start up the bsr resource whenever the system starts, you must enable the bsr service and configure the svc-auto-up option. The default value of svc-auto-up is yes.
RHEL 6
chkconfig bsr on
service bsr start
RHEL 7 or Ubuntu
systemctl enable bsr
systemctl start bsr
resource r0 {
...
on hostname {
options {
svc-auto-up yes;
}
}
...
}Uninstall
Uninstall goes through the following process.
stop resource
service stop
Delete kernel module
delete utility
Update
Updating involves deleting the already installed version and reinstalling it with a new version.
First, delete the product and then perform the following update processes in order.
Utility
Kernel module
Secure boot
If the existing bsr module public key has already been registered, no update is required.
If the private key and public key for Secure Boot have been updated, you must perform the Secure Boot setup process again.
Ubuntu
Install
Required Package
The Ubuntu package uses Dynamic Kernel Module Support (DKMS), which requires installation of the packages below.
Utility
Kernel module
If installation fails due to dependency issues, you can resolve the dependency issues using the command below and try again.
Secure boot
The dkms package automatically creates MOK and signs codes for third-party drivers in the final stage of installation.
The following screen is displayed during module installation to register the generated public key.
After selecting OK, enter the password to be used for MOK registration.
After rebooting the system, enter the UEFI console and register the public key to the system.
Install path
/usr/sbin/
Binary executable files (bsradm, bsrcon, bsrmeta, bsrmon, bsrsetup, bsrsupport, bsrwatch) are located here.
/usr/lib/bsr/
Path to the script file (bsr service, notify).
/etc/bsr.d/
Path to the configuration file.
/var/log/bsr/
Path to the bsr log.
/usr/lib/modules/{kernel-version}-generic/updates/dkms/
Path to the bsr.ko module file.
Load
Load the bsr kernel module.
Service config.
If you want bsr to always start automatically when the system starts, you must enable the bsr service and configure the svc-auto-up option. The default value of svc-auto-up is yes.
resource r0 {
...
on hostname {
options {
svc-auto-up yes;
}
}
...
}Uninstall
Uninstall goes through the following process.
stop resource
service stop
delete kernel module
delete utility
Update
Updating involves deleting the already installed version and reinstalling it with a new version.
First, Uninstall the product and then perform the following update processes in order.
Utility
Kernel module
Secure boot
If the existing bsr module public key has already been registered, no update is required.
If the private key and public key for Secure Boot have been updated, you must perform the Secure Boot setup process again.
SUSE
Install
Utility
Kernel module
Secure boot
During the kernel module installation process, the public key is installed in the /etc/pki/mantech/ path. To register (enroll) the public key in the UEFI console, first request registration (import) as follows.
Reboot after specifying the password. Enroll the public key in the UEFI console when rebooting begins.
Install path
/usr/sbin/
Binary executable files (bsradm, bsrcon, bsrmeta, bsrmon, bsrsetup, bsrsupport, bsrwatch) are located here.
/usr/lib/bsr/
Path to the script file (bsr service, notify).
/etc/bsr.d/
Path to the configuration file.
/var/log/bsr/
Path to the bsr log.
/lib/modules/{kernel-version}-default/updates/
Path to the bsr.ko module file.
Load
Load the bsr kernel module.
Service config.
If you want bsr to always start automatically when the system starts, you must enable the bsr service and configure the svc-auto-up option. The default value of svc-auto-up is yes.
resource r0 {
...
on hostname {
options {
svc-auto-up yes;
}
}
...
}Uninstall
Uninstall goes through the following process.
stop resource
service stop
delete kernel module
delete utility
Update
Updating involves deleting the already installed version and reinstalling it with a new version.
First, Uninstall the product and then perform the following update processes in order.
Utility
Kernel module
Secure boot
If the existing bsr module public key has already been registered, no update is required.
If the private key and public key for Secure Boot have been updated, you must perform the Secure Boot setup process again.