Installing and Configuring Network Agents for Linux

Special Offer: Purchase Handy Backup with a discount up to 30%!

The workstation is available as a portable version in the form of a data archive. Prior to installation, please download the archive from the following link: dl.handybackup.net/handybackup-linux-workstation.zip.


System Requirements:


Basic Requirements:

Installation and Configuration of the Network Agent

  1. Retrieve the data from the archive.
  2. To generate the configuration file, launch the workstation by navigating to the following location:

<extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

  1. 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.
  1. 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

  1. Create a backup of the configuration file in advance to preserve its current settings.
  2. Delete the HandyBackupWorkstation8 folder.
  3. Repeat the workstation installation process using the new archive.
  4. Replace the configuration file with the backup from step 1 or reconfigure it from scratch.

Installation and Configuration of the Network Agent via Terminal

  1. 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.

  1. Generate the configuration file by launching the workstation:

cd <extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

  1. 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>

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

cd <extraction_location>/HandyBackupWorkstation8/bin/HandyBackupWorkstation8

Updating or Reinstalling the Network Agent via Terminal

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

rm -r <extraction_location>/HandyBackupWorkstation8

  1. Reinstall and configure the workstation using the new HandyBackup version.
  2. 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

  1. 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.

  1. On step 2, choose the connection to the Linux network agent (workstation):
Installation: Linux connection
  1. Select the files for backup (currently, only the “Computer” plugin is available for Linux workstations):
Installation: Computer plugin
  1. On step 3, choose the location where backups will be created.
  2. On the next step, select compression and encryption options.
  3. On step 5, set the task schedule.
  4. 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

  1. On the first step, select the 'Restore' task type.
  2. On the second step, specify the location of the '.hbi' file for the recovery task:
Installation: Computer plugin
  1. On the next step, choose the files for recovery:
Installation: Files for recovery
  1. On step 4, select the recovery type.
  2. On the final step, provide a name for the backup task and click 'Done'.


Related pages: Network Agent Troubleshooting, Server Backup Solution



User Manual contents

Who uses Handy Backup?