Skip to main content

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.

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.

    From the Select Components screen, you can choose to install Bonjour, which discovers other devices on your local network. Check with your system administrator if you're not sure whether or not you should install this service.

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

The following instructions are for installing EPF on Red Hat Enterprise Linux (RHEL), CentOS, and Ubuntu:

  1. Download EPF for your Linux distribution from the Eggplant Functional Downloads page.

  2. Unpack the EPF archive.

  3. If EPF is already installed on this machine, open a shell and use elevated privileges to remove the existing EPF package with the package manager for your linux platform.

  4. Install the new EPF package from the extracted Eggplant folder with the elevated privileges and the package manager.

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.

Notes for Red Hat Enterprise Linux (RHEL) 7

Bonjour discovery is disabled.

Notes for CentOS 7

You need to use the --force flag. Install the package from the command line with the following command:

sudo rpm -i --force <packagename>

Notes for Ubuntu

  • For EPF installations on Ubuntu:

    • There are different installations for EPF on Ubuntu, and you need to use different package managers to install them:

      • To install EPF on Ubuntu 16.04 or 20.04, use the dpkg package manager.
      • To install EPF on Ubuntu 22.04, use the apt package manager and follow the instructions here.
    • The EPF GUI is disabled for installations on Ubuntu 22.04. Contact our Customer Support if you want to enable it.

    • If you are upgrading EPF running on Ubuntu 16.04 to an EPF version for Ubuntu 22.04, or you installed a previous version of EPF on Ubuntu 22.04, you need to reset the system under test (SUT) connection passwords for your existing connections due to a change in encryption schemes between the two versions. You need to enable the GUI to change these passwords.

  • The EPF GUI needs the Gnome desktop on Ubuntu. 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

Licensing

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.