Installing a PTF Client

Browser Security Settings for Chrome

The following Chrome policies can block extensions. PTF is designed to work with or without these policies. If extensions are blocked as per these policies, then the Chrome-based recorder must be enabled and installed manually as per the instructions provided in the subsequent section for installing PTF Chrome Recorder Extension:

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionAllowedTypes] "1"="extension"

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallBlocklist] "1"="*"

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallAllowlist] "1"="boainbfkaibcfobfdncejkcbmfcckljh"

We see the following error message when these policies are configured to block Chrome extensions:

Browser Security Settings for Microsoft Edge

The following Microsoft Edge policies can block extensions. PTF is designed to work with or without these policies. If extensions are blocked as per these policies, then the Microsoft Edge-based recorder must be enabled and installed manually as per the instructions provided in the subsequent section for installing PTF Microsoft Edge recorder extension:

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionAllowedTypes] "1"="extension"

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallBlocklist] "1"="*"

• [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionInstallAllowlist] "1"="boainbfkaibcfobfdncejkcbmfcckljh"

Installing PTF Chrome Recorder Extension

You may want to manually install the recorder extension when certain browser policies block the recorder extension.

To install PTF Chrome Recorder extension:

1. Close all the Chrome windows that already opened.

2. Open a new Chrome browser window as administrator.

3. Open the URL chrome://extensions/.

4. Enable the developer mode by clicking on the Developer mode toggle button.

5. Keep the Chrome window open and then navigate to the PTF installation directory.

6. Select the psTstRecCh.crx file. Next, drag and drop this file on the opened Chrome browser.

   An alert box appears with the Add Extension button.

7. Add the extension. A confirmation message appears on the Chrome window.

8. Close the Chrome window, and start PTF to launch the Chrome Recorder.

Uninstalling PTF Chrome Recorder Extension

You may have to uninstall old PTF Chrome Recorder extensions.

To uninstall:

1. Close all the Chrome browser windows that are already opened.

2. Open a new Chrome browser window as administrator.

3. Open the URL chrome://extensions/

4. Search for PTF Recorder, and click Remove.

5. A message 'Remove PTF recorder?' appears.

6. Click Remove, and then close the Chrome window.

Installing PTF Microsoft Edge Recorder Extension

To install PTF Microsoft Edge Recorder extension:

1. Close all the Microsoft Edge windows that already opened.

2. Open a new Microsoft Edge browser window as administrator.

3. Open the URL edge://extensions/.

4. Enable the developer mode by clicking on the Developer mode toggle button.

5. Keep the Edge window open and then navigate to the PTF installation directory.

6. Select the psTstRecCh.crx file. Next, drag and drop this file on the opened Edge browser.

   An alert box appears with the Add Extension button.

7. Add the extension. A confirmation message appears on the Edge window.

8. Close the Edge window, and start PTF to launch the Edge Recorder.

Uninstalling PTF Microsoft Edge Recorder Extension

You may have to uninstall old PTF Microsoft Edge Recorder extensions.

To uninstall:

1. Close all the Microsoft Edge browser windows that are already opened.

2. Open a new Microsoft Edge browser window as administrator.

3. Open the URL edge://extensions/

4. Search for PTF Recorder, and click Remove.

5. A message 'Remove the PTF recorder from Microsoft Edge?' appears.

6. Click Remove, and then close the Microsoft Edge window.

Installing PTF from PeopleTools Client Deployment Packages (DPK)

PeopleTools Client deployment is documented in PeopleSoft PeopleTools Deployment Packages Installation guide, Task 2-12: Deploying the PeopleTools Client DPK.

Download the PeopleTools Deployment Packages Installation guide from PeopleSoft PeopleTools Home Page on My Oracle Support for the current PeopleSoft PeopleTools release.

For example, for PeopleTools release 8.59, download the DPK Installation guide from PeopleSoft PeopleTools 8.59 Home Page on My Oracle Support.

The directions here only refer to the PeopleSoft Test Framework portion.

When you deploy PeopleTools Client in standalone mode using (SetupPTClient.bat -t), you will be prompted whether or not to install PeopleSoft Test Framework.

Do you want to install PeopleSoft Test Framework? [Y/N]:

If you answer y (yes), specify the installation directory, or accept the default, C:\Program Files\PeopleSoft\PeopleSoft Test Framework:

Please specify the directory to install PeopleSoft Test Framework [C:\Program Files\PeopleSoft\PeopleSoft Test Framework]:

If you enter a directory where a previous version of PeopleSoft Test Framework is installed, it will upgrade that version to the new PeopleTools release/patch.

Next, you will be prompted whether or not to configure PeopleSoft Test Framework.

Do you want to configure PeopleSoft Test Framework? [Y/N]: n

If you choose y (yes) to configure PTF, the deployment process prompts you for setup parameters. You can configure PTF either at the same time that you install it or later.

This example shows the setup parameters:

Database Name: HCM92
Server:Port: example.com:443
Node ID: node_name
User ID: VP1
Proxy [Y/N]: y
Proxy Server: proxyserver.com
Proxy Port: 5000
Proxy User: username
Proxy Password:*******
Retype Proxy Password:*******

You can even use the deployment process to re-configure PTF in cases where you do not need to re-install PTF.

See Creating a Connection to a PTF Environment, for details on setup parameters.

This example shows PTF installation using SetupPTClient.bat -t, and PTF is done as a separate installation as PeopleTools 8.58 Client is already deployed (first option is specified as n.)

Microsoft Windows [Version 6.1.7601]
Copyright (c) 2009 Microsoft Corporation.  All rights reserved.

C:\Users\abc>cd C:\dpk_858\909_client

C:\dpk_858\909_client>SetupPTClient.bat -t
****** SetupPTClient started at  7:23:01.88 ******

Do you want to deploy PeopleTools client? [Y/N]: n

Do you want to install Change Assistant? [Y/N]: n

Do you want to install Change Impact Analyzer? [Y/N]: n

Do you want to install PeopleSoft Test Framework? [Y/N]: y

Please specify the directory to install PeopleSoft Test Framework [C:\Program F
iles\PeopleSoft\PeopleSoft Test Framework]:

Do you want to configure PeopleSoft Test Framework? [Y/N]: n

Please specify the PSHOME for the PeopleTools Client [C:\PT8.58
_Client]:c:\pt8.58

Starting Tools Client Deployment!
Installing Peoplsoft Test Framework in C:\Program Files\PeopleSoft\PeopleSoft T
est Framework for PTools Version 8.58

Deployment of PeopleTools Client Complete.

Tools Client Deployment Ended.

"****** SetupPTClient ended at  7:27:30.10 ******"
"Please review C:\users\abc\AppData\Local\Temp\PeopleSoft\PTClientDeploy.log
for additional information."

C:\dpk_858\909_client>

This setup will add the shortcut to the desktop.

Installing PeopleSoft Test Framework in Silent Mode

You can carry out a silent installation of PeopleSoft Test Framework by supplying command-line parameters to a script.

With silent installation there is no user interaction after you begin the installation.

The PeopleSoft Test Framework installer includes the following files in the directory PS_HOME\setup\PsTestFramework:

• setup.bat – Use this script to upgrade an existing PeopleSoft Test Framework instance or install a new instance.

• resp_file.txt – This file provides the instructions for silent install.

• response-file.txt – This file provides the path to install PeopleSoft Test Framework.

To use the PeopleSoft Test Framework silent installation script:

1. In a command prompt, go to PS_HOME\setup\PsTestFramework.

   Note: Do not move the file to another location.

2. Run the following command:

   setup.bat -f resp_file.txt -p <Path>

   If <Path> is supplied, and it is valid, then PeopleSoft Test Framework will be installed in that location. If the path is not supplied or invalid, setup.bat will read the response-file.txt for the location.

   Warning! Silent install deletes all content present in the <Path> location.

To uninstall PTF:

1. In a command prompt, go to PS_HOME\setup\PsTestFramework.

2. Run the following command:

   setup.bat  -u U 

Troubleshooting Tips

This section describes some of the errors you might encounter when attempting to log in to PTF and suggests possible solutions.

You will receive a login error if PTF security has not been configured correctly. Possible causes and solutions for this error are:

• The user ID and password you entered are not valid for the PeopleSoft application corresponding to the entry in the Server:Port field.

• The user ID you entered in the User field in the Environment Login does not have PTF privileges. Add at least the PTF User role to the user profile.

• The user ID for the ANONYMOUS node does not have PTF privileges. Add at least the PTF User role to the user profile.

You will receive the following error message if you specify the wrong HTTPS port in the environment login URL:

There was an error when PeopleSoft test Framework was trying to login.
Please, check if the User ID and Password are correct.

ErrMessage:Could not connect to https://example.com:442/PSIGW/HttpListeninConnector. TCP error code 10061: No connection could be made because the target machine actively refused it
192.0.2.1:442
ErrSource:mscorlib

The default port is 443. If a different port was specified during installation, you will need to contact your system administrator to determine the correct port number.

You will receive the following error message if you try to logon to an environment that is not secured with an SSL Certificate.

This example illustrates the error message received when trying to login to an unsecured environment.

PTF requires use of an HTTPS site for security purposes. Contact your PTF administrator to resolve this error.