Backup Software > Support > User Manual Version 8 > Installation > Installing and Configuring Network Agents for Linux > RED OS

Installation and Configuration for RED OS

The workstation is distributed as a portable version in the form of an archive with data, before installation it is necessary to download the archive from the link: dl.handybackup.net/handybackup-red-oc-workstation.zip

System Requirements:

Minimum version of RED OS 7.3;
64-bit processor with x86-64 architecture;
Availability of the following package:

zlib
librsync

Installing the package: dnf install -y zlib librsync

Additional requirements for working with PostgreSQL:

Availability of the following package

libpq
postgresql14

Installing the package: dnf install -y libpq postgresql14

Basic Requirements:

To use the workstation (network agent), you need the server version of Handy Backup.
The Handy Backup Server Network control panel, installed on a machine with the Windows OS.
Handy Backup Server Network solution is required for using the workstation.
The server and coordinator computers must be configured to accept incoming network connections from the workstation.
The workstation computer must be configured to accept connections from the server computer.
Machines must be on the same local network.

Installation and Configuration of the Network Agent

Retrieve the data from the archive.

* Note: Make sure that the unpacking path of the archive contains only Latin characters to avoid display issues in the interface.

To generate the configuration file, launch the workstation by navigating to the following location:

<extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

To edit the configuration file of the workstation, navigate to:

<extraction_location>/HandyBackupWorkstation8/var/HandyBackup8/Settings/workstation.hbl

and input the connection details into the following lines:

WorkstationHost - the IP address of the computer where the workstation is running.
Name - the display name of the workstation when connecting to the coordinator.
CoordinatorHost - the IP address of the computer where the coordinator is located.
CoordinatorPort - if the coordinator's port hasn't been changed, leave the default value.

To apply the new configuration file settings, restart the workstation located at the following path:

<extraction_location>/HandyBackupWorkstation8/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

Updating or Reinstalling the Network Agent

Create a backup 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 from step 1 or reconfigure it from scratch.

Installation and Configuration of the Network Agent via Terminal

Download the data archive and unzip it:

tar -C <extraction_location> -xzf <path_to_archive>

Replace <path_to_archive> with the path to your downloaded archive and <extraction_location> with your desired location for unpacking the workstation.

Generate the configuration file by launching the workstation:

cd <extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

Edit the workstation's configuration file using a text editor like nano:

<extraction_location>/HandyBackupWorkstation8/var/HandyBackup8/Settings/workstation.hbl

Adjust the following lines in the file to match your settings:

WorkstationHost=<station_IP_address>

Name=<displayed_station_name>

CoordinatorHost=<coordinator_IP_address>

CoordinatorPort=<coordinator_port>

Save your changes and exit the text editor.
To apply the new settings, restart the workstation:

cd <extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

Updating or Reinstalling the Network Agent via Terminal

Create a backup copy of the configuration file in advance to preserve its current settings.
Delete the previous HandyBackupWorkstation8 version:

rm -r <extraction_location>/HandyBackupWorkstation8

Reinstall and configure the workstation using the new HandyBackup version.
Finally, replace the configuration file with the backup created in step 1, or reconfigure it according to your preferences.

Creating a Backup Task for the Linux Network Agent from the Windows Central Panel

Select the “Create Backup” task type* and click 'Next'.

* Note: In this example, a task is created in Simple Mode. If you require more advanced program features, such as choosing the backup type, configuring pre/post-task execution, and so on, you should check the “Advanced Mode” option.

On step 2, choose the connection to the Linux network agent (workstation):

Select the files for backup (currently, only the “Computer” plugin is available for Linux workstations):

On step 3, choose the location where backups will be created.
On the next step, select compression and encryption options.
On step 5, set the task schedule.
On the final step, provide a task name and click 'Done'.

Setting Up a Data Restoration Task for the Linux Network Agent from the Windows Central Panel

On the first step, select the 'Restore' task type.
On the second step, specify the location of the '.hbi' file for the recovery task:

On the next step, choose the files for recovery:

On step 4, select the recovery type.
On the final step, provide a name for the backup task and click 'Done'.

User Manual contents