Skip to content

Latest commit

 

History

History
88 lines (72 loc) · 3.48 KB

INSTALL.md

File metadata and controls

88 lines (72 loc) · 3.48 KB

dattobd INSTALL

From Repositories

We recommend that you install the kernel module from Datto's repositories. Datto provides repos for x86-64 editions of RHEL/CentOS, Fedora, openSUSE, Debian, and Ubuntu LTS.

RHEL/CentOS

The repository install package datto-el-rpm-release is available for EL5+.

sudo yum localinstall https://cpkg.datto.com/datto-rpm/repoconfig/datto-el-rpm-release-$(rpm -E %rhel)-latest.noarch.rpm
sudo yum install dkms-dattobd dattobd-utils

Fedora

The repository install package datto-fedora-rpm-release is available for F24+, excluding Rawhide.

sudo yum install https://cpkg.datto.com/datto-rpm/repoconfig/datto-fedora-rpm-release-$(rpm -E %fedora)-latest.noarch.rpm
sudo yum install kernel-devel-$(uname -r) dkms-dattobd dattobd-utils

openSUSE

The repository install package datto-opensuse-rpm-release is available for openSUSE Leap 42.x. Due to the DKMS software not being present in openSUSE's default repositories, the X11:Bumblebee or other similar repository providing DKMS is required. The steps below assume no providers of DKMS are available, so it may not be necessary to add X11:Bumblebee if you can already get DKMS through an already-installed repository.

openSUSE Leap 42.x

sudo zypper addrepo http://download.opensuse.org/repositories/X11:Bumblebee/openSUSE_Leap_42.1/X11:Bumblebee.repo
sudo zypper install https://cpkg.datto.com/datto-rpm/repoconfig/datto-opensuse-rpm-release-42.1-latest.noarch.rpm
sudo zypper install dkms-dattobd dattobd-utils

Debian/Ubuntu LTS

sudo apt-key adv --recv-keys --keyserver keys.fedoraproject.org 370C85D709D26407
echo "deb [arch=amd64] https://cpkg.datto.com/datto-deb/public/$(lsb_release -sc) $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/datto-linux-agent.list
sudo apt-get update
sudo apt-get install dattobd-dkms dattobd-utils

These packages will install and configure the kernel module to start during the boot process. No further configuration should be required when installing using this method.

From Source

Dependencies

Note that this build process, while it should work with any distribution, has only been tested with the distributions below. The lowest supported kernel is 2.6.18.

Debian/Ubuntu

sudo apt-get install linux-headers-$(uname -r) build-essential

RHEL/CentOS/Fedora

sudo yum install kernel-devel-$(uname -r)
sudo yum groupinstall "Development Tools"

openSUSE/SLE

sudo zypper install kernel-default-devel
sudo zypper install -t pattern devel_C_C++

Getting, Building, and Installing

To retrieve the sources from our Git repository, clone the Git repository to your local computer.

cd into the directory created by git, and then run the following commands:

sudo make
sudo make install

Configuring the Kernel Module

To start the kernel module immediately, run:

sudo modprobe dattobd

If you would like to have the module be loaded automatically during boot, consult the documentation for your distribution.

Troubleshooting

On some systems, it may be necessary to let the system know of the location of the shared libraries. If you are having trouble getting dbdctl to run, run these two commands:

echo /usr/local/{lib,lib64} | sed 's/ /\n/g' | sudo tee /etc/ld.so.conf.d/dattobd.conf
sudo ldconfig

Usage

The kernel module is primarily controlled through dbdctl(8), which was installed previously. For usage instructions, see dbdctl.8.md.