Overview

This article shows how to install the ACSIA Agent on Windows and Linux machines.

Requirements

Before installing the agent on your machine, make sure your machines match the needed requirements.

WINDOWS Installation:

Step 1:

Download the installer from the link provided by the Support Team and launch it as an administrator.

Step 2:

Follow the wizard, leaving the folder as the proposed default one.

Step 3:

Insert:

• The backend IP you received from the Support Team.
• The API KEY you received from the Support Team.

If installation fails:

If the ACSIA SOS agent installation from the GUI fails and returns an error, it may be due to the restrictive policies of Windows 10/11. In such cases, you need to run the .msi installer as an administrator.

Follow these steps:

1. Enable the "Install as Administrator" Option for .msi Files:

1. Open Command Prompt as an administrator:

   • Press Win + S, type "Command Prompt," then right-click on it and select Run as Administrator.

2. In the Command Prompt, enter the following commands one by one:

   reg add HKEY_CLASSES_ROOT\Msi.Package\shell\runas /ve /d "Install &As Administrator..." /f
   reg add HKEY_CLASSES_ROOT\Msi.Package\shell\runas\command /ve /d "msiexec /i \"%1\"" /f
   

3. After running these commands, the "Install as Administrator" option will appear in the right-click menu for .msi files.

2. Install the ACSIA SOS Agent as Administrator:

1. Locate the ACSIA SOS .msi file on your system.
2. Right-click on the .msi file and select Install as Administrator.
3. Follow the on-screen instructions to complete the installation.

By performing the installation with administrative privileges, you should avoid any errors caused by restrictive policies. If you continue to experience issues, ensure that your user account has sufficient permissions or consult your system administrator.

Linux Installation:

Debian installation

Step 1: get root permissions and export API key and registration address

Get root permissions: 

$ sudo -i

Export the API KEY and the registration address you received from the Support Team:

$ export FSEC_APIKEY="xxxxx"

$ export FSEC_REGISTRATIONADDRESS="yyyyy"

Step 2: install the gpg-key

$ curl -s https://prod-repo.s3.amazonaws.com/keys/xdrplus.gpg -o /usr/share/keyrings/xdrplus.gpg && chmod 644 /usr/share/keyrings/xdrplus.gpg

Step 3: add the repository

$ echo "deb [signed-by=/usr/share/keyrings/xdrplus.gpg] https://prod-repo.s3.amazonaws.com/debian/ stable main" | tee -a /etc/apt/sources.list.d/xdrplus.list

Step 4: install the agent

$ apt-get update && apt-get install xdrplus-agent=x.x.x -y

where x.x.x refers to the latest version of the agent. For example, if this is 6.5.0, the code above becomes:

$ apt-get update && apt-get install xdrplus-agent=6.5.0 -y

Step 5: disable the repository

$ sed -i "s/^deb/#deb/" /etc/apt/sources.list.d/xdrplus.list

Yum installation

Step 1: get root permissions and export API key and registration address

Get root permissions: 

$ sudo -i

Export the API KEY and the registration address you received from the Support Team:

$ export FSEC_APIKEY="xxxxx"

$ export FSEC_REGISTRATIONADDRESS="yyyyy"

Step 2: add the repository

$ cat > /etc/yum.repos.d/xdr.repo << EOF
[xdrplus]
name=xdrplus
baseurl=https://prod-repo.s3.amazonaws.com/yum/
gpgkey=https://prod-repo.s3.amazonaws.com/keys/xdrplus-public.asc
enabled=1
gpgcheck=1
repo_gpgcheck=1
EOF

Step 3: install the agent:

$ yum install xdrplus-agent-vx.x.x -y

where x.x.x refers to the latest version of the agent. For example, if this is 6.5.0, the code above becomes:

$ yum install xdrplus-agent-v6.5.0 -y