Foglight Agent Manager 5.9.2 - Foglight Agent Manager Guide

Excluding Specific SSL Protocols from Downstream Connections

If you need to exclude one or more protocols from the SSL protocol negotiation, you can do so using one or more excluded-ssl-protocol elements. Some common values are SSLv2Hello, SSLv3, TLSv1, TLSv1.1, TLSv1.2.

If none are specified, then SSLv2Hello and SSLv3 are disabled by default. Otherwise only those protocols listed will be excluded.

To exclude specific SSL protocols from a downstream connection:

Open the <fglam_home>/state/<state name>/config/fglam.config.xml file for editing.

Between the existing <http-downstreams> and </http-downstreams> tags, add an <https-downstream/> child element:

<https-downstream port="8443">
<excluded-ssl-protocol name="SSLv2Hello"/>
<excluded-ssl-protocol name="SSLv3"/>
<excluded-ssl-protocol name="TLSv1"/>
</http-downstream>

Save your changes.

Restart the Agent Manager.

Configuring the Agent Manager to accept connections from the Management Server

You can configure the Foglight® Agent Manager to accept connections from the Management Server and enable reverse data polling. This is useful in situations when the Agent Manager cannot connect to the Management Server due to its location. For example, when the Agent Manager is located in the cloud and the Management Server runs on premises, the Agent Manager has no means to connect to the Management Server and pass on the collected data. Another example is when the Agent Manager resides in a demilitarized zone (DMZ), exposed to untrusted networks, and the Management Server is behind a firewall.

To enable this feature, you must instruct the Agent Manager to accept connections from the Management Server in order to facilitate normal message passing and data polling.


	NOTE: Only the Management Server can reverse poll an Agent Manager instance. An Agent Manager instance cannot reverse poll another Agent Manager instance.

You do this by performing the following steps:

•

Configure downstream SSL connections using the configuration interface. You can do that either using the installer interface (see Step 8: Downstream Connection Configuration ), or the command-line interface (see Step 6: Downstream Connection Configuration ).

Or:

Configure downstream non-SSL connections, or connections requiring user-provided certificates or keystores. For instructions, see To configure non-SSL connections or connections using user-provided certificates or keystores:.

•

Using the fglam.config.xml file, disable upstream connections to the Management Server. For instructions, see To prevent the Agent Manager from connecting to the Management Server:.

•

On the Management Server, configure the FglAM Adapter, to instruct the Management Server to connect to this Agent Manager. For instructions, see To configure the Management Server to connect to the Agent Manager:.

To prevent the Agent Manager from connecting to the Management Server:

Open the fglam.config.xml file for editing. This file is located in the <fglam_home>/state/default/config directory.

In the fglam.config.xml file, locate the <config:http-upstreams> XML element, and within that element, declare a new <config:http-upstream> element using the following lines of code:

<config:http-upstream>

<no-connection/>

</config:http-upstream>

The no-connection element prevents the Agent Manager from connecting to the upstream Management Server.

Save your changes and restart the Agent Manager.

To configure non-SSL connections or connections using user-provided certificates or keystores:

Open the fglam.config.xml file for editing. This file is located in the <fglam_home>/state/default/config directory.

In the fglam.config.xml file, locate the <config:http-downstreams> XML element, and within that element, declare a new <config:http-downstream> sub-element for a non-SSL connection or <config:https-downstream> for an SSL connection.

Non-SSL connections only. Within the newly created <config:http-downstream> element, provide a port number that the Agent Manager will use to listen for incoming connections, and optionally the IP address of the network interface. For example:

<http-downstream port="9090" address="127.0.0.1"/>

User-provided certificates or keystores only. Within the newly created <config:https-downstream> element, provide the information about the certificate and keystore you want to use. There is a wide range of attributes that you can use. For complete instructions, review the <config:documentation> element under <config:http-downstreams>.

To configure the Management Server to connect to the Agent Manager:

On the Agent Properties dashboard, under Agent Type, select FglAM Adapter, and in the pane on the right, click Edit.

In the Agent Type Properties dialog box that appears, under Hosts to Pull Data From, click Edit.

In the Edit List of Hosts to Pull Data From dialog box that appears, click Add.

The table refreshes, showing a newly added row.

Specify the connection information to the Agent Manager that you want to Management Server to connect to by populating any of the following columns, as required.

•

Enabled: Select this check box if you want the Management Server to connect to this Agent Manager.

•

URL: Type the URL the Agent Manager uses to communicate with the Management Server.

•

Local Address: To specify a local network address for the Management Server connection to the Agent Manager, type the IP address of a NIC (network interface card) on the machine hosting the Agent Manager required to establish connections to the Management Server.

•

Proxy URL: If you want the Agent Manager to connect to the Management Server using a proxy, type the URL of the proxy server.

•

Proxy NTLM Domain: If you are using a proxy server for communication, and the proxy uses Windows authentication, type the Windows domain.

•

Proxy User Name: If you are using a proxy server for communication, type the user name needed to access the proxy server.

•

Proxy Password: If you are using a proxy server for communication, type the password associated with the user name.

•

Allow Self Signed SSL Certificates: Select this check box if you want to enable the Agent Manager to accept self-signed certificates from the Management Server.

•

SSL Certificate Common Name: If you want to enable the Agent Manager to accept self-signed certificates from the Management Server, and the certificate has a different common (host) name than the one reported by the Management Server, type the certificate common name.

•

Compressed Connection: Select this check box if you want the Agent Manager to establish HTTP-compressed communication with the Management Server.

•

Chunked HTTP Connection: Select this check box if you want to use an HTTP connection with chunked transfer encoding enabled.

Configuring the Agent Manager to execute commands on remote hosts

ExecuteCommandOnRemoteHostsAction is an action that is used for the Agent Manager to execute a command on remote hosts.

To configure this action for the Agent Manager:


	NOTE: Both Adapter and the Agent Manager must be upgraded to version 5.9.2 or later before the following procedure.

Add the ExecuteCommandOnRemoteHostsAction action to your rule list. For more information about how to add or edit an action in a rule, refer to the Getting Started: create a new rule or Getting Started: view and edit rule definitions section in the Foglight Administration and Configuration Help.

Specify the following parameters for the action as needed, then save your changes:

•

AgentManagerName (Mandatory): The Agent Manager name that is delegated to invoke the command on remote hosts.

•

CommandLine (Mandatory): The command to be executed remotely.

•

RemoteHosts (Mandatory): Target host addresses and platforms map, for example, hostName=Windows!hostIP=Linux. The platform value can be either of the following: Windows, Linux, Solaris, AIX, and HP-UX.

•

AgentManagerNameUseRegExp (Optional): The flag indicating whether the AgentManagerName parameter should be treated as regular expressions. This value is either true or false.

•

MatchAll (Optional): The flag indicating whether to run the command on all Agent Managers that matches the selection criteria. If set to false, the command will be executed only on the first matching Agent Manager.

•

Port (Optional): SSH connection port, default is 22. Windows platform does not need to configure this value.

•

Timeout (Optional): Command executing timeout value. Default is 0, which will use the Agent Manager default timeout value.

Go to the Dashboards > Administration > Credentials > Manage Credentials dashboard, add credentials for those remote hosts. The credentials usage must set to either “Execute Command On Remote Hosts For Windows” or “Execute Command On Remote Hosts For Unix”.

After saving your configurations and the rule is triggered, you will see the executed results on the server console or logs.

Configuring multiple Agent Manager instances

The files related to the Agent Manager’s run-time state (for example, configuration and log files), are saved in the <fglam_home>/state/ directory tree. Under the state directory, there is a sub-directory for each available Agent Manager instance.

You can run multiple instances of the Agent Manager using a single Agent Manager bin directory.


	CAUTION: Running multiple instances of the Agent Manager on the same host is intended for cluster and failover support only and is not intended to be used for any other purposes. Installing separate instances of the Agent Manager on the same system is therefore neither recommended nor supported.

In this type of configuration, you create multiple instances and each instance uses a different state directory but runs from a single Agent Manager bin directory. One example of this type of configuration is to test new agent settings without making changes to the agents you are currently using to monitor your production environment.


	CAUTION: In a configuration where multiple Agent Manager instances share one bin directory, each time you deploy agents, upgrade agents, or deploy Agent Manager upgrades to one instance, all other instances are also updated.

You can also configure multiple physical installations of the Agent Manager to use a corresponding state directory that exists on a single shared drive. One example use of this functionality is running the Agent Manager in cluster environments. See Example: Running multiple instances in a cluster environment for more information.

As described below, you create a new instance (and its associated state sub-directory) by including the --create-state and --location "<state_name>" (or -l "<state_name>") options with the fglam command; you then use the fglam ‑‑location "<state_name>" command to run that new instance.


	CAUTION: The --create-state and --location command-line options are not recommended for use with the embedded Agent Manager, because the embedded Agent Manager does not include its own JRE. Instead, it is configured by the Management Server to use the same JRE that the Management Server uses.Since the Management Server is not aware of additional state directories that you may have created, it cannot properly configure them. Instead, you need to manually configure and maintain the JVM location in the Management Server installation.

If you do not create multiple instances (by following the instructions below), the Agent Manager creates an instance called default and stores the state files in the state/default directory.