Installation of the Functional Testing Framework Entities

Well, you are on the way to install the Functional Testing Framework!

Follow the next three steps:

Check pre-installation conditions

Install the Magento application

To install the Magento application, see Magento Installation Guide.

Check if all required software installed and configured


For more details about PHP verification, installation and configuration (Ubuntu, CentOS).

In php.ini file, make sure extension=php_openssl.dll is not commented out.

Check if the Functional Testing Framework has been already installed

  1. Find directory <magento2_root_dir>/dev/tests/functional/.
  2. Find the vendor directory. If the directory exists, you already have the Functional Testing Framework installed in vendor/magento/mtf.

Perform the installation

The Functional Testing Framework requires Composer, which downloads libraries defined in <magento2_root_dir>/dev/tests/functional/composer.json.

If you're not sure that Composer is installed, see Install Composer.

  1. Open a command prompt.
  2. Log in to your Magento server as a user with permissions to modify the Magento file system. (This is typically the Magento file system owner.)
cd <magento2_root_dir>/dev/tests/functional/
composer install

If command failed, maybe Composer hasn't been installed globally.
Copy composer.phar to /usr/local/bin/composer.
To run it locally put composer.phar into directory, where composer.json file is located (that is, <magento2>/dev/tests/functional/).
And run from this directory php composer.phar install.

Check the installation

Find the Functional Testing Framework directory

Check whether the vendor directory exists in <magento2_root_dir>/dev/tests/functional/.

cd <magento2_root_dir>/dev/tests/functional/

Find the mtf directory.

cd vendor/magento

Verify the Functional Testing Framework version

Open <magento2_root_dir>/dev/tests/functional/vendor/magento/mtf/ The latest version in is version of the FTF you installed.

Next Steps

Adjust FTF configuration