Home
Administrator Guide
This guide describes how to install HCL OneTest™ Performance. After you install the product, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Configuration of the product
You must configure HCL OneTest™ Performance when you want to run SAP tests, collect response time breakdown data, or use the product in the Docker container.
Configuring the data collection infrastructure
If you want to collect response time breakdown data from remote computers used in distributed applications, you must install and configure the data collection infrastructure on the remote computers.
Removing instrumentation using the command prompt
Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.

Administrator Guide
This guide describes how to install HCL OneTest™ Performance. After you install the product, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
- Installation of HCL OneTest™ Performance
  Installation of the product involves verifying requirements, planning, managing licenses, and configuring web-based help. This section lists all such topics.
- License management
  Licensing for HCL OneTest™ Performance is administered through HCL Software License & Download portal. This portal is a FlexNet-based web application that helps to manage software entitlements and licenses.
- Product upgrade and migration
  When you want to use the enhanced functionalities of HCL OneTest™ Performance, you must upgrade to the latest version of the product software.
- Configuration of the product
  You must configure HCL OneTest™ Performance when you want to run SAP tests, collect response time breakdown data, or use the product in the Docker container.
  - Configuring the environment for SAP tests
    Some of the capabilities of service tests require that you manually install additional libraries and files or that you configure some elements of the test environment.
  - Configuring the data collection infrastructure
    If you want to collect response time breakdown data from remote computers used in distributed applications, you must install and configure the data collection infrastructure on the remote computers.
    - Data collection infrastructure overview
      The data collection infrastructure collects performance profiling data for distributed applications and sends the data to the workbench computer, where you can view and analyze the collected data. The data collection infrastructure must be installed, configured, and running on all remote computers that will be used in your distributed application. The data collection infrastructure is installed when you install HCL OneTest™ Performance Agent.
    - Instrumenting local servers
      You must instrument application servers to collect response time breakdown data. You can use either a command-line or graphical user interface to instrument application servers to work with the data collection infrastructure.
    - Instrumenting servers by using the command prompt
      You must instrument application servers to collect response time breakdown data. You can use either a command prompt or graphical user interface to instrument application servers to work with the data collection infrastructure.
    - Removing instrumentation
      Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.
    - Removing instrumentation using the command prompt
      Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.
  - Configuring Docker containers
    Instead of reading through the system requirements list and installing the products, you can now deploy the Docker containers on any computer and get started with testing. To automate playing back tests, you can push the product images to the Docker container.
- Integration with other products
  You can integrate HCL OneTest™ Performance with certain products to run tests, manage test assets, and create defects.

Removing instrumentation using the command prompt

Before you uninstall the data collection infrastructure, you must remove instrumentation from all application servers that were instrumented to work with the data collection infrastructure.

Before you begin

If you have uninstalled the application server or removed an instance of the application server, you cannot use the instrumentation utility to remove instrumentation from the server. This situation will block the data collection infrastructure uninstall process. Do not uninstall an application server before you have removed instrumentation from the application server.

Instrumented servers are listed in the file InstrumentationRegistry.xml. After you have removed instrumentation from a server, the InstrumentationRegistry.xml file will be empty of references to any application server. If you uninstall an application server before you have removed instrumentation, to uninstall the data collection infrastructure you must edit InstrumentationRegistry.xml to remove the applicationServer element for the application server that you uninstalled.

Procedure

To remove instrumentation from application servers:

Open a command prompt, and change directories to the instrument_comp folder in the data collection infrastructure installation directory. By default, on Microsoft™ Windows™ this directory is C:\Program Files\HCL\HCLOneTest\DCI\rapa_prod\instrument_comp. On Linux™ and IBM® AIX®, this directory is /opt/HCL/HCLOneTest/DCI/rapa_prod/instrument_comp.
Type the command name with the -uninstall argument and all of the other arguments that you used when instrumenting the server.
The instrumentation utility, which is also used to remove instrumentation from servers, is instrumentServer.sh on AIX® and Linux™ systems and instrumentServer.bat on Windows™ systems. Enter the command name with no arguments to see the syntax details for the command.
Restart the server if prompted to do so.

What to do next

You can uninstall the data collection infrastructure.