Welcome
Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
Test assets and a server project
HCL OneTest™ Server projects manage access to your test assets, which are stored in a Git repository. Projects are maintained in a team space. 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 assets and resources available in the respective repository.

Release Notes
This document includes information about What’s new, installation and upgrade instructions, known issues, and contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL OneTest™ Server.
Getting Started Guide
This guide provides an overview of HCL OneTest™ Server. You can find the task flows to get you started with HCL OneTest Server. This guide is intended for new users.
Administrator Guide
This guide describes how to install HCL OneTest™ Server software.
Test Author Guide
This guide describes how to create test assets in HCL OneTest™ Server and publish test assets to the Git repository that you have configured. This guide is intended for testers and test managers.
Test Execution Specialist Guide
This guide describes tasks that you must complete before you can configure and run tests in HCL OneTest™ Server. You can find information about configuring runs for the different test types that are supported. You can also find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications. This guide is intended for testers or test execution specialists.
Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
- Team space management
  You might want to become a team space member, add members to your team space, change a user role in a team space, modify the team space, or delete a team space.
- Test assets and a server project
  HCL OneTest™ Server projects manage access to your test assets, which are stored in a Git repository. Projects are maintained in a team space. 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 projects in a team space
    After you log in to HCL OneTest™ Server, you must have a project to perform the test activities. To work with projects, you must create and configure projects.
  - 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 a project
    The first step is to add a project and provide some details about it.
  - Adding repositories to a server project
    You can add repositories to a server project to access assets and resources 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 HCL OneTest™ Server.
  - Adding users to a project
    You can add users to your server project so they can access your test assets.
  - Viewing projects
    After you log in to HCL OneTest™ Server, you can view the existing projects in the Initial Team Space.
  - 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.
- Managing repositories
  After you create a project in HCL OneTest™ Server, you can add repositories that contain test assets and resources to the project. You can also change the repository details, update the user credentials of a repository, delete a repository, create a webhook for the configured repository.
- Protecting API test assets by using secrets
  Secrets are key-value pairs that are created for your project in HCL OneTest™ 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 HCL OneTest 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.
Troubleshooting Guide
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL OneTest™ Server.
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
This document describes the actions that you can take to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Adding repositories to a server project

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

Before you begin

You must have completed the following tasks:

Added a project on HCL OneTest™ 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.

Procedure

Log in to HCL OneTest™ Server and open the team space that contains your project.
Open your project, and then click Manage.
Click the Repositories tab.
Click Add Repository.

The Add Repository dialog box is displayed.
Enter the URL of the Git repository that you want to add to your project in the Git Repository field.

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 HCL OneTest™ Server displays an Auth Fail exception while using the deliver changes option, you can resolve this exception error by regenerating your SSH keys by using the -m PEM option.

Click Add.

The Git repository is added to your project in the team space.
Note: Depending on the size of the repository that 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.
Refresh a repository to fetch and synchronize changes from the remote repository.
Configure a webhook to notify the server when there is a push event in the remote repository.