Installation on Linux & MacOS

Linux

Prerequisites Installation

Prerequisites

Prior to agent installation, check if your system is meets all the requirements.

System requirementsSupported platforms

---

Installation

1. Download the agent installer (bash script) to your Linux system and grant execute permission to the file owner (user or group) using the following chmod command:

To download the agent installer, login to Xopero ONE Management Service using a web browser, then go to Settings > Advanced > Workers and click Download agent button. The Download agent window will open — click the appropriate agent version to download it.

chmod +x xoperoclient.sh

1. Next, run the script using the following command:

./xoperoclient.sh or bash xoperoclient.sh

Running the script along with sudo command

The above script should be initiated using an account with administrative privileges — because of that it might be required to use the sudo command simultaneously (as in the above example).

1. Accept the END-USER LICENSE AGREEMENT to proceed.

1. Next, enter the IP address in the Address field (including the protocol and port) and click OK to finish the installation. Your address can be found in Xopero ONE Management Service — the system will display it once you start downloading the agent installer.

1. Now that Xopero ONE agent is installed, you can activate it in the Xopero ONE Management Service (XMS) web panel and start protecting your data.

MacOS

Installation Unattended installation Permissions configuration

Installation

1. Download Xopero ONE agent installation wizard via XMS and run it.

To download the agent installer, login to Xopero ONE Management Service using a web browser, then go to Settings > Advanced > Workers and click Download agent button. The Download agent window will open — click the appropriate agent version to download it.

1. Click Continue to proceed.

1. Select Continue in the Read Me section.

1. Read the END-USER LICENSE AGREEMENT and hit Continue to accept it.

1. Hit Agree to accept the terms of the software license agreement.

1. Change the installation directory if needed and click Install to begin the installation.

1. During the installation process, the creator will ask you for the address of your XMS— define it in this step.

1. Click OK to confirm your configuration.

2. The Xopero ONE agent has been successfully installed— you can close the installation wizard.

---

Unattended installation

If you don't want to use the installation wizard, you can choose the unattended installation option.

1. Download the xoperoclient.pkg file to your device.

To download the agent installer, login to Xopero ONE Management Service using a web browser, then go to Settings > Advanced > Workers and click Download agent button. The Download agent window will open — click the appropriate agent version to download it.

1. Run the following command in macOS terminal (Applications > Utilities > Terminal):

sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://XMS_adress::28555>" && sudo installer -pkg <pkg_file_location> -target /; sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"

‼️Command overview:

Setting the environment variable with your Xopero ONE Management Service IP address and default port

sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://<XMS_adress::28555>"

Launching the installer

sudo installer -pkg <pkg_file_location> -target /;

Removing environment variables

sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"

---

Permissions configuration

After installation, in a few steps you need to add the necessary permissions for the Xopero file.

1. Click on the Mac icon in the upper left corner and select System Preferences... from the drop-down menu.

1. Next, go to Security & Privacy.

1. Navigate to the Privacy tab, then select Full Disk Access from the menu on the left.

1. Add Xopero.Device.App.app to the list.

1. Grant access to Xopero.Device.App.app to finish the configuration.

To learn how to activate the agent in the Xopero management console, check the Useful links and items section.

Useful links and items

Agent configuration