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 Eggplant Functional GUI to write your scripts? Will you run multiple tests on multiple instances of Eggplant Functional 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 Eggplant Functional 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 Eggplant Functional simultaneously, you might need to increase your processing power.

Memory Recommendations

Number of Eggplant Functional 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 Enterprise Linux (RHEL) (64-bit)	8.x
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 Eggplant Functional 23.4.0/1, two installation packages are available for each Ubuntu LTS and RHEL. The package you want depends on the version of the operating system you are running where you plan to install Eggplant Functional:

  • For RHEL there is one package 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 Eggplant Functional on Ubuntu LTS 22.04.

• For Eggplant Functional installations on RHEL 8:

  • Beginning with version 23.3.0, an Eggplant Functional installation package is available specifically for RHEL 8. For information about installing on RHEL 8, see Installing Eggplant Functional on Linux.

  • Eggplant Functional supported installing earlier versions of Eggplant Functional on RHEL 8.8 with modifications to some system libraries. If you are running Eggplant Functional on RHEL 8 with modified system libraries, and want to install the Eggplant Functional package that is specifically for RHEL 8, please uninstall the previous Eggplant Functional installation and remove the modified libraries before installing the new package.

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

  • If you want to upgrade to the Eggplant Functional package that is specifically for RHEL 8, and you are upgrading from an Eggplant Functional 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 Eggplant Functional for RHEL 8 package. Note that you only need to reset the SUT passwords one-time after you first install the Eggplant Functional package for RHEL 8.

• For Eggplant Functional installations on Ubuntu LTS 22.04:

  • Beginning with Eggplant Functional 23.2.0, an Eggplant Functional 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 Eggplant Functional packages on Ubuntu, see Installing Eggplant Functional on Linux.

  • Beginning in Eggplant Functional 23.3.1, the GUI is supported and enabled by default in the Eggplant Functional package that is specifically for Ubuntu 22.04. Note that the GUI was not supported in the Eggplant Functional packages for Ubuntu 22.04 that are available in Eggplant Functional 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 Eggplant Functional 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 Eggplant Functional, please uninstall the previous Eggplant Functional installation and remove the modified libraries before installing the new Ubuntu 22.04 package.

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

• For inquiries about other distributions of Linux, email Customer Support.

• For use with Eggplant Functional and the Eggplant Gateways, all versions of XCode are supported.

System Under Test (SUT) Recommendations and Requirements

We recommend that your system under test (SUT) reflect typical systems run on your company network or for your standard testing. Eggplant Functional supports desktop, webdriver/browser, mobile device, and other types of SUTs accessible through a KVM switch, such as point-of-sale (POS) or Human Machine Interface (HMI) systems. Eggplant Functional supports the following connection types for access to different SUTS: RDP, VNC, webdriver/browser, Citrix (Windows only), and Sauce Labs (browsers and mobile devices). See Connecting to SUTs for more information. For information about connections with a KVM switch, see Using a KVM-over-IP Device.

Information of note about supported SUTs and connection types follow:

Default Port Usage for Connections

Usage	Port
Reprise License Server Administration tool	TCP 5052-5054
RDP SUT connections	3389
VNC SUT connections	5900
WebDriver SUT connections	4444

note

SUT connections enabled with a KVM switch use a VNC connection type.

Default Port Usage Notes

Eggplant Functional uses the above ports by default. If you encounter conflicts with the default ports in your environment, you can configure Eggplant Functional to use different ports. Contact our Customer Support if you have questions about reconfiguring ports.

Web Browsers and WebDrivers

Eggplant Functional supports WebDriver SUT connections with the Selenium server as follows:

Selenium Server Components	Version
Selenium Grid Server	4.0.0 - 4.4.0
Java	11 - 22

Please see Getting Started with Selenium Grid for more information from Selenium.

Browser	Version
Chrome	122
Firefox	103
Edge	104
Edge Chromium	92.0
Safari	14.1.2

Notes on Web Browsers and WebDrivers

The web browsers listed are used with the associated versions of their WebDrivers. Safari doesn't require installation of a separate WebDriver, as the safaridriver comes installed with the macOS Operating System. For more information on Safari, see Safari Specific Functionality from Selenium.

Citrix Connections

Eggplant Functional 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 Eggplant Functional on Windows.

• To use Citrix connections, you must install one of the Citrix Workspace versions shown above on the same machine with Eggplant Functional, and you must intall Citrix Workspace before you install Eggplant Functional.

• 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 Eggplant Functional, see Citrix Prerequisites on the Connecting to Citrix Desktops and Applications page.

Sauce Labs Connections

Using Sauce Labs connections with Eggplant Functional requires Sauce Labs licenses, which are not included with Eggplant Functional licenses.

Compatible Reprise License Manager (RLM) Server Versions

The Reprise License Manager (RLM) Server is a license manager that integrates with Eggplant Functional and DAI. For more information about RLM, please see the RLM License Administration guide.

RLM Server Version	Systems	Versions
15.1BL2/16/16.1	Windows (64-bit)	10/11, Server 2019/2022
(same as above)	Mac Silicon (ARM64), Intel (x64)	macOS 15.x/14.x
(same as above)	Red Hat Enterprise Linux (RHEL)	Rocky Linux (64-bit)
(same as above)	Ubuntu LTS Linux (64-bit)	16.04/22.04

RLM Server Notes

• We recommend using RLM version 16.1 with Eggplant Functional versions 23.5.x, although Eggplant Functional is compatible with the other RLM Server versions listed in the table above.

• We expect the RLM Server to work with Eggplant Functional on the operating systems listed in the table above based on the testing we've performed with various combinations of RLM Server and Eggplant Functional versions.

• Starting with RLM v16.0, the RLM Web Server for license administration uses the more secure HTTPS communications protocol by default. (Reprise added support for HTTPS in v15.1.) For more information, see The RLM Web Server and Enabling HTTPS in the RLM Web Server in the License Server > Administration Basics section in the Reprise Documentation.

• Also, starting with RLM v16.0, logins are now required for access to the RLM Web Server interface. On your first login, you will be prompted to set a new password. Please refer to the RLM Web Server for details.

• Support for RLM 16 was added in Eggplant Functional 23.4.2.