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

Operating Systems

Systems	Versions
Windows (64-bit)	10/11, Server 2019/2022
Mac Silicon (ARM64), Intel (x64)	macOS 14.2/13.6/12.7
Red Hat Enteprise Linux (RHEL) (64-bit)	7.x/8.x
CentOS Linux (64-bit)	7.7
Ubuntu LTS Linux (64-bit)	16.04/22.04

Operating System Notes

• Eggplant Functional no longer supports macOS 10 or 11 as of 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.

• Beginning with EPF 23.3.0, two installation packages are available for each Ubuntu LTS and RHEL or CentOS. The package you want depends on the version of the operating system you are running where you plan to install EPF:

  • For RHEL and CentOS there is one package for installation on 7.x versions of both operating systems, and a separate one for installation on 8.x versions of RHEL only. See the notes below for more information about installing on RHEL 8.

  • For Ubuntu LTS, there is one package for installation on 16.04 and a separate one for installation on 22.04. See the notes below for more information about installing EPF on Ubuntu LTS 22.04.

• For EPF installations on RHEL 8:

  • Beginning with version 23.3.0, an EPF installation package is available 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 some system libraries. If you are running EPF on RHEL 8 with modified system libraries, and want to install the EPF package that is specifically for RHEL 8, please uninstall the previous EPF installation and remove the modified libraries before installing the new package.

  • Beginning with EPF 23.3.1, the EPF GUI is supported on RHEL 8. Note that the GUI was not supported in the RHEL 8 package available in the EPF 23.3.0 release. The RHEL 8 package in 23.3.0 EPF release only supports command line scripts runs with the runscript command (also known as "headless executions").

  • If you want to upgrade to the EPF package that is specifically for RHEL 8, and you are upgrading from an EPF on RHEL 7, or you installed a previous version that was not specifically for RHEL 8 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 package. Note that you only need to reset the SUT passwords one-time after you first install the EPF package for RHEL 8.

• For EPF installations on Ubuntu LTS 22.04:

  • Beginning with EPF 23.2.0, an EPF installation package is available specifically for Ubuntu 22.04. A package for installation on Ubuntu 16.04 is also still available. For information about installing the different EPF packages on Ubuntu, see Installing Eggplant Functional on Linux.

  • Beginning in EPF 23.3.1, the GUI is supported and enabled by default in the EPF package that is specifically for Ubuntu 22.04. Note that the GUI was not supported in the EPF packages for Ubuntu 22.04 that are available in EPF releases 23.2.0 through 23.3.0. These releases only support command line scripts runs with the runscript command (also known as "headless executions").

  • If you want to upgrade to use the package of EPF that is specifically for Ubuntu 22.04, but modified the system libraries on your Ubuntu 22.04 system so that it could work with an earlier version of EPF, please uninstall the previous EPF installation and remove the modified libraries before installing the new Ubuntu 22.04 package.

  • If you are upgrading from an EPF installation on Ubuntu 16.04, or you installed an EPF package prior to 23.3.0 that was not specifically for Ubuntu 22.04 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 package. Note that you only need to reset the SUT passwords one-time after you first install the EPF package for Ubuntu 22.04.

• 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.

• For information about the Citrix authentication methods that are supported in EPF, see Citrix Prerequisites on the Connecting to Citrix Desktops and Applications page.

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.