Home
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.
Adding repositories to a server project
You can add repositories to a server project to access the test assets available in the respective repository.

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.
  - Repository considerations for a server project
    To collaborate with other project stakeholders, you can open test assets from a local clone of the Git repository, pull project test assets from a Git repository, and push changes made to your local test assets to a Git repository. Before you add a project and add a repository to that project, you must consider some information about repositories.
  - Adding details to a server project
    The first step is to add a server project and provide some details about it.
  - Adding repositories to a server project
    You can add repositories to a server project to access the test assets available in the respective repository.
  - Secrets configuration
    If you are working with an API suite and the project test asset contains environment variables that are required for the test runs, you must configure the environment variables as secrets in a secrets collection by using the Secrets tab. Configuring secrets enable the API suite to run correctly on Rational® Test Automation Server.
  - Adding users to a server project
    You can add users to your server project so they can access your test assets.
  - Becoming a project member
    You might want to request to be a member of another project. New users without any projects might also want to be a member of an existing project.
  - Managing access to server projects
    You might want to add or remove a project member role from your project.
  - Archiving or unarchiving server projects
    You can archive a project when that project is no longer needed but you want to retain it for future reference. If you do want to use an archived project, you can unarchive it.
  - Deleting server projects
    You might want to delete a project when the project is no longer needed, and you want to free up disk space.
  - Project overview
    After you configure a project with one or more Git repositories and run some test assets, you can view statistics about those test assets.
- 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.

Adding repositories to a server project

You can add repositories to a server project to access the test assets available in the respective repository.

Before you begin

You must have completed the following tasks:

Added a project on IBM® Rational® Test Automation Server.
Been granted permission to access the repository.

About this task

As a project owner or a tester, you can add one or more repositories to your project. When you add a repository, the Git repository is cloned to your project. While adding a repository, you must provide the necessary authentication credentials that are set for the Git repository that you want to add to your project. For example, if the authentication type is SSH, then you must provide the Git URL, a deploy key, and a passphrase.

After you log in, from the Home page, you can add one or more repositories to your project by following these steps.

Procedure

Open your project.
Click the Repositories tab.
Click Add repository.

The Add repository page is displayed.
Enter the URL of the Git repository that you want to add to your project.

Click the Expand icon to enter the required credentials based on any of the following authentication methods configured in the repository.

To gain access to the repository, you must use any one of the authentication methods:


Authentication method	Credentials required
SSH	Deploy key Passphrase
HTTPS	User name Password
HTTP	User name Password

Notes:

You must have defined the authentication type and set the authentication credentials in the Git repository.
If you use SSH to connect to your remote repository and IBM® Rational® Test Automation Server displays an Auth Failexception while using the deliver chnages option, you can resolve this exception error by regenerating your SSH keys by using the -m PEM option.

Click Add.

The Git repository is cloned on IBM® Rational® Test Automation Server.
Note: Depending on the size of the repository you are cloning, it can take a few to several minutes to clone the repository.
Optional: Repeat the steps to add another repository.

What to do next

You can perform the following actions on the repository that you added:

Update the authentication credentials if they are changed in the Git repository configuration.
Delete a repository if it is no longer required.