The workstation agent is distributed as a portable version in the form of an archive containing all required files. Before installation, download the archive:
Download tar.gz Archive
- Ubuntu 22.04;
- x86-64 processor architecture;
- The following package must be installed:
Install the package with: sudo apt install librsync2
Additional Requirements for Database Support
For MySQL 8.0
The following packages must be installed:
- libmysqlclient21
- mysql-client-core-8.0
Install the packages with: sudo apt install mysql-client-core-8.0 libmysqlclient21
For PostgreSQL
The following packages must be installed:
Install the packages with: sudo apt install libpq5 postgresql-client
- 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 machine 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, start the workstation located at 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
Specify the connection settings in the following lines:
- WorkstationHost – IP address of the computer where the workstation is running;
- Name – workstation name as displayed when connecting to the coordinator;
- CoordinatorHost – 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 located at the following path:
"archive extraction folder"/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 created in 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 files.
- Start 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 according to 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.