The workstation agent is distributed as a portable version in the form of an archive containing all required files. Before installation, download the archive from the appropriate link below:
- Debian 12 or Debian 11;
- x86-64 processor architecture;
- The following package must be installed:
Install the package with: sudo apt install librsync2
Additional requirements for PostgreSQL support:
The following packages must be installed:
Install the packages with: sudo apt install libpq5 postgresql-client
Additional requirements for cloud services support (Google Drive, Yandex Disk, Amazon and S3 compatible clouds):
The following packages must be installed:
Install the packages with: sudo apt install libssl1.1 libcurl4
- To use a Linux workstation (network agent), you need Handy Backup Server Network.
- A centralized control panel for Handy Backup Server Network must be installed on a computer running Windows. Before configuring network agents, download Handy Backup and install the centralized control panel.
- The server and coordinator computer must allow incoming network connections from the workstation computer.
- The workstation computer must also allow incoming connections from the server computer.
- The machines must be on the same local network.
- Extract the archive contents.
Note: make sure the extraction path contains only Latin characters to avoid display issues in the interface.
- To generate the configuration file, run the workstation from the following path:
"archive extraction folder"/HandyBackupWorkstation8/bin/HandyBackupWorkstation8
- Edit the workstation configuration file located at the following path:
"archive extraction folder"/HandyBackupWorkstation8/etc/HandyBackup8/workstation.hbl
Enter the connection settings in the following lines:
- WorkstationHost: the IP address of the computer where the workstation is running;
- Name: the workstation name displayed when connecting to the coordinator;
- CoordinatorHost: the IP address of the computer where the coordinator is running;
- CoordinatorPort: if the coordinator port has not been changed, leave the default value.
- To apply the new configuration settings, restart the workstation from the following path:
"archive extraction folder"/HandyBackupWorkstation8/HandyBackupWorkstation8/bin/HandyBackupWorkstation8
- Create a backup copy of the configuration file in advance to preserve its current settings.
- Delete the HandyBackupWorkstation8 folder.
- Repeat the workstation installation process using the new archive.
- Replace the configuration file with the backup copy from step 1, or configure it again manually.
- Download the archive and extract it:
tar -C <extraction_folder> -xzf <path_to_archive>
Replace <path_to_archive> with the path to the downloaded archive and <extraction_folder> with the path where you want to extract the workstation.
- Run the workstation to generate the configuration file:
cd <extraction_folder>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8
- Edit the workstation configuration file using a text editor such as nano:
nano <extraction_folder>/HandyBackupWorkstation8/etc/HandyBackup8/workstation.hbl
Update the following lines in the file to match your settings:
WorkstationHost=<workstation_IP_address>
Name=<workstation_display_name>
CoordinatorHost=<coordinator_IP_address>
CoordinatorPort=<coordinator_port>
- Save the changes and close the text editor.
- Restart the workstation to apply the new settings:
cd <extraction_folder>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8
- Create a backup copy of the configuration file in advance to preserve its current settings.
- Remove the previous version of HandyBackupWorkstation8:
rm -r <extraction_folder>/HandyBackupWorkstation8
- Repeat the installation and configuration process using the new version of Handy Backup.
- Replace the configuration file with the backup copy from step 1, or configure it again manually.
After installing and configuring the network agent, you can start working through the centralized control panel. For more information about creating backup and recovery tasks for Linux network agents, see the corresponding section.
If the agent encounters errors during operation, check the Handy Backup logs. Agent logs are stored in the /var/log/HandyBackup8 directory.