Migration of test assets from the earlier versions

You can migrate all test assets from the earlier versions of IBM® DevOps Test UI (Test UI), including projects, scripts, object maps, and verification points. The test assets from the earlier versions work with the current version of Test UI.

Upgrade of the workspace and test assets

You must back up the test assets before you upgrade them to the new version of Test UI. You can export the workspace as a compressed (.zip) file and import the file in the newer version of Test UI if there are any issues in using the migrated workspace.

After you install a newer version of Test UI and choose to open the UI from an old workspace, Test UI prompts you to update all the test assets in the workspace.

You can click Continue to update the workspace. If you find errors when you open a workspace from a different version of Test UI, you can click Window > Reset Perspective to reset the perspective.

Also, when you modify and save the tests, the tests migrate automatically to the current version.

When you open a project that contains an older test asset, a message is displayed in the Test Navigator view as shown in the following screen capture:
Upgrading test assets

You must click the Click here link to upgrade your test assets.

Note: You must not open a migrated test project with a previous version of Test UI. Tests that you record with the current version of Test UI do not play back on earlier versions.

Installation and uninstallation

When you want to uninstall the previous version of Test UI and then install the latest version, you must install the latest version in the same folder that contained the previous version. Thereby, you can avoid compilation errors in the project in the latest version.

Note: You cannot have two versions of Test UI installed on your computer at one time. Before you install a new version, uninstall the previous version of Test UI. If you update Test UI with IBM Installation Manager, you do not have to uninstall the previous version. When you uninstall the previous version, the test assets are not deleted.

Upgrade of the reports

A new release might include enhancements to the default reports. When you upgrade test assets, reports also get updated to the latest version, and as a result, you lose modifications that you have made to the reports.

Java environments Enabler in the Functional Test perspective

Test UI is bundled with Java 17, and by default, the Java environment is enabled for testing Java applications.

You can configure JREs for testing Java only when the application under test is a Java-based application that requires a Java distinct from the Java which is bundled with the product. The configured Java provides path, run options, and other information that IBM DevOps Test UI (Test UI) needs to access and use your JREs.

You can click Configure > Enable Environments for Testing in Test UI menu to run the Enabler. For more information on using the Enabler, see Enabling Java™ Environments.

Migration of functional test assets from earlier versions

All functional test assets from earlier versions of Test UI, including projects, scripts, object maps, and verification points, work with the current version of Test UI. However, scripts that you record with the current version of Test UI do not play back on earlier versions. When you play back a script that was recorded with a previous version, a warning message is displayed in the log file. To view the log file without the warning message, you must disconnect the project, and connect again. For more information on connecting and disconnecting projects, see Connecting to a functional test project and Disconnecting a functional test project.

Migration of workspace, configuration file, and customization files to 11.0.0 from the earlier versions

If you were using 10.5.4 or an earlier version of Rational® Functional Tester and you have now migrated to the current version of Test UI, then you may want to reuse the workspace, configuration file, and customization files from the older version. As there is a significant change in the paths after renaming of the product, you must consider the following points to migrate the workspace, configuration file, and customization files to the current version of Test UI:


If you want to..	Do this..
Copy the application configuration details	Windows: Copy the application configuration details for the Functional Test perspective in the configurations.rftcfg file from C:\ProgramData\IBM\RFT\configuration in 10.5.4 or an earlier version to C:\ProgramData\IBM\DTUI\configuration in 11.0.0. Linux: Copy the application configuration details for the Functional Test perspective in the configurations.rftcfg file from /etc/opt/IBM/RFT/configuration in 10.5.4 or an earlier version to /etc/opt/IBM/DTUI/configuration in 11.0.0. See Copying application configuration.
Copy the customization files	Windows: Copy the dependant jar files from the C:\ProgramData\IBM\RFT\customization in 10.5.4 or an earlier version to C:\ProgramData\IBM\DTUI\customization in 11.0.0. Linux: Copy the dependant jar files from the /etc/opt/IBM/RFT/customization in 10.5.4 or an earlier version to /etc/opt/IBM/DTUI/customization in 11.0.0.
Use the workspace from older versions	Select the workspace from the older version by clicking File > Switch Workspace > other.. in Test UI. or Windows: Copy C:\Users\<user_name>\IBM\rationalsdp\workspace in 10.5.4 or an earlier version to C:\Users\<user_name>\IBM\devopstest\workspace in 11.0.0. Linux: Copy /home/<user_name>/IBM/rationalsdp/workspace in 10.5.4 or an earlier version to /home/<user_name>/IBM/devopstest/workspace in 11.0.0. macOS: Copy /Users/<user_name>/IBM/rationalsdp/workspace in 10.5.4 or an earlier version to /Users/<user_name>/IBM/devopstest/workspace in 11.0.0.