Configuring and running Rational® Functional Tester adapter for IBM® Engineering Test Management

You can integrate Rational® Functional Tester with Engineering Test Management by using an adapter. The adapter is available in the Rational® Functional Tester installation directory. You can run the tests that you create by using Rational® Functional Tester in Engineering Test Management after you configure and start the adapter.

Before you begin

If you are a Engineering Test Management user, you must have appropriate permissions to use the Rational® Functional Tester adapter for Engineering Test Management.
You must have a Connector client access license or a license that supersedes the Connector client access license. For more information, refer to Client access license management in the Engineering Lifecycle Management Solution knowledge center.
You must have modified the hosts file and map the host name of the Engineering Test Management server to its IP address if the host name of your Engineering Test Management server is not registered with the DNS server.
Important: You must configure and start the adapter through the command-line interface to connect the adapter to the Engineering Test Management server through a proxy server. For information, see Related Links.

Procedure

Complete the following steps based on the operating system:
- For Windows operating systems, navigate and click configureadapter.bat from the directory path FunctionalTester > RQMAdapter in the Rational® Functional Tester installation directory.
- For Linux operating systems, navigate to the directory path FunctionalTester > RQMAdapter in the Rational® Functional Tester installation directory from the terminal, and then run the following command:
```
./configureadapter
```
The IBM Rational Functional Tester Adapter dialog box is displayed.

Complete the following steps from the Connection Information tab:

Enter the server URL of Engineering Test Management in the Server URL field.

Note: The URL that you enter in the Server URL field must match with the public URI of the Engineering Test Management server. You can view the public URI on the administrator page of the Engineering Test Management server.

Select the mode that you want to use to authenticate the connection with the Engineering Test Management server from the Authentication Type drop-down list.

You can select any of the options in the following table, and then complete the steps for that option:

Option

Description

Username and Password

You can establish the connection with the Engineering Test Management server by using the user ID and password.

Complete the following actions:


Field	Action
User ID	Enter the user ID that you use to log in to Engineering Test Management
Password	Enter the password that you use to log in to Engineering Test Management.
Project area	Select the required project area in the Engineering Test Management server from the drop-down list. Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established. Important: You must select the project from the drop-down list and not type the project name.
Save password	Select this option to save your Engineering Test Management password.

KERBEROS

You can establish the connection with the Engineering Test Management server by using the Kerberos initialization file (krb5.ini).

Complete the following actions:


Field	Action
Configuration File	Click Browse and select the krb5.ini file.
Project area	Select the required project area in the Engineering Test Management server from the drop-down list. Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established. Important: You must select the project from the drop-down list and not type the project name.
Save password	Select this option to save your Engineering Test Management password.

SSLCERT

You can establish the connection with the Engineering Test Management server by using an SSL certificate.

Complete the following actions:


Field	Action
Certificate Location	Click Browse and select the SSL certificate. Note: The certificate must be a .p12 file.
Password	Enter the password that you use to log in to Engineering Test Management.
Project area	Select the required project area in the Engineering Test Management server from the drop-down list. Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established. Important: You must select the project from the drop-down list and not type the project name.

SMARTCARD

You can establish the connection with the Engineering Test Management server by using a smart card.

Notes:

Smart card authentication is only available in Windows operating systems.
The computer must be connected to the smart card reader before you select this option. You must also insert the smart card into the smart card reader. Rational® Functional Tester reads the aliases from the smart card and prompts for the smart card PIN when the adapter connects to Engineering Test Management.

Complete the following actions:


Field	Action
Certificate Location	Select the smart card certificate from the drop-down list.
Project area	Select the required project area in the Engineering Test Management server from the drop-down list. Note: This field is populated with the project names that are on the Engineering Test Management server and the project names are displayed after the connection is established. Important: You must select the project from the drop-down list and not type the project name.

Enter the adapter name in the Adapter Name field.
Click Apply.

Click Start Adapter to start the connection between Rational® Functional Tester and Engineering Test Management.

Note: You can view the status of the connection by clicking the Adapter Console tab. You can stop the connection by clicking Stop Adapter.