Read: PTF Client Installation

In this section, you will find documentation describing how to install PTF. Additional documentation is available from Oracle in PeopleBooks.


  • Windows 64-bit: The PTF client only runs on a 64-bit Microsoft Windows operating system.
  • Internet Explorer 11: Right now, the PTF recorder will only record against Internet Explorer 11. Playback is supported on Chrome and Firefox as well. For current supported browser information for your PeopleTools release, refer to the Certifications tab in My Oracle Support.
  • .Net 4.6.1: You must install Microsoft’s .Net framework version 4.6.1 prior to installing the PTF client.
  • Directory Access: According to PeopleBooks, PTF will install into C:Program FilesPeopleSoftPeopleSoft Test Framework. It is our experience, however, that PTF installs into the directory described in response-file.txt, which is in the installation directory. Regardless of the target, the person running the workstation installation must have write access to this directory. The PTF runtime will store data in the user’s ApplicationDataPeopleSoftPeopleSoft Test Framework at runtime.

The PeopleSoft DPK default installation location is C:testINSTPTF. Our training environments use C:psenvPTF

Browser Settings

  • Trusted Sites: Be sure to add your PeopleSoft instance’s domain name to the Local Intranet Zone. PeopleBooks recommends adding both the HTTP and HTTPS URLs.
  • Enable Protected Mode: Whether you choose to enable or disable protected mode is between you and your system administrator. Whatever the decision, all zones must be the same.
  • General Settings: Select “Start with homepage.”
  • Zoom Settings: set to 100%.

Running the Install

  • PeopleBooks tells us to launch the installTestFramework.exe program from %PS_HOME%setupPsTestFramework. This was correct in the past.
  • It is our experience, however, that PeopleSoft Test Framework is installed by running the setup.bat batch file in %PS_HOME%setupPsTestFramework.
  • If using the modern setup.bat install, the target install directory is described in the delivered response-file.txt text file in %PS_HOME%setupPsTestFramework.

Playback Browser Support

  • Browser support varies by PeopleTools release. As of PeopleTools 8.57.04, the following MOS document is relevant 704492.1. This document says that IE, Firefox, and Chrome are supported for playback.
  • Chrome: We found Chrome to be the fastest and most reliable in all situations. The challenge we have is pairing PeopleTools versions with Chrome versions. In prior PeopleTools, PeopleSoft published a minimum and maximum Chrome version. Today, they publish a minimum but no maximum. For PeopleTools 8.57.14, the minimum Chrome version is 73. The current Chrome version when this class was published was 81. Even though PeopleSoft does not publish a maximum Chrome version anymore, every PeopleTools update deals with browsers a little differently. 8.57.14, for example, includes Chrome drivers for several very specific release labels from 74 through 79, but at the time of writing, Chrome was at version 81. We can support later browsers, however, by downloading the latest Selenium driver from https://chromedriver.chromium.org/downloads, adding the version suffix, and moving it into the PTF install directory. The following is a screenshot to support version 81, which was not delivered with 8.57.14:
  • Firefox: has the best support and may run quite well in your environment. In some of our environments, we found some configurations where Firefox would not run and others where it ran incredibly slowly. If you choose Firefox, be sure to install vc_redist.x86 from Microsoft. The Selenium gecko driver is a 32-bit program that requires the 32-bit Visual Studio C++ runtime.
  • Internet Explorer: We do not recommend Internet Explorer for playback. When configured properly, it works well but is slow. The biggest challenge to Internet Explorer in an enterprise environment is the configuration. Internet Explorer zone and security settings are often controlled through policies at the enterprise level.

Internet Explorer officially retired on June 15, 2022. Since some organizations still use it, we left the documentation in our activity guide.