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.

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
    • 1G+ 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
    • VMware vCenter Server is unsupported.
The Datto Linux Agent does not currently support HIR for Linux EFI. Due to this limitation, screenshots, HIR, and Bare Metal Restore for EFI Linux agents are not supported.
The Datto solution is capable of backing up multiple types of disk sector schemes. The process writes an image-based backup to a file which is 512 bytes per physical sector. While rare, certain software which relies on advanced formats, such as 4K, may have issues with the sector size change. Datto recommends performing regular DR tests to ensure that all required applications function as expected in our virtualized environments.

Linux Distributions

The Linux Agent is considered EOL for distributions in red. Packages for them will remain available for the time-being, but new releases will not be made.

Distribution Latest version Screenshot Virtualization Notes
Red Hat Enterprise Linux/CentOS 5   N Y Must be running kernel version 2.6.18.
Red Hat Enterprise Linux/CentOS 6   Y Y  
Red Hat Enterprise Linux/CentOS 7   Y Y  
         
Fedora 20  1.0.9 Y Y  
Fedora 21 1.0.9 Y Y  
Fedora 22 1.0.11 Y Y  
Fedora 23 1.0.11 Y Y  
Fedora 24   Y Y  
Fedora 25   Y Y  
Fedora 26   Y Y  
         
SUSE Linux Enterprise 11 SP 2   N Y  
SUSE Linux Enterprise 11 SP 3   N Y  
SUSE Linux Enterprise 11 SP 4   N Y  
SUSE Linux Enterprise 12   N Y  
SUSE Linux Enterprise 12 SP 1   N Y  
SUSE Linux Enterprise 12 SP 2   N Y  
         
openSUSE 13.2 1.0.11 N Y  
openSUSE Leap 42.1   N Y  
openSUSE Leap 42.2   N Y  
         
Debian 7   Y Y You may have to install sudo.
Debian 8   Y Y You may have to install sudo.
         
Ubuntu 12.04 1.0.11 Y Y  
Ubuntu 14.04   Y Y Screenshot verification is unsupported on kernel 3.13.0-65.
Ubuntu 16.04   Y Y  

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

Please note that 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:

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

        A successful connection will look like this:

        RHEL/CentOS:
        [root@msmith-centos7 ~]# nc -v 10.72.68.84 3260
        Ncat: Version 6.40 ( http://nmap.org/ncat )
        Ncat: Connected to 10.72.68.84:3260.
        Ubuntu/Debian:
        michael@MSmith-LinuxPC ~ $ nc -v 10.72.68.247 3260
        Connection to 10.72.68.247 3260 port [tcp/iscsi-target] succeeded!

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 server:

      • https://cpkg.datto.com

Figure 1 illustrates the data flow for the Datto Linux Agent.

Figure 1: Datto Linux Agent logical data flow (click for larger image)

 

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 2: 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. Follow the steps in the Protect a System Wizard article to add the protected machine to your Datto appliance.

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 of a Linux protected machine. You can use this feature in the same way you do a file restore of a Windows protected machines through the Restore page of the Datto appliance's GUI.

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.10 with driver version 0.9.16. 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?

23 out of 24 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.