- Created by Martin Moghadam, last modified by YĆ¼ksel Aydemir (Unlicensed) on Nov 22, 2019
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 3 Next »
You can only do this if you're a PerformanceGuard administrator.
The PerformanceGuard Frontend server handles the communication with PerformanceGuard agents, stores data from agents, and communicates with the PerformanceGuard Backend server to synchronize agent IDs and aggregate performance data. You can use multiple Frontend servers in your PerformanceGuard solution if required.
When you install a Frontend server, it will automatically register itself with the Backend server and receive a unique ID.
PerformanceGuard agents will automatically receive a Frontend server list as a part of their configuration. You can create a list of Frontend servers for a specific location. This can be useful if you want all the PerformanceGuard agents installed on the computers at a location to use one or more specific Frontend servers.
List of Frontend Servers
The Frontend servers list (ADMINISTRATION > Setup > Frontends) shows all registered Frontend servers with the following information:
- Status
- ID
- Frontend Server: Name of the Frontend server. By default the hostname of the Frontend server is used.
- Agent Delivery Address: The IP address or hostname and TCP port number that agents should use when communicating with the Frontend server.
This is useful if you want agents to use a DNS alias, or if the server is situated behind a firewall (in which case you need to specify the address of the firewall).
- Version: The Frontend server's version of PerformanceGuard.
- Enabled: Whether the Frontend server is enabled (it is possible to disable a Frontend server when you edit its properties).
You typically only disable a Frontend server if you need to perform maintenance on it. However, if you use multiple, prioritized Frontend servers (see the following), disabling a Frontend server can be a way of actively forcing agents to connect to a different Frontend server.
- Priority: The priority of the Frontend server. Agents use the priority when they decide which Frontend server to connect to (see the following).
- Agents (Online): The number of agents that use the Frontend server, and how many of those agents that are currently online.
Agent-Frontend Server Connection Priorities
An agent will only use one Frontend server at a time.
Agents will automatically receive a Frontend server list as a part of their configuration. By default agents will get a list of all enabled Frontend servers. If some agents belong to a location for which a specific Frontend server list has been defined (see the following), they will get a separate list of Frontend servers.
If your organization uses multiple Frontend servers, agents will connect to the Frontend servers in the following order:
- Any primary Frontend server in the list
- Any secondary Frontend server in the list
- Any failover Frontend servers in the list
- The Frontend server that was defined for an agent when the agent was installed
If there are more than one Frontend server with the same priority - Agents will pick one randomly from them.
Once an agent has successfully connected to a Frontend server, it will stay with that Frontend server for the lifetime of Agent. However, if the agent has connected to a Frontend server that has a lower priority than another Frontend server on the list, the agent will try to connect to the Frontend server that has a higher priority at regular intervals to see if the higher-priority Frontend server has become available.
In order for Agent to make the random selection, you need to delete a registry value named RandomSeed. Open regedit and delete the value under the key Computer\HKEY_LOCAL_MACHINE\SOFTWARE\PremiTech\E2EAgent. You need to stop "Agent Service" before making any changes in regedit.
Agents will receive an updated Frontend server list if there are any changes to the list, that is if Frontend servers are added or removed, enabled or disabled, or if their priorities have changed.
It takes some time before Frontend server changes are communicated to agents. See Changes Take 30 Minutes or More in the following.
Prioritization Isn't Load Balancing
Bear in mind that prioritization of Frontend servers does not in itself offer any load balancing. PerformanceGuard agents will simply follow the Frontend server list and Frontend server priorities they get as part of their configuration. The agents have no way of determining the load on specific Frontend servers, so they are not able to switch Frontend servers in order to distribute the load across servers.
Any such load balancing must be set up separately outside of PerformanceGuard.
You can achieve Semi Load Balancing by ensuring that:
- All Frontend servers, you need to balance between shall have the same priority.
- All Frontend servers shall be up and running at the time of connection.
- No Agents may ever have been connected to Frontend servers. If they have, then you must remove the RandomSeed.
DNS Alias Tip
Because of the way that agents connect to Frontend servers in an multiple Frontend server environment, the following can be a good way of installing PerformanceGuard agents and Frontend servers:
- Create a DNS alias like performance.yourcompany.com and make sure that it points to one of your Frontend servers at all times.
- Install the agents using this DNS alias as the configured Frontend server.
- The agents will connect to the Frontend server behind the DNS alias. From that Frontend server they will receive the correct Frontend server list.
This way agents will never be lost, because agents will always try to connect to the Frontend server that was defined during installation as their last resort. Because you control which server that is through your DNS administration, you can make sure that agents are always able to connect to a running Frontend server.
Create Specific Location-Frontend Server Mapping
If required, you can create a specific list of Frontend servers and priorities that agents at a specific location should use. This can be sometimes be useful for network infrastructure reasons.
Example: When it comes to geography as well as bandwidth, your organization's office in China is closer to Frontend server C than to Frontend servers A and B, so you specify that agents at the China location must use Frontend server C as their primary Frontend server and Frontend servers A and B as their secondary options. Read more about Frontend server priorities in the previous.
If you want to set up a location-frontend server mapping, select ADMINISTRATION > Setup > Frontends and then select the Locations tab.
See also Set Up Locations.
Changes Take 30 Minutes or More
If you change your Frontend server configuration, for example by adding a Frontend server, by changing location-frontend server mappings or by changing priorities, you should be aware that it takes 10 agent delivery intervals before you can be sure that your changes have been communicated to all online agents. With a default agent delivery of three minutes, that's at least half an hour.
The reason for this is that communication of Frontend server changes takes up considerable agent resources. That's why PerformanceGuard does not let Frontend servers communicate this type of configuration changes to agents more often than every 10th agent delivery interval.
Frontend Server Disk Space Check
The PerformanceGuard frontend server automatically checks if there is enough disk space on the computer that runs the frontend server.
The frontend server will automatically stop accepting data from PerformanceGuard agents if there is less than 3 GB free disk space on the frontend server, and it will automatically resume accepting data from agents once there is more than 6 GB free disk space.
Technically, when the frontend server stops accepting data from agents, the PerformanceGuard Frontend Server service itself does not stop, but it stops listening on the agent/frontend server communication port (by default that is port 4001).
If the frontend server stops accepting data from agents because of limited disk space, it is important that you free up sufficient disk space on the computer that runs the frontend server. When you have freed up sufficient disk space, the frontend server will automatically resume accepting data from agents.
How Will I Know if a Frontend Server Stops to Accept Agent Data?
There are several indications:
You can only do this if you're a PerformanceGuard administrator.
Frontend Server Log
PerformanceGuard administrators can see it in the frontend server log file, available in the Status section
of the PerformanceGuard web interface or directly under [PerformanceGuard installation folder]\collector\logs.
- When the frontend server stops accepting data from agents, the following is logged:
Not enough disk space. Stopped serving agents. [Disk space information]
Stopping the collector server.
What's ReportFileStore and spooler? They are frontend server folders under [PerformanceGuard installation folder]\collector\. Sufficient disk space is especially critical for those folders, and that's why the log message may mention them as part of its disk space information. Still, the main thing you need to do is to free up disk space on the computer than runs the frontend server.
- When the frontend server resumes accepting data from agents, the following is logged:
Enough disk space has become available to resume serving agents. [Disk space information]
Creating a server socket.
Server is running. [Agent/frontend server communication port information]
System Status Will Report FAILURE
PerformanceGuard administrators can see it in the PerformanceGuard web interface: When the frontend server stops accepting data from agents, the Agents Online status on the System Status tab (ADMINISTRATION > Status > System Status) will change to FAILURE.
If your organization uses multiple frontend servers, agents will automatically connect to another frontend server. When that's the case, the Agents Online status will remain OK. In that case, select the neighboring Frontend Servers tab. Because the PerformanceGuard Frontend Server service has technically not stopped on the affected frontend server, it will still appear with an Online status. However, you'll be able to recognize the affected frontend server, because it will have an Online Agents count of 0.
Use Server Surveillance Tool to Get Automatic Notifications
PerformanceGuard has a separate downloadable tool for monitoring the status of the PerformanceGuard system and alerting you by e-mail if something is wrong. The tool can thus automatically notify you if a frontend server stops accepting data from agents. This requires that you download, configure and run the tool. Read more in .
The tool can even write PerformanceGuard status messages in Windows' event log.
The tool won't notify you of this problem if your organization uses multiple frontend servers. In an environment with multiple frontend servers, agents will automatically connect to another frontend server if their preferred frontend server stops accepting data. When that's the case, the status of your PerformanceGuard system will remain OK, and that's why the tool won't notify you.
Can I Configure the Limits?
Yes. If the default 3/6 GB limits don't suit your organization, you can configure your own limits:
Open [PerformanceGuard installation folder]\collector\conf\config.properties
- Edit the values of the parameters minimum-disk-space-stopping-point-mb and minimum-disk-space-starting-point-mb as required.
Note that you must specify the values in MB (so if you want a value to be 3 GB, you should specify 3000).
- Save the config.properties file.
- Restart the PerformanceGuard Frontend Server service.
Repeat as required if your organization uses multiple frontend servers.
Search this documentation
On this page
In this section
- No labels