Difference between revisions of "Agent"

From Veloopti Help
Jump to: navigation, search
m
m
Line 3: Line 3:
  
 
== Overview ==
 
== Overview ==
Agents are a software program that reside on a node that is being managed by Veloopti.
+
Agents are software that are installed as a service on an operating system that runs policies and actions and sends the results back to Veloopti. The Veloopti agent is written in the C++ programming language. We use the [https://pocoproject.org/ Poco] software library meaning we can write the agent once but compile it to run on many different Operating Systems<ref>The following are the supported Operating Systems of [https://github.com/pocoproject/poco/wiki/SupportedPlatforms poco]. Windows XP/Vista/7/8/10; Windows Embedded CE 6.0; Windows Embedded Compact 2013; Mac OS X 10.5-10.10; Linux; Solaris 9/10; FreeBSD 6.0; HP-UX 11.x; QNX 6.3-6.4</ref>. We have written it so there are very few external dependencies requirements. This is why the windows registry is not used in favor of file based configuration settings.
As agents are written in C++. We use the [https://pocoproject.org/ Poco] software library that means we can write the agent once and compile it to run on many different Operating Systems. In addition to this there are very few external dependencies requir  Because of this it means that many of the configuration setting are generic that will work on many different OS's. This is why the windows registry is not used in favor of file based configuration settings.
 
  
 
=== Downloading ===
 
=== Downloading ===
To download the software agent navigate to either the [https://ap1.veloopti.com.au/nodes nodes] page or the [https://ap1.veloopti.com.au/agents agents] page and click on the download agent icon [[file:agent_download.png|35px]].
+
To download the agent software navigate to the [https://ap2.veloopti.com.au/nodes nodes] page and click on the download agent icon [[file:agent_download.png|35px]].
  
 
=== Installing ===
 
=== Installing ===
Line 13: Line 12:
  
  
=== Configuration ===
+
=== Configuring ===
 +
The Veloopti agent is configured from the web GUI.
  
=== Security ===
 
The agent does not listen on a port on the server.  The agent creates an outbound only connection to the Veloopti Agent Controllers on port 443.
 
  
 +
=== Folders and files ===
 +
 +
There are 4 folders located where the Veloopti agent was installed.
 +
{| class="wikitable"
 +
! Directory
 +
! Description
 +
! Contents
 +
|-
 +
|\bin
 +
|Contains the program executables and any dynamically linked libraries (DLL's) that are required for the Operating System.
 +
|
 +
|-
 +
|\conf
 +
|Contains the configuration files
 +
|Note that the configuration files are encrypted and may not be manually edited. conf.json is the agent specific configuration file and shouldn't be copied to any other agent. The \certs sub-folder contains the SSL certificates that are used to encrypt the traffic between the Veloopti servers and the agent. The \policies sub-folder contains the current policies that are running on the server.
 +
|-
 +
|\log
 +
|Contains the log files
 +
|Logging levels can be changed on the Agent software page of the Node
 +
|-
 +
|\tmp
 +
|Contains temporary files
 +
|Temporary files include the results from policies and actions that are waiting to be sent to the Veloopti Agent Controllers.
 +
\agent - results from policies and actions that are waiting to be sent to the Veloopti Agent Controllers.
 +
 +
\chunks - stores partial files as the are being received from the Agent Controllers.
 +
 +
\files - stores complete files.
  
 +
\upgrade - stores the new agent version before it is upgraded
 +
|}
 +
  
 +
=== Security ===
 +
The agent does not listen to a port on the server.  The agent creates an outbound only connection to the Veloopti Agent Controllers on port 443.
  
 
=== Agent Tokens ===
 
=== Agent Tokens ===
 +
To be completed when tokens are implemented.
  
  
 +
== References ==
 +
<references />
  
 
[[Category:Concepts]] [[Category:Agents]]
 
[[Category:Concepts]] [[Category:Agents]]

Revision as of 22:56, 3 June 2019

Home > An Overview > Concepts > Agents


1 Overview

Agents are software that are installed as a service on an operating system that runs policies and actions and sends the results back to Veloopti. The Veloopti agent is written in the C++ programming language. We use the Poco software library meaning we can write the agent once but compile it to run on many different Operating Systems[1]. We have written it so there are very few external dependencies requirements. This is why the windows registry is not used in favor of file based configuration settings.

1.1 Downloading

To download the agent software navigate to the nodes page and click on the download agent icon Agent download.png.

1.2 Installing

1.3 Configuring

The Veloopti agent is configured from the web GUI.


1.4 Folders and files

There are 4 folders located where the Veloopti agent was installed.

Directory Description Contents
\bin Contains the program executables and any dynamically linked libraries (DLL's) that are required for the Operating System.
\conf Contains the configuration files Note that the configuration files are encrypted and may not be manually edited. conf.json is the agent specific configuration file and shouldn't be copied to any other agent. The \certs sub-folder contains the SSL certificates that are used to encrypt the traffic between the Veloopti servers and the agent. The \policies sub-folder contains the current policies that are running on the server.
\log Contains the log files Logging levels can be changed on the Agent software page of the Node
\tmp Contains temporary files Temporary files include the results from policies and actions that are waiting to be sent to the Veloopti Agent Controllers.

\agent - results from policies and actions that are waiting to be sent to the Veloopti Agent Controllers.

\chunks - stores partial files as the are being received from the Agent Controllers.

\files - stores complete files.

\upgrade - stores the new agent version before it is upgraded


1.5 Security

The agent does not listen to a port on the server. The agent creates an outbound only connection to the Veloopti Agent Controllers on port 443.

1.6 Agent Tokens

To be completed when tokens are implemented.


2 References

  1. The following are the supported Operating Systems of poco. Windows XP/Vista/7/8/10; Windows Embedded CE 6.0; Windows Embedded Compact 2013; Mac OS X 10.5-10.10; Linux; Solaris 9/10; FreeBSD 6.0; HP-UX 11.x; QNX 6.3-6.4