Agent installation

From Veloopti Help
Jump to: navigation, search

Home > Administration > Agents > Agent installation

1 Overview

The Veloopti agent runs on a variety of Operating Systems. It can be downloaded from the node page by clicking on the Agent download.png icon with the Global options icons. Select the OS type and download the agent. Click on the X in the top right hand side to close the download dialogue box.

Agent download dialogue.png

1.1 Disk space required

The Veloopti agent requires 36 Megabytes of hard disk space. This may increase depending upon the number of policies that the agent is running. Up to an additional 80 Megabytes of disk space could be required when the Veloopti agent is being upgraded.

2 Windows installation

Run the veloopti-setup.exe executable to begin the installation process. You may be prompted to provide an Administrator user account at at this point. You are presented with the following dialogue box.

Agent installation windows setup.png
Warning.png             Note:You may be presented with a dialogue box saying "Windows Defender SmartScreen prevented an unrecognised app from starting". Running this app might put your PC at risk." Click on "Run anyway" to proceed.

2.1 Selecting an installation folder

Veloopti can be installed into any folder on your computer. We recommend that it is installed into the "%systemdrive%\Program Files\" or "%systemdrive%\Program Files (x86)\" folder, depending whether it is a 32 or 64 bit agent. The installation program will automatically select the correct program files folder. Click on the options button to select a folder to install it to somewhere other than the default.

Agent installation windows change directory.PNG

CLick on the Install button to proceed.

Warning.png             Note:We recommend that the Veloopti agent is not installed into a directory that contains the following characters: , ^ = ; & %. This may cause actions to experience intermittent software issues as windows doesn't always perform well with folders that have these characters in their name.

2.2 Authenticating the agent

After the agent executables are installed it must be configured to be added into a Veloopti organisation. You will need to have permission to do this through roles. You are prompted to enter the following details.

  1. Your Veloopti email address;
  2. Your Veloopti password;
  3. If you are a member of multiple organisations you are prompted to select the one you would like this computer to be added to.

Click on the close button to finish the agent installation process

Agent installation finished sucessfully.png

3 Linux installation

4 Registering and re-registering the Veloopti agent

If an agent is installed but not added to an Veloopti Organisation then it will need to be registered.

Complete the following to register the agent

  1. Run veloopti.exe /register (win) or veloopti --register (Linix)
  2. Type your username when prompted
  3. Type your password when prompted
  4. If you are a member of multiple organisations, select the organisation that this server should be in
  5. Run veloopti.exe /check (win) or veloopti --check (Linix) to confirm that the Veloopti installation completed successfully

4.1 Agent installation token