Installing the Datto Linux Agent

Follow

Scope

This article describes the requirements and procedure to install the Datto Linux Agent on supported machines.

The Linux agent protects Linux machines in conjunction with Datto's business continuity appliances, Siris and Alto 2

Requirements

To run the Datto Linux Agent, the machine must meet these requirements.

Protected system requirements

  • 64 bit OS
  • Linux kernel version 2.6.32 or newer, excluding the following incompatible kernels:
    • 3.13.0-65
  • 8G+ RAM
  • Internet connection
  • Corresponding Kernel Development package
    • Debian-based systems require a kernel-headers package to match the running kernel
    • RPM-based systems require a kernel-devel package to match the running kernel

Linux Distributions

  • Ubuntu 12.04 / 14.04 / 16.04
    • Ensure that 14.04 systems are not running kernel 3.13.0-65, which has a bug that breaks the screenshot process.
  • Fedora 20, 21, 22, 23, or 24 (Screenshot Verification supported)
  • CentOS 5, 6.x, or 7.x (Screenshot Verification supported for CentOS 6.x and 7.x only)
  • Red Hat Enterprise Linux 5, 6.x, or 7.x (Screenshot Verification and virtualization supported for RHEL 6.x and 7.x only) (Supports RHEL Kernel 2.6.18)
  • Debian 7.x and 8.x (Screenshot Verification supported)
  • openSUSE 13.1 and 13.2
  • SUSE Linux Enterprise 11 sp4
  • SUSE Linux Enterprise 12 sp1
  • openSUSE Leap 42.1
  • SUSE Linux Enterprise 12 sp2 and openSUSE 42.2
Updates for the Datto Linux Agent on openSUSE 13.1, Fedora 20, and Fedora 21 have been discontinued.

If you have a request to support any other distribution, please put in a feature request on our Community Forum.

Please note Datto does not support virtualizing disk images stored in Network Attached Storage volumes for any distribution.

Supported File Systems

  • ext2
  • ext3
  • ext4
  • xfs

To check your file system, run this command: df -h -T.

Other file systems may work, but they are not supported, and may result in large incremental backups.

Networking requirements

The following TCP ports must be open between the Datto appliance and the protected system:

  • 3260
    To check this port, run the following command on the protected system:
    nmap -T4 <ip address of Datto appliance> -p3260
  • 25567

The target machine must be able to reach device.dattobackup.com on port 443 to receive security certificates and update packages.

The target machine must be able to reach the following package servers:

  • https://cpkg.datto.com
  • http://mirrors.rit.edu

Citrix XenServer VMs

To install the agent on either Debian 7 or CentOS XenServer VM, follow these steps prior to the installation of the Linux agent: Installing the Linux Agent on a Citrix XenServer VM.

Prerequisites

Before installing the agent, make sure to install any required kernel header packages on Debian (or Debian-derived) distributions by running the following command:

  • sudo apt-get install linux-headers-$(uname -r)
If you've installed kernel updates, reboot your system before installing the Datto Linux Agent.

Installing the Agent

To install the agent, run the following command:

curl -sS https://cpkg.datto.com/getLinuxAgent.txt | sudo bash

The installer will launch. Enter to agree to the software license agreement, and install the Datto Linux Agent. 


Figure 1: Datto Linux Agent installation prompt.

Once you've installed the Linux agent on your target machine, log into the Datto's web interface and follow these steps:

  1. Click on the Protect link in the top menu bar.
  2. Click on the Linux & Legacy Add Agent link in the upper right of the window.
  3. You'll see the Protect a New System page. Skip the Download section and proceed to follow the instructions in the Prepare, Configure, Encrypt, and Add sections.

Installation Logs

Here are the locations of the installation logs on the supported distributions. If you have an issue with installation, check these logs for clues:

Ubuntu

/var/log/apt/term.log

CentOS / RHEL and Fedora 20-21

/var/log/yum.log

Fedora 22+

  • /var/log/dnf.log - Log of DNF actions
  • /var/log/hawkey.log - Log of repository actions (DNF uses hawkey to read repo data)

Agent Packages

The Datto Linux Agent comprises the following packages:

  • dlad - The Datto Linux Agent Daemon
  • libiscsi-datto - iSCSI library for sending data to the Datto appliance iSCSI target
  • dattobd-utils - Datto Linux Agent driver utilities package
  • dattobd-dkms - Datto Linux Agent DKMS support

Disaster Recovery Options

You can do a file restore or a virtualization of a Linux protected machine. You can use these features in the same way you virtualize or do a file restore of a Windows protected machines: through the Restore page of the Datto appliance's web interface. However, there is no functionality to do a Bare Metal Restore of a Linux protected machine.

Software Updates

The Datto Linux Agent does not automatically update itself when a new version becomes available. You will need to download and install these versions manually. To update the agent, run the apt-get install command that corresponds with your Linux version:

  • Debian/Ubuntu: sudo apt-get install dlad
  • openSUSE/SLE: sudo zypper install dlad
  • RHEL/CentOS/Fedora 20-21: sudo yum install dlad
  • Fedora 22+: sudo dnf install dlad 

The current release of the Datto Linux Agent is 1.0.5. You can check the protected machine's agent version from the Protect tab of your Datto appliance's GUI.

Troubleshooting

For troubleshooting instructions, see these articles:

Additional Resources


Was this article helpful?

22 out of 23 found this helpful

You must sign in before voting on this article.

Want to talk about it? Head on over to our Community Forum!

  • Avatar
    Adrianne Mora

    For those who have questions and comments on product features, please visit our new Community forum at community.datto.com.