Skip to main content

Installing Synology Active Backup for Business (ABB) Agent on Ubuntu Server 24.04

Objective: To successfully install and configure the Synology ABB Linux Agent on an Ubuntu Server 24.04 environment, bypassing common dependency errors and URL parsing failures[cite: 4].

Target Environment & Hardware

  • OS: Ubuntu Server 24.04 (Noble Numbat) [cite: 5]
  • Hardware: Micro PC (7th-gen Intel Core i5, 16GB DDR4 RAM, 256GB NVMe SSD) [cite: 6]
  • Target NAS: Synology DS1522+ (or equivalent DSM 7.3+ system) [cite: 7]

Phase 1: System Preparation and Dependency Resolution

Ubuntu 24.04 introduces a breaking change for the Synology snapshot driver (synosnap) by replacing the standard libaio1 package with libaio1t64[cite: 9]. We must install the new package and create a compatibility symlink so the installer can locate the expected library[cite: 10].

1. Install required build tools and kernel headers

Match the kernel headers to your 7th-gen i5's active kernel to ensure the DKMS module compiles correctly[cite: 12].

sudo apt update && sudo apt install -y dkms libaio1t64 make gcc unzip linux-headers-$(uname -r)

2. Create the backward-compatibility symlink

sudo ln -s /usr/lib/x86_64-linux-gnu/libaio.so.1t64 /usr/lib/x86_64-linux-gnu/libaio.so.1

Phase 2: Secure Download and Installation

Synology dynamically generates download links containing query parameters. To prevent the Linux shell from misinterpreting these characters, the URL must be enclosed in quotes[cite: 19, 20].

1. Download the authorized agent package

wget -O Synology_ABB_Agent.zip "https://global.synologydownload.com/download/Utility/ActiveBackupBusinessAgent/3.1.0-4967/Linux/x86_64/Synology%20Active%20Backup%20for%20Business%20Agent-3.1.0-4967-x64-deb.zip?model=DS1522%2B&bays=5&dsm_version=7.3.2&build_number=86009"

2. Extract and Execute

Extract the archive into a dedicated directory and run the installer script to compile the snapshot driver[cite: 24, 27, 28].

unzip Synology_ABB_Agent.zip -d synology_abb_installer
cd synology_abb_installer
sudo ./install.run

Phase 3: NAS Authentication

Once the driver is successfully compiled, the micro PC must authenticate with the destination Synology NAS[cite: 32].

sudo abb-cli -c
Note: You will be prompted to supply the NAS IP address, an authorized username, and a password[cite: 36].

⚙️ Hardware Optimization & Maintenance Notes

  • NVMe SSD Performance: To prevent performance degradation on your 256GB NVMe SSD, ensure the OS is scheduling regular TRIM operations[cite: 38, 39]:
    sudo systemctl enable --now fstrim.timer
  • KVM Interrupts: During initial full backups, disk I/O demands will peak. If your KVM (TESmart/JetKVM) loses signal, the motherboard is likely prioritizing NVMe hardware interrupts over video[cite: 40, 41].
  • Scheduling: Schedule subsequent incremental backups during off-hours to avoid terminal interruptions[cite: 42].
Back to top