Installing Eggplant Functional

Eggplant Functional (EPF) runs on Windows, Mac, and Linux. Before you start your installation process, please be sure to read Prerequisites for information about supported operating systems and recommended installation configurations.

note

Starting after the release of EPF 23.1.1, the system requirements and supported operating system information moved to the Prerequisites page. Please see this page for more information about setting up systems for your EPF installation.

Following are instructions for installing on Windows, Mac, and Linux.

Installing Eggplant Functional on Windows

1. Download the EPF Windows installer from the Eggplant Functional Downloads page.

2. Double-click the EPF installer, then follow the instructions in the Setup Wizard to complete installation.

Important

When you launch EPF for the first time after installation, you are required to agree to the Keysight EULA and acknowledge the Keysight Privacy Policy.

tip

For quick access to Eggplant Functional, right-click the EPF icon on your desktop and select Pin to Taskbar or Pin to Start Menu.

Installing Eggplant Functional on Mac

1. Download EPF from the Eggplant Functional Downloads page.
2. Double-click the EPF .dmg file, then drag the EPF application into your Applications folder.

Important

When you launch EPF for the first time after installation, you are required to agree to the Keysight EULA and acknowledge the Keysight Privacy Policy.

tip

For quick access to EPF, drag the EPF icon from the Applications folder into your Dock.

Installing Eggplant Functional on Linux

EPF provides installation packages for Red Hat Enterprise Linux (RHEL), CentOS, and Ubuntu. Information about the available packages and instructions for installing them are provided below.

Installing EPF on Red Hat Enterprise Linux (RHEL) and CentOS

EPF provides two installation packages for RHEL and CentOS. The package you need, and the package manager you need to use to install it, depend on which operating system version you are running.

EPF RHEL and CentOS Packages and Required Package Managers

Red Hat Enterprise Linux (RHEL) and CentOS Support	Version	Package Manager
RHEL	8	dnf
RHEL and CentOS	7.x	rpm or yum

Step by Step: Installing on RHEL and CentOS

note

If you want to run EPF on RHEL 8, and are currently running EPF on RHEL 7, or if you installed a version of EPF prior to the 23.3.0 version on RHEL 8, you need to reset the system under teset (SUT) connection passwords for any existing saved passwords after you install the 23.3.0 version. Note that you only need to reset the SUT passwords one-time after you first install the EPF package for RHEL 8.

Installation Steps	RHEL- and/or CentOS-Specific Instructions by Version
1. Download the appropriate EPF archive file from the Downloads page to the machine where you want to install EPF.	For RHEL 8: Download the archive specifically for Enterprise 8. For RHEL 7 and CentOS 7: Download the archive specifically for CentOS 7.
2. Unpack the EPF archive (.tgz) file, which extracts a folder containing the EPF install package.	For RHEL 8, RHEL 7, or CentOS 7: Use the extract utility available for your linux version. To use the tar extractor, open a terminal and enter the extract command at the command line. For example: For RHEL 8: tar xvfz Eggplant_EnterpriseLinux8.tgz For RHEL 7 or CentOS 7: tar xvfz Eggplant_EnterpriseLinux7.tgz Be sure to qualify the archive name with the path to its location.
3. If EPF is already installed on this machine, open a terminal and use elevated privileges to remove the existing EPF package. Note that the E in the Eggplant package name must be upper-case.	For RHEL 8 Use the dnf package manager remove command: sudo dnf remove Eggplant For RHEL 7 or CentOS 7: Use the yum package manager remove command: sudo yum remove Eggplant
4. Install the new EPF package using elevated privileges.	For RHEL 8: Use the dnf package manager install command. For example: sudo dnf install Eggplant_EnterpriseLinux8/Eggplant_EnterpriseLinux8_<version>.rpm, where version is the EPF release you are installing. Be sure to qualify the package name with the path to its location, including the enclosing folder. For RHEL 7 and CentOS 7: Use the rpm package manager install command with the --force flag. For example: sudo rpm -i --force Eggplant_EnterpriseLinux7/Eggplant_EnterpriseLinux7_<version>.rpm, where version is the EPF release you are installing. Be sure to qualify the package name with the path to its location, including the enclosing folder.

Important

When you launch EPF for the first time after installation, you are required to agree to the Keysight EULA and acknowledge the Keysight Privacy Policy.

Example RHEL 8 Installation Commands

You can copy the following sample RHEL 8 installation commands, paste them into your linux terminal, and run them. Be sure to replace the EPF archive and package names with the names and locations of the archive and package you are installing. Then run the commands with elevated privileges as shown. You may be prompted to confirm that you want to perform a task while running these commands. Enter "Y" or "y" for "Yes" to confirm as needed.

tar xvfz Eggplant_EntepriseLinux8.tgz
sudo dnf remove Eggplant
sudo dnf install <path_to_extracted_epf_install_package>/Eggplant_EnterpriseLinux8/Eggplant_EnterpriseLinux8_<version>.rpm

note

Bonjour discovery is disabled.

Installing EPF on Ubuntu

EPF provides two installation packages for Ubuntu LTS. The package you need, and the package manager you need to use to install it, depend on which operating system version you are running.

EPF Ubuntu Packages and Required Package Managers

Ubuntu Support	Version	Package Manager
Ubuntu LTS	22.04	apt
Ubuntu LTS	16.04	apt or dpkg

Step by Step: Installing on Ubuntu

note

If you want to run EPF on Ubuntu 22.04, and are currently running EPF on Ubuntu 16.04, or if you installed a version of EPF prior to installing the 23.3.0 version on 22.04, you need to reset the system under test (SUT) connection passwords for any existing saved passwords after you install the 23.3.0 version. Note that you only need to reset the SUT passwords one-time after you first install the EPF package for Ubuntu 22.04.

Installation Steps	Ubuntu-Specific Instructions by Version
1. Download the appropriate EPF for archive file from the EPF Downloads page to the machine where you want to install EPF.	For Ubuntu 22.04: Download the archive specifially for 22.04. For Ubuntu 16.04: Download the archive specifically for 16.04.
2. Unpack the EPF archive (.tgz) file, which extracts a folder containing the EPF install package.	For 22.04 and Ubuntu 16.04: Use the extract utility available for your linux version. To use the tar extractor, open a terminal and enter the extract command at the command line. For example: For Ubuntu 22: tar xvfz Eggplant_Ubuntu22.tgz For Ubuntu 16: tar xvfz Eggplant_Ubuntu16.tgz Be sure to qualify the archive name with the path to its location.
3. If EPF is already installed on this machine, open a terminal and use elevated privileges to remove the existing EPF package. Note that the e in the Eggplant package name must be lower-case.	For Ubuntu 22.04 and 16.04: Use the apt package manager remove command: sudo apt remove eggplant
4. Update your system to the latest Ubuntu packages using elevated privilges.	For Ubuntu 22.04: This step is required to update the base Ubuntu 22.04 operating system package with updates for EPF 23.3.0 or higher: sudo apt update
5. Open a terminal (if not already open) and install the new EPF package using elevated privileges.	For Ubuntu 22.04: Use the apt package manager install command. sudo apt install Eggplant_Ubuntu22/Eggplant_Ubuntu22_<version>.deb, where version is the release of EPF you are installing. Be sure to qualify the package name with the path to its location, including the enclosing folder. Ubuntu 16.04: Use the dpkg package manager install command: sudo dpkg -i Ubuntu_16/Eggplant_Ubuntu16_<version>.deb, where version is the release of EPF you are installing. Be sure to qualify the package name with the path to its location, including the enclosing folder. If you want to use the EPF GUI with Ubuntu 16.04, you need to install the Gnome desktop. You can use the following command to determine if its package is installed on your system: dpkg -L gnome-session-flashback If you need to install the Gnome desktop package, follow the steps below: 1. Install the Gnome desktop package using the following command. You can rerun the command above to ensure the package installed, if you want: sudo apt-get install gnome-session-flashback 2. Log out and when you log back in, choose the Metacity desktop option. 3. Verify that you are using the Metacity desktop using the following command: echo $DESKTOP_SESSION

Important

When you launch EPF for the first time after installation, you are required to agree to the Keysight EULA and acknowledge the Keysight Privacy Policy.

Example Ubuntu 22.04 Installation Commands

You can copy the following sample Ubuntu 22.04 installation commands, paste them into your linux terminal, and run them. Be sure to replace the EPF archive and package names with the names and locations of the archive and package you are installing. Then run the commands with elevated privileges as shown. You may be prompted to confirm that you want to perform a task while running these commands. Enter "Y" or "y" for "Yes" to confirm as needed.

tar xvfz Eggplant_<version>.tgz
sudo apt remove eggplant
sudo apt update
sudo apt install <path_to_extracted_epf_install_package>/Eggplant_Ubuntu22/Eggplant_Ubuntu22_<version>.deb

Licensing Eggplant Functional

When you complete installation, the next step is to license EPF. To read about this process, see Licensing Eggplant Functional. For specific instructions on using team licenses, see Using RLM for Team License Management.

Uninstalling Eggplant Functional

Information about removing EPF from your system is described below by operating system type.

From Windows

To uninstall EPF from a Windows system, use the Windows operating system Add/Remove Programs utility in the Control Panel. This removes the Eggplant folder from C:\Program Files, but leaves files in the installing users AppData folder.

From macOS

To uninstall EPF from macOS system, drag the Eggplant Functional from the Applications folder to the trash and then empty the trash. This removes EPF as an application but leaves some files.

From Linux

The command you use to uninstall EPF from a linux system depends on the version of linux you are using and the EPF linux package you installed. The following table summarizes the EPF uninstall commands by linux version. The same commands are provided below the table in a format you can copy into your linux terminal and run.

Important

The case of the letter "e" or "E" in the Eggplant package name is significant in the following commands:

• For Red Hat: The E is upper-case.
• For Ubuntu: The e is lower-case.

Use elevated privileges and the appropriate package manager for your linux operating system as shown in the commands below.

Linux Version	Uninstall Command
RHEL 8	sudo dnf remove Eggplant
RHEL 7 or CentOS 7	sudo yum remove Eggplant
Ubuntu 22.04	sudo apth remove eggplant
Ubuntu 16.04	sudo dpkg -r eggplant or sudo apt remove eggplant

Uninstall EPF from RHEL 8

You can copy the following EPF uninstall commands, paste them into your linux terminal, and run them. Be sure to run the commands with elevated privileges as shown. You may be prompted to confirm that you want to perform a task while running these commands. Enter "Y" or "y" for "Yes" to confirm as needed.

sudo dnf remove Eggplant

Uninstall EPF from RHEL 7 or CentOS 7

sudo yum remove Eggplant

Uninstall EPF from Ubuntu 22.04

sudo apt remove eggplant

Uninstall EPF from Ubuntu 16.04

sudo dpkg -r eggplant

or

sudo apt remove eggplant