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 URLfile parsingextraction failures[cite: 4].failures.

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 introducesrequires aspecific breaking changelibraries for the Synology snapshot driver (synosnap) by replacing the standard libaio1 package with libaio1t64[cite: 9]. We must install the newcompatibility packagepackages and createthe aunzip compatibilityutility symlinkto sohandle the installer can locate the expected library[cite: 10].archive.

1. Install required builddependencies

tools

This command ensures the system can extract the installer and kernel headers

Matchhas the kernelnecessary headerslibraries to your 7th-gen i5's active kernel to ensurefor the DKMSsnapshot module compiles correctly[cite: 12].driver.

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

2. Create the backward-compatibility symlink

Synology ABB looks for libaio.so.1. Since Ubuntu 24.04 uses a newer naming convention, a symlink is required.


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 generatesThe download links containing query parameters. To prevent the Linux shell from misinterpreting these characters, the URL must be enclosed in quotes[cite:quotes 19,to 20].ensure the shell handles the query parameters correctly.


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 archiveZIP file into a dedicatednew directorydirectory, navigate into that directory, and run the installer script to compile the snapshot driver[cite: 24, 27, 28].script.


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






Phase 3: NAS Authentication


OnceAfter installation, connect the driveragent isto successfullyyour compiled,Synology NAS using the microcommand-line PC must authenticate with the destination Synology NAS[cite: 32].interface.


sudo abb-cli -c


Note: You will be prompted to supply the NAS IP address, an authorized username, and ayour password[cite: 36].password.








⚙️ Hardware Optimization & Maintenance Notes


    

  • NVMe SSD Performance: To prevent performance degradation on your 256GB NVMe SSD, ensureEnsure the OS is schedulingschedules regular TRIM operations[cite:operations:
38, 39]: 
    sudo systemctl enable --now fstrim.timer
    

    • 

  • KVM Interrupts: DuringIf initialyour video signal (TESmart/JetKVM) drops during full backups, disk I/O demands will peak. If your KVM (TESmart/JetKVM) loses signal, the motherboardit is likely prioritizingdue to high NVMe hardwareI/O interrupts over video[cite: 40, 41].priority.
    • 

  • Scheduling: Schedule subsequentPlan incremental backups during off-hourslow-activity periods to avoidminimize terminalresource interruptions[cite: 42].contention.
    • 






    
        

    


            

        

    


    


    
    

        

             Back to top