Geneos File Agent - User Guide

Introduction Copied

The Geneos File Agent is a lightweight data collection process which runs on an application server, and forwards log data onwards to a separate process for monitoring. This separation is intended to minimise the impact on the application server machine, so as to avoid impacting performance of the monitored process.

File Agent architecture

At present a single File Agent process can serve data to a single data consuming process at a time. Supported data consumers at this time include:

For a resilient configuration, multiple consumers can be configured to connect to the same agent so that failure of the connected consumer will cause a failover to the waiting consumer.

This guide is concerned with installing and running the File Agent. Instructions on configuration of the File Agent can be found in the reference guide for the consumer process (e.g. the Fix Analyser 2 reference guide). This is because the File Agent literally acts as an agent: names, locations and matching rules of the files to be read are all configured in the consumer and the agent merely acts upon this instruction.

Installing File Agent Copied

List of Supported Platforms Copied

For the list of supported platforms, see the Compatibility Matrix.

Downloading and Installing (Linux) Copied

The File Agent is available as a tar.gz archive. To install the agent on Linux, unpack the tar.gz file with the following commands:

gunzip <archive>.tar.gz
tar -xvf <archive>.tar

Once unpacked the tar file is no longer needed and can be removed.

If this is a new installation of the agent, simply place the unpacked files in the directory from which the agent is to be launched.

If upgrading from an earlier version then stop the agent, replace all of the files with those from the new version, and then restart the agent. To remove the agent, remove all file contents of the directory where the tar.gz archive was unpacked.

When Security-Enhanced Linux (SELinux) is running in Enforcing mode, it may deny certain functions of Geneos depending on the implemented configurations and policies.

To see which functions SELinux denies, check the audit log. The log is typically located in /var/log/audit.log, where the log type entry is AVC. The audit log provides the details of any denied access. For example, denied connection to the TCP port. If you experience issues related to this mode, you may opt to disable SELinux, or create policy modules to grant the required access. Please contact your administrator or security team for assistance.

Downloading and Installing (Windows) Copied

The File Agent is optionally available for Windows as an installer binary. When run the File Agent will be installed as a service. The default name for the service is GeneosFileAgent_64 and the default port is 7030. These defaults can be changed when you run the installer.

If you do not want the agent to start automatically as a service whenever Windows is started, open the Services control panel, find and double-click the row for Geneos File Agent and change the startup type to Manual in the Properties dialog.

To uninstall the agent, use the Windows “Add or remove programs” feature. Log files will not be deleted when the uninstaller is run; this is intentional, but means that if you want to remove the directory into which you installed the agent, you may need to do so manually.

Running File Agent Copied

On Windows, the File Agent can be run either by starting the agent service or by executing the agent.windows_64.exe binary from the command line. On Linux, the agent is run by executing the agent.linux_64 binary from the command line.

Running from the command line Copied

Linux

./agent.linux_64
./agent.linux_64 -port 18008

See below for information about the available command line options.

Windows

>agent.windows_64.exe
>agent.windows_64.exe -port 18008

See below for information about the available command line options.

If you intend to run the agent from the Windows command line, ensure that it is not set to run automatically as a service. (See section Downloading and Installing (Windows) above)

Command line options

File Agent accepts the following command line options:

Option Description
-cmd Provided for consistency with the Geneos Netprobe on Windows. Indicates that the program should be run as a command and not as a service. As this is the default behaviour for File Agent, manually specifying this option is not required.
-help Prints the File Agent usage message. Can be abbreviated to -h.
-log The name of a file to which the File Agent should write its log output (see below). This option overrides the LOG_FILENAME environment variable, if this is set. See Log file below.
-minTLSversion Specifies the minimum TLS version. The accepted values are the following:
  • 1
  • 1.0
  • 1.1
  • 1.2
  • 1.3
-nolog Send log output to standard output. This option overrides the LOG_FILENAME environment variable, if this is set.
-openssl-cipher To set the available TLS ciphers use the -openssl-cipher command line option, replacing with a comma separated list of ciphers. For more information, see TLS ciphers in Secure Communication.
Example:
-openssl-cipher
-port The port on which the File Agent listens for Netprobe connections. This option overrides the PORT environment variable, if this is set. See Listen port below.
-secure If this option is present, the File Agent will listen on a secure port rather than an insecure port. If -secure is specified, then an SSL server certificate and a server private key also need to be specified.
-ssl-certificate This is the file that contains the signed SSL server certificate in PEM format.
-ssl-certificate-key This is the file that contains the signed SSL server private key in PEM format. If this is option not specified, but the certificate is, then the File Agent will look for the private key in the same file as the server certificate.
-ssl-certificate-chain This is the file that contains the trusted certificate authority.
-require-ssl-certificate-for This specifies that secure connections to the agent using protocol must include a certificate. In order for the connection to succeed, the provided certificate must be verified by the agent.
Note: Currently, the protocol can only be set to emf2 which covers the incoming connections from Geneos components.
-run, -install, -remove, -uninstall These options are used when the File Agent is run, installed or uninstalled as a Windows service. They should not be used when running the program from the command line.
-version Prints File Agent version information. Can be abbreviated to -v.

These options are used when the File Agent is run, installed or uninstalled as a Windows service. They should not be used when running the program from the command line.

Listen port Copied

By default the File Agent listens for connections by consumer processes on TCP port 7030. This value can be overridden by:

Log file Copied

The File Agent produces log output during normal operation ,with timestamps for each entry written in the ISO-8601 format by default. If the agent is run from the command line, messages will be directed to standard output. If the agent is run as a Windows service, the log file will be written to “file-agent.log” in the agent installation directory, unless a different path was specified during installation.

The default log file behaviour can be overridden by:

For more information on environment variables, see Netprobe variables.

Running as a Windows Service Copied

You can start and stop the File Agent service using the Services control panel. You should ensure that the “Startup Type” column in the Services control panel shows Automatic if you want the agent service to run every time Windows is rebooted.

["Geneos"] ["Geneos > Netprobe"] ["User Guide"]

Was this topic helpful?