The bsr installation package is available has packages for Windows and Linux. For Linux, CentOS (RHEL, and for Linux it is distributed as an rpm package for RHEL (CentOS) 6.4 or higher rpm , a deb package and for Ubuntu 16.04 LTS or higher deb package are distributed, and a SUSE package. To obtain the an installation package, please contact Mantech Technology Research Institute (dev3@mantechbsr@mantech.co.kr).

Windows

...

Install

You can easily install it by running the installer for Windows and following the steps in guided by the installation wizard. After Once installation is complete, you will need to reboot restart your system.

...

Install Path

When the Once installation is completed successfully, the directory is 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

...

The bsr service performs initialization to perform replication. If service is interrupted, replication may be interrupted, so take care in controlling the service.

...

log file.

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 a the package while BSR bsr is installed, the update installation is performed automatically.

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.

Installation

...

will be installed automatically. You must restart your system after updating.

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.

Load

Load the bsr module.

Service configuration

The bsr service must be configured to automatically start bsr whenever the system starts.

...

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

• CentOS RHEL 7 or Ubuntu

  • systemctl enable bsr

  • systemctl start bsr

Information

After installation, check whether the installation is normal through module information.

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.

Deletion

The following is an example of the command to delete bsr.

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.