Prerequisites
Following are prerequisites for using Eggplant Functional (EPF), including supported operating systems (OSs) and software, hardware and memory recommendations, default port usage, and related notes. To achieve the best results in your environment, consider how and where you plan to run your tests. For example, on which machines will you run the EPF GUI to write your scripts? Will you run multiple tests on multiple instances of EPF at the same time without the GUI? Plan to set up your test systems accordingly. If you have any questions, please don't hesitate to contact our Customer Support.
System Recommendations
Processor Recommendations
| System | Number of EPF Instances Running | Processor |
|---|---|---|
| Windows (64-bit) | 1 | 2 GHz dual core or faster |
| Mac Silicon (ARM64), Intel (x64) | 1 | 2 GHz dual core or faster |
| Linux | 1 | Intel x86 64-bit |
Processor Notes
- If you plan to run multiple instances of EPF simultaneously, you might need to increase your processing power.
Memory Recommendations
| Number of EPF Instances Running | RAM |
|---|---|
| 1 | 16 GB or more |
| Additional GUI | + 8 GB for each additional instance of Eggplant Functional desktop application opened |
| Additional Command license | + 2 GB for each additional process of Eggplant Functional background execution |
Memory Notes
The basic memory requirements are the same for all platforms.
Supported Software
EPF 23.2.102 and 23.2.2 were tested with the following operating systems (OSs), web browsers, and wedriver versions as listed below. Other OS and browser versions may also work.
Operating Systems
| Systems | Versions |
|---|---|
| Windows (64-bit) | 10/11, Server 2019/2022 |
| Mac Silicon (ARM64), Intel (x64) | macOS 14.2/13.6/12.7/11.6 |
| Red Hat Enteprise Linux (RHEL) (64-bit) | 8.x |
| CentOS Linux (64-bit) | 7.7 |
| Ubuntu LTS Linux (64-bit) | 16.04/20.04/22.04 |
Operating System Notes
-
Eggplant Functional will no longer support macOS 10 or 11 in starting in June 2024.
-
The
mfplat.dll, included in the Windows Media Pack, is required for Eggplant Functional 21.1 and later. Some Windows versions, such as Window 10 N, do not include this .dll by default. -
Installing EPF on Ubuntu 20.04 requires modification to system libraries. Check with your IT team to determine if this solution is right for you.
-
For EPF installations on RHEL 8:
-
Beginning with version 23.3.0, EPF provides an installation package specifically for RHEL 8. A package for installation on RHEL 7 and CentOS 7 is also still available. For information about installing the different EPF packages on RHEL or CentOS, see Installing Eggplant Functional on Linux.
-
EPF supported installing earlier versions of EPF on RHEL 8.8 with modifications to your system libraries. If you are running EPF on RHEL 8 with modified system libraries, and want to install the EPF package that is specically for RHEL 8, please uninstall the previous version and remove the modified libraries.
-
The EPF GUI is not supported on RHEL 8. However, you can enable it for limited use with assistance from our Customer Support. For example, you might need to enable the GUI to reset SUT connection passwords as described below.
-
If you are upgrading from an EPF on RHEL 7 or CentOS 7, or you installed a previous version of EPF on RHEL 8, you need to reset the SUT connection passwords for your existing Connection List connections after you install the EPF for RHEL 8 version. Contact our Customer Support for help enabling the GUI and resetting the passwords.
-
-
For EPF installations on Ubuntu 22.04:
-
EPF for Ubuntu 22.04 is available as different installation package from the version that runs on Ubuntu 16.04 and 20.04. For information about installing the different EPF packages on Ubuntu, see Installing Eggplant Functional on Linux.
-
The EPF GUI is not supported Ubuntu 22.04. However, you can enable it for limited use with assistance from our Customer Support. For example, you might need to enable the GUI to reset SUT connection passwords as described below.
-
If you are upgrading from an EPF on Ubuntu 16.04 or 20.04, or you installed a previous version of EPF on Ubuntu 22.04, you need to reset the SUT connection passwords for your existing Connection List connections after you install the EPF for Ubuntu 22.04 version. Contact our Customer Support for help enabling the GUI and resetting the passwords.
-
-
For inquiries about other distributions of Linux, email Customer Support.
System Under Test (SUT) Recommendations and Requirements
We recommend that your systems under test (SUTs) be typical of the systems that run on your company network. EPF supports desktop, webdriver/browser, and mobile device SUTs, and RDP, VNC, webdriver, Citrix (Windows only), Sauce Labs (browsers and mobile devices) connection types.
Information of note about supported SUTs and connection types follow:
Default Port Usage for Connections
| Usage | Port |
|---|---|
| Reprise License Server Adminstration tool | TCP 5052-5054 |
| RDP SUT connections | 3389 |
| VNC SUT connections | 5900 |
| WebDriver SUT connections | 4444 |
Default Port Usage Notes
EPF uses the above ports by default. If you encounter conflicts with the default ports in your environment, you can configure EPF to use different ports. Contact our Customer Support if you have questions about reconfiguring ports.
Web Browsers and Webdrivers
EPF supports webddriver SUT connections with the Selenium server as follows:
| Selenium Server | Version |
|---|---|
| Selenium Grid | 4.4.0 |
| Browser | Version |
|---|---|
| Chrome | 122 |
| Firefox | 103 |
| Edge | 104 |
Web Browser and Webdriver Notes
The web browser testing included testing the same version of the associated webdriver.
Citrix Connections
EPF supports SUT connections with the following Citrix Workspace versions:
| Citrix Version | Version |
|---|---|
| Citrix Workspace Long Term Service Release (LTSR) | 22.03 |
| Citrix Workspace App | 23.09 |
Citrix Connection Notes
-
Citrix connections are only supported with EPF on Windows.
-
To use Citrix connections, you must install one of the Citrix Workspace versions shown above on the same machine with EPF, and you must intall Citrix Workspace before you install EPF.
-
You can download Citrix Workspace LTSR and Citrix Workspace App from the Citrix website.
Sauce Labs Connections
Using Sauce Labs connections with EPF requires Sauce Labs licenses, which are not included with EPF licenses.
Compatible Reprise License Manager (RLM) Server Versions
| RLM Version | Systems | Versions |
|---|---|---|
| 15.1BL2 | Windows (64-bit) | 11 |
| (same as above) | Mac Silicon (ARM64), Intel (x64) | macOS 12 |
| (same as above) | CentOS Linux (64-bit) | 7.7 |
| (same as above) | Ubuntu LTS Linux (64-bit) | 16.04 |
RLM Server Notes
-
RLM is a license manager that integrates with EPF and DAI. For more information about RLM, please see the RLM License Administration guide.
-
The RLM Server version above was tested with the operating systems listed.
-
Starting with v15.1, you must set passwords for the RLM administration web server. If you do not, on startup, RLM will create a new admin account for you and set a default password for it. In that case, you must log into the web server console and change the default admin password. If you have already created accounts for the administration web server prior to the upgrade, you must clear the passwords for the existing accounts and provide new values after the upgrade. If you fail to change the default admin password or you fail to set new passwords for legacy users, the RLM license server will shutdown automatically after 10 minutes. Please refer to page 51 of the RLM License Administration guide for details.