Home
Administrator Guide
This guide describes how to install HCL OneTest™ API. After you install the software, you can perform administration tasks such as configuration and integration of the product. This guide is intended for administrators.
Administering HCL® Quality ServerHCL® Quality Server
is a server-based web application providing a central repository for virtualized services. The HCL® Quality Server allows you to use virtual services published with HCL OneTest™ API to create, share, and deploy virtualized test environments in HCL OneTest Virtualization.
Managing domains
How to create and manage domains in HCL® Quality Server.
Modifying domains
This topic explains how to modify domains.
Modifying HCL OneTest™ Virtualization project results database settings
This topic explains how to modify HCL OneTest™ Virtualization Project Results Database settings.

Administrator Guide
This guide describes how to install HCL OneTest™ API. After you install the software, you can perform administration tasks such as configuration and integration of the product. This guide is intended for administrators.
- Installation of HCL OneTest™ API
  You can find information about installing HCL OneTest™ API from the HCL OneTest Studio or HCL OneTest API package.
- Installation of HCL® Quality Server
  You can find information about installing HCL® Quality Server from the HCL OneTest™ Studio, HCL OneTest Virtualization, or HCL OneTest API package.
- Uninstalling the product software
  When you no longer require the software, you can use either Installation Manager or the stand-alone installer to uninstall the products that you have installed.
- License management
  Licensing for your HCL software is administered through HCL® License & Delivery portal. This portal is FlexNet-based web application to manage software entitlements and licenses.
- Configuration of HCL OneTest™ API
- Administering HCL® Quality ServerHCL® Quality Server
  is a server-based web application providing a central repository for virtualized services. The HCL® Quality Server allows you to use virtual services published with HCL OneTest™ API to create, share, and deploy virtualized test environments in HCL OneTest Virtualization.
  - Configuring HCL® Quality Server
    You might need to configure the HCL® Quality Server after the application is installed.
  - Getting started
    Start using the HCL® Quality Server.
  - Task flow: Working with the HCL® Quality Server Environments dashboard
    You can use the HCL® Quality Server Environments dashboard to perform various tasks such as starting, stopping stubs and scenarios, and modifying stub configurations after you have published stubs to HCL Quality Server. You can also lock the environment that contain the published stubs.
  - Task flow: Working with the HCL® Quality Server Infrastructure dashboard
    You can use the HCL® Quality Server Infrastructure dashboard to perform administrative tasks such as viewing agents and proxies registered with HCL Quality Server.
  - Task flow: Working with the HCL® Quality Server Network dashboard
    You can use the HCL® Quality Server Network dashboard to perform administrative tasks such as viewing recording or routing rules configured for agents and proxies.
  - Managing users
    HCL® Quality Server has multiple choices associated with its security model. Depending on the security option selected during installation of the HCL Quality Server, different options are available based on the user accounts.
  - Managing domains
    How to create and manage domains in HCL® Quality Server.
    - Creating domains with HCL® Quality Server method
      This topic explains how to create domains using the HCL® Quality Server method.
    - Creating domains with the HCL OneTest™ API method
      You can create domains by using the HCL OneTest™ API method.
    - Adding and removing domain privileges
      If domain-level security is enabled in HCL® Quality Server and you are a HCL Quality Server system or domain administrator, you can assign domain user, domain API user, or domain administrator privileges to other server users.
    - Modifying domains
      This topic explains how to modify domains.
      - Renaming domains
        This topic explains how to rename domains.
      - Modifying HCL OneTest™ Virtualization project results database settings
        This topic explains how to modify HCL OneTest™ Virtualization Project Results Database settings.
        Modifying database settings
        Only an HCL® Quality Server administrator can set up and modify HCL OneTest™ Virtualization project results databases.
      - Deleting stubs
        This topic explains how to delete stubs.
    - Deleting domains
      This topic explains how to delete domains.
  - Working with HCL® Quality Server dashboards
    You can filter, search, sort, and choose the number of items to be displayed in HCL® Quality Server dashboards.
  - Viewing the state of stubs that are published to HCL® Quality Server
    When you as an administrator of HCL® Quality Server want to view the state of stubs that are published to HCL Quality Server, you can use the script provided with the product installation package. You can use this information to manage projects in HCL Quality Server.
  - Deleting environments
    This topic explains how to delete environments.
  - Agent and Proxy administration
    Use HCL® Quality Server to view and control any of the HCL OneTest™ API agents or proxies.
  - Viewing HCL® Quality Server logs
    If you are an HCL® Quality Server administrator, you can view the audit, activity, and diagnostic logs of HCL Quality Server.
  - Viewing reports in HCL OneTest™ Server
    All the project stakeholders can view test reports for multiple testing products from the Results page on HCL OneTest™ Server. You can access the Results page from a web browser. Therefore, there is no need to install the desktop client.
  - Configuring stubs to connect to HCL® Quality Server and the HTTP proxy
    A stub running on its own may not be sufficient in some cases, because it might have dependencies on services such as HCL® Quality Server or the HTTP proxy. If the stub is running on the public cloud and the services are running in the enterprise, you must configure the stub to connect to these services.
  - Troubleshooting: HCL® Quality Server
    You can use workarounds to troubleshoot common problems that you might encounter when you use HCL® Quality Server.
- Integrations
  HCL OneTest™ API supports integration with various other tools for quality management, change management, software configuration management, and deployment automation tools such as UrbanCode™ Deploy or HCL® Launch.

Modifying HCL OneTest™ Virtualization project results database settings

This topic explains how to modify HCL OneTest™ Virtualization Project Results Database settings.

Stubs that are run in HCL OneTest™ Virtualization can log information to a project results database. (The log level is configurable.) Logging is most useful when stubs are being designed in HCL OneTest™ API but it can also be useful after a stub has been published to ensure that it is working correctly.

The following topics discuss why you might want to modify project results database settings and describe how to modify the settings at domain level.

Note: Project results databases cannot be defined at environment level.

Reasons for modifying database settings

When a stub is being designed and run within HCL OneTest™ API, it logs to HCL OneTest™ API Console output and to the configured project results database. This enables HCL OneTest™ API users to use the Results Gallery perspective to analyze the stubs output. If there is no configured results database, the stubs output can be viewed only in HCL OneTest™ API Console output.

When a stub is published, the project results database settings is published with it. The stubs initial log level in HCL OneTest™ Virtualization is selected in HCL OneTest™ API at the point when it is published but this can be overridden when the stub is started.

If the stub is configured to log, in the absence of any other configuration values, the stub will attempt to connect back to the project results database defined in the HCL OneTest™ API/HCL OneTest™ Virtualization project if such a database was defined.

Whether a project database exists depends on the stubs required behavior. A project results database may not have been defined, so stub logs will be available only on the Console output of the agent(s) where they are running.

Alternatively, a project results database may have been defined but it can be running on a computer that cannot be accessed by HCL OneTest™ Virtualization. In addition, if multiple stubs are published to a single domain with different project results databases, the logs will be split across those databases.

Therefore, it is possible to configure a single project results database to for all stubs within a domain. After configuring such a database, all stubs running in that domain will use that database for their logs.