All pages
Powered by GitBook
1 of 1

Loading...

Installation on Linux & MacOS

circle-1Prerequisites circle-2Installation

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:

  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.

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

  1. Click Continue to proceed.

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

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


    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.

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

    ‼️Command overview:


    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.

    ./xoperoclient.sh or bash xoperoclient.sh

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

    Installation

    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.

    Useful links and items

    circle-1Installation
    circle-2Unattended installation
    circle-3Permissions configuration
    Agent configuration
    Running the script along with sudo command
    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"
    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"

    Unattended installation

    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.

    Permissions configuration

    Granting permission for installer
    Running the installer
    Xopero ONE service URL example
    End-user agreement