Release Notes
This document includes information about What’s new, installation and upgrade instructions, known issues, and contact information of HCL Customer Support.
Known issues
You can find information about the known issues identified in this release of HCL OneTest™ Server.
Getting started guide
This guide, which is intended for new users, provides an overview and some task flows to get you started with Rational® Test Automation Server.
Server overview
IBM® Rational® Test Automation Server brings together test data, test environments, and test runs and reports into a single, web-based browser for testers and non-testers.
Task flow: Test runs and results
You can use the task flow diagram to get started with IBM® Rational® Test Automation Server. After you install the software, you can complete the tasks in sequence to run test assets in Rational Test Automation Server and view and analyze the test results.
Accessibility features
Accessibility features help users who have physical disabilities, such as visual and, hearing impairment, or limited mobility, to use the software products successfully.
Administrator guide
This guide, which is intended for an administrator, describes how to install IBM® Rational® Test Automation Server software. After you install the software, you can administer the server. Administration tasks can include License configuration, User management, Security, Memory and disk usage management, Backup and restore user data.
Installation of Rational® Test Automation Server
To get started with IBM® Rational® Test Automation Server, you must first install the server software.
Backing up and restoring the user data
You might want to restore an earlier environment state if you install a new version of Rational® Test Automation Server, move environments to different systems (both real and virtual), or set up a test environment ready for testing. To address any of these needs, you can back up and restore Rational Test Automation Server user data installed either on Ubuntu or on Red Hat OpenShift platform.
Uninstallation of the server software
When you no longer require HCL OneTest™ Server, you can uninstall the server software. You can uninstall the server software depending on the platform on which you installed the server software.
Configuration of the server software
You can find information about the tasks that you must perform after you installed the server software to configure HCL OneTest™ Server.
Licensing
You can purchase named user licenses for Rational® Test Automation Server and install the licenses on the FlexNet Operations server.
This guide, which is intended for a tester and test manager, describes how to create test assets in Rational® Test Automation Server and publish test assets to the Git repository that you have configured.
Datasets overview
A dataset provides tests with variable data during a run. The test that uses a dataset at run time replaces a value in the recorded test with variable test data that is stored in the dataset.
Generation of test data
To test an application, you use data that is passed to get real-time results. Since creating test data manually is time-consuming, you can use HCL® OneTest™ Data, an automated tool to generate random test data. You can generate the test data in various file formats.
Test Execution Specialist guide
This guide, which is intended for a tester or a test execution specialist, describes tasks that you must complete before you can configure and run tests on Rational® Test Automation Server. You can find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications.
Prerequisites to running tests
Before you can configure and run a test in a project on Rational® Test Automation Server, you must read the information about the different tests. You might want to add a remote static agent or a remote Docker host to the project as an alternate location to run the tests.
Managing Docker hosts
You can set up dedicated external Docker hosts to run large tests or run tests remotely to free up the dependency of running tests on the internal Docker host of IBM® Rational® Test Automation Server.
Test run configurations
You can configure and run tests in IBM® Rational® Test Automation Server after you add the test resources to your project.
Management of running tests
Find information about the tasks that you can perform on a test that you configured for a run either while it runs or after it completes the run.
Management of virtualized services
You can find information about the tasks that you can perform and manage on the virtualized services that run on Rational® Test Automation Server. You can start or stop the stubs connected to Rational Test Automation Server. You can view the stub usage statistics and the routing rules configured for the stubs, agents, or proxies that are connected to Rational Test Automation Server.
Test results
After the tests or schedules are run and completed, you can view the results and reports in IBM® Rational® Test Automation Server to analyze the verdict, the performance, and statistics. You can also re-execute tests and schedules from the Result page with the same commit id.
Resource Monitoring service
When you apply load to a system under test, the amount of resources consumed by your system is increasing. If the capacity of the resources does not match the load, you can see performance issues in the results. The Resource Monitoring service in Rational® Test Automation Server helps you monitoring the resources of a system and establish the performance metrics of the system. Thus, you can observe the health of these resources while a schedule is running.
Integrating with other applications
You can integrate certain applications with IBM® Rational® Test Automation Server to run tests and view the test results.
Managing access to the server
Desktop clients and third-party integrations use offline user tokens to connect to Rational® Test Automation Server.
Test Manager guide
This guide, which is intended for a test manager, explains how to manage and track your overall test effort.
Test assets and a server project
Rational® Test Automation Server projects manage access to your test assets, which are stored in a Git repository. Projects are either public by default or private. Private projects are not discoverable by other users. You can either add your own project or you can request to be a member of another public project.
Working with Git repositories
You can add another repository in addition to the existing repositories in your project or edit the repository settings, by updating the credentials, or by removing references to the repository.
Protecting API test assets by using secrets
Secrets are key-value pairs that are created for your project in IBM® Rational® Test Automation Server under a secrets collection. You can create secrets collections for your project that enable you or members in your project to use secrets at test runtime either in Rational Test Automation Server or in desktop clients.
Managing an encrypted dataset
You can use encrypted datasets to limit access to confidential information such as account number or passwords. You can arrange data by an appropriate category so that project members can use datasets more effectively in certain tests and protect them.
Managing notifications
HCL OneTest™ Server provides a feature to display notifications for different events within the user interface (UI) of HCL OneTest Server. You can configure an SMTP server on HCL OneTest Server when you want HCL OneTest Server to send out notifications about the different events as emails to the subscribed users.
Reference Guide
This guide describes conceptual information about data design environment components when you want to use the data fabrication feature in HCL OneTest™ Server.
Files
You add a file to a project to use it as input in the project. You can upload a file from your local file system to a project from the Files tab to generate test data. Alternatively, you can upload it when you define an action.
Connections
A connection defines the properties that are required to connect to an external resource. An action uses a connection to provide source data to a project or write data from a source to a target. Multiple actions can use the same connection. You can define both connections and actions at the project level.
Schema design
A schema is a graphical data dictionary that contains metadata definitions of the structure of a document to generate test data. Schema provides visual cues for understanding the structure and complete definition of an object.
Troubleshooting Rational® Test Automation Server
While working with Rational® Test Automation Server, you might encounter some problems that you can easily troubleshoot.
Troubleshooting issues
You can find information about the issues or problems that you might encounter while working with Rational® Test Automation Server. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.
Troubleshooting
You can troubleshoot some of the common problems that you might encounter when you use HCL® OneTest™ Data.
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL OneTest™ Server as a PDF file.
Security considerations
For Rational® Test Automation Server, you can take actions to ensure that your installation is secure, customize your security settings, and set up user access controls.