Download PDF
Download page Synthetic Server Requirements.
Synthetic Server Requirements
This page lists the Synthetic Server requirements, offers sizing guidance, and shows you how to modify the default settings.
AppDynamics Platform Requirements
To deploy the Synthetic Server, you need to install the following AppDynamics platforms:
- Controller
- Events Service
- Synthetic Agent
- Private Synthetic Agent
- Hosted Synthetic Agent
Certain Synthetic Server features—specifically, Synthetic Sessions Analytics, features of Application Analytics that extend the functionality of Synthetic Sessions—require access to the AppDynamics Events Service.
Synthetic Agent Requirements
The following table lists the requirements for deploying Private Synthetic Agents and Hosted Synthetic Agents.
Synthetic Agent | Requirements |
---|---|
Private Synthetic Agents | See Install the Private Synthetic Agent. |
Hosted Synthetic Agents |
|
Hardware Requirements
These requirements assume that the Synthetic Server is installed on a separate machine. If other AppDynamics platforms are installed on the same machine, the requirements (particularly for memory) could vary greatly and require many more resources.
- Storage: 50 GB free disk space
- Memory: 8 GB memory
- CPU: 64-bit CPU with at least 2 cores
- Network bandwidth: 50 Mbps
NTP should be enabled on both the EUM Server host and the Controller machine. The machine clocks need to be able to synchronize.
Scaling Requirements
You are required to have one EUM account for each on-premises deployment of the Synthetic Server. The machine hosting the Synthetic Server should be able to support 100 concurrent Synthetic Agents or 10 locations with 10 Synthetic Agents per location.
If you need the Synthetic Server to support more than 100 concurrent Synthetic Agents, see Increase the Synthetic Agent Support.
Operating System Support
The Synthetic Server is supported on the following operating systems:
Linux (64 bit) |
---|
|
You can use the following file systems for machines that run Linux:
- ZFS
- EXT4
- XFS
On-premises deployments on Linux are only supported on Intel architecture. Windows is not supported at this time.
Network Requirements
The network settings on the operating system need to be tuned for high-performance data transfers. Incorrectly tuned network settings can manifest themselves as stability issues.
The following command listing demonstrates tuning suggestions for Linux operating systems. As shown, AppDynamics recommends a TCP/FIN timeout setting of 10 seconds (the default is typically 60), the TCP connection keepalive
time to 1800 seconds (reduced from 7200, typically), and disabling TCP window scale, TCP SACK, and TCP timestamps.
echo 5 > /proc/sys/net/ipv4/tcp_fin_timeout
echo 1800 >/proc/sys/net/ipv4/tcp_keepalive_time
echo 0 >/proc/sys/net/ipv4/tcp_window_scaling
echo 0 >/proc/sys/net/ipv4/tcp_sack
echo 0 >/proc/sys/net/ipv4/tcp_timestamps
The commands demonstrate how to configure the network settings in the /proc
system. To ensure the settings persist across system reboots, be sure to configure the equivalent settings in the etc/sysctl.conf
or the network stack configuration file appropriate for your operating system.
Software Requirements
The Synthetic Server requires the following software to run and function correctly. You are required to have outbound internet access to install Python, pip
, and flake8.
Software | Required Version | Function |
---|---|---|
Java | 17 | The Synthetic Server requires JDK 17 to run services such as Synthetic Scheduler and Synthetic Shepherd. You need to set the environmental variable |
Python | 2.7 | The Synthetic Server relies on Python to validate scripts. |
pip | 9+ | Python uses If the machine where you're installing the Synthetic Server does not have Internet access, run the following steps to fetch and install
|
libaio | N/A | The Synthetic Server requires the See How to Install libaio for instructions. |
How to Install libaio
Install libaio
on the host machine if it does not already have it installed. You may require outbound internet access if you don't have a locally hosted repository.
The following table provides instructions on how to install libaio
for some common flavors of the Linux operating system. Note that if you have a NUMA based architecture, you are required to install the numactl
package.
Linux Flavor | Command |
---|---|
Red Hat and CentOS | Use
|
Fedora | Install the library RPM from the Fedora website:
|
Ubuntu | Use apt-get, such as:
|
Debian | Use a package manager such as APT to install the library (as described for the Ubuntu instructions above). |