Foglight 5.9.4 - Federation Field Guide

Planning for federation

CAUTION: Before setting a more rapid refresh rate, it is prudent to consider the volume of alarms and potential performance impact of frequent alarm queries on the Federated Children.

NOTE: Federation is an advanced feature, which requires a dedicated Management Server. Contact Quest PSO to design and implement a federation strategy.

When planning to deploy the federation feature, customers must respect the following practical considerations:

Communication ports

To ensure that the federation setup works correctly, the Federation Master must open a certain set of connections to each Federated Child. When a firewall exists between the Federation Master and the Federated Children, the TCP 4444 port must be opened on the Federation Children.

Federation connections are always established in the Federation Master to Federated Child direction. Once a connection is established, data transfer is bidirectional.

The Federation Master uses the RMI 1099 port during the connection setup process. In the server.config file of each Federated Child, specify the server.federation.port property to identify this port number.

IMPORTANT: Starting in version 5.9.2, Foglight® for Java EE Technologies no longer supports Nexus Federation. Without Federation, all application servers that could possibly participate in servicing the same request (through RMI or other remote calls) should be connected to the same Nexus.

HA considerations

High Availability (HA) mode enables you to install multiple servers, where one server is the primary server and the others are standby servers. If the primary server stops responding, then the responsibility is taken over by one of the standby servers.

Only the Federated Children can be run in High Availability mode. Running a Federation Master in HA mode is currently not supported.

In a federated environment with two or more Federated Children working in HA mode, the Management Server automatically chooses the primary Federated Child for data synchronization.

Configuring a federated environment

The Federation Master is a Foglight® Management Server that has been configured to incorporate the data of federated instances. A Federation Master can not be utilized as any other Management Server (for example, no connected clients, agents, standard rule analysis).

When installing a Management Server, federation is by default disabled. When you install a Management Server, the server does not know if it is going to operate as a Federation Master or as a normal server. The server identifies this only on startup, by checking the server.federation variable in the server.config file. If this variable is set to TRUE, the server makes a number of changes that are necessary for it to run efficiently (given a certain load).

A Federation Master must always be started with server.federation variable set to TRUE. If a Federation Master starts up, even just one time, as a normal server, it makes modifications to the server that deplete its performance as Federation Master.

CAUTION: If you accidentally start the server with this variable set to FALSE, you must then either restore from a backup (if you have one), or completely re-install the Federation Master and database.

When upgrading a Federation Master, you must first verify that the server.federation variable was not changed to FALSE before you restart the server.

IMPORTANT: Starting in version 5.9.2, the Cartridge for Java EE Technologies no longer supports Nexus Federation. Without Federation, all application servers that could possibly participate in servicing the same request (through RMI or other remote calls) should be connected to the same Nexus.