Installing DevOps Test Integrations and APIs Agent

Follow these instructions to install HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) or the HCL DevOps Test Performance (Test Performance) Agent.

Before you begin

Review the available licensing modes for the agents. During the installation, you are required to select the license mode that you are using. You cannot change the license mode after the installation and if you select the wrong license mode, the agent might not work. For information about the license modes, see Licenses for DevOps Test Performance Test Server.
Review the planning information in Installation planning for DevOps Test Integrations and APIs, if you are uninstalling an older version and installing a new version.

Download all of the files required for the installation and extract them to a repository location in the recommended structure. After downloading the core installation packages, you must create repository locations that point to the disktag.inf file in each package. If there are multiple packages, you must create repository locations for each package. If a package contains multiple disks, create repository locations pointing to each disktag.inf file or supply the information when prompted during the installation.

About this task

This procedure also contains information related to software upgrades. Before proceeding with the installation, determine if the upgrade is applicable to the version that you are installing. You cannot directly upgrade Test Integrations and APIs Agent from any of the earlier versions to the latest version. You must uninstall the existing version and then install the latest version.

By starting the installation process from the launchpad program, Installation Manager is automatically installed if it is not already on your computer, and it starts preconfigured with the repository location of the product package. If you install and start Installation Manager directly, you must set repository preferences manually.

Procedure

Select the method to use to obtain the product software.
- The first method involves installing from compressed files, such as .zip or ISO files. Extract the files into a common directory. Extract the disk images to directories that are named /disk1, /disk2, and so on. Extract the Setup disk image to a directory that is named RPTS_SETUP. The Setup disk contains the launchpad executable program.
  - launchpad.exe and launchpad64.exe (for 64-bit systems)
  - launchpad.sh
- The second method involves installing from a CD. If you are running on Linux™, mount the CD drive.
  Insert the first product disk into your CD drive. If autorun is enabled on your workstation, the launchpad program starts automatically. Otherwise, start the launchpad program manually.
  - Run the launchpad.exe or launchpad64.exe (for 64-bit systems) command, which is in the root directory of the Setup disk installation image.
  - Run the launchpad.sh command, which is in the root directory of the Setup disk installation image.
Select a language in which to run the launchpad and Installation Manager.
Select HCL DevOps Test Performance (Test Performance) from the launchpad menu. The Install Packages window opens.
Optional: Alternatively, start an existing instance of Installation Manager and provide the location of the installation package as a repository:
1. In Installation Manager, click File > Preferences.
2. Click Add Repository Location and provide the path to the repository.config file (if it is a setup or launchpad package) or the disktag.inf file (if it is a core installation package) in the installation directory that you extracted.
Click each of the product packages to highlight them. The description of the package is displayed in the Details pane at the bottom of the window. If more information about the package is available, such as a readme file or release notes, a More info link is included. To fully understand the package that you are installing, review all information. The following packages are available:
1. HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent)
2. (Test Performance Test Server) Agent
To view all updates that are found for the available packages, click Show all versions.

Note: For Installation Manager to search the predefined HCL® update repository locations for the installed packages, the Search the linked repositories during installation and updates preference on the Repositories preference page must be selected. This preference is selected by default. Internet access is also required. A progress indicator shows that the search is taking place. You can install updates at the same time that you install the base product package.
Select the product package and any updates to the package to install. Updates that have dependencies are automatically selected and cleared together. Click Next.
On the Licenses page, read the license agreement for the selected package. If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements. Click Next.
On the Location page, the location of the package group into which each product is installed is displayed. Click each product to see its package group location. Optionally, you can enter another location for the package group in the Installation Directory field. Click Next.
Select the translation packages to install, and then click Next.
On the Features page, select the package features to install.
1. To see the dependency relationships between features, select Show Dependencies
2. Click a feature to view its brief description under Details.
3. Select or clear features in the packages. Installation Manager automatically enforces any dependencies with other features and displays updated download sizes and disk space requirements for the installation.
4. When you are finished selecting features, click Next.
Specify the following configuration information for the products that you are installing.
For Test Integrations and APIs Agent
- Enter the URL of the Test Virtualization Control Panel instance that you want to register the agent with.
  Note: Test Virtualization Control Panel runs stubs on agents. Agents can also be used to run scheduled tests. During the installation of Test Integrations and APIs Agent, the agent is configured to register with Test Virtualization Control Panel instances so that they are available for stubs and/or running scheduled tests. You can modify this information after the installation. For more information, see Registering DevOps Test Integrations and APIs Agent with DevOps Test Virtualization Control Panel.
- Enter the username and password for the Test Virtualization Control Panel server. This applies only if you have configured Test Virtualization Control Panel for security. Click Next.
  Note: A connection token for the specified user name is created. This token can be then be used if domain-level security is enabled in Test Virtualization Control Panel.
- Select how you want to run the agent on Windows computers. Select the Run as Local Service radio button to run the agent as a service. Select the Run as existing user to run the agent with a user. Enter the user name and password. Click Next.
- Select the bundle that the Agent is to be installed with. Make the selection based on the capability that you want to use and the licensing model that you are using.
  - If you are using the agent for performance testing with PVU licenses, select the DevOps Test Performance Test Server (PVU mode) radio button
  - If you are using the agent for performance testing with token licenses, select the DevOps Test Performance Test Server (Simultaneous Session mode) radio button
  - If you are using the agent to only run probes, you do not require any licenses. Select the This Agent will only run probes radio button.
  Attention: Agent mode enables support for token licensing. Select this option only if you have purchased token licenses. Contact the support team to check your entitlement if required.
For Test Performance Agent
- Enter the hostname and port for the Test Performance Workbench host that the agent supports. Click Next.
- Select the bundle that the Agent is to be installed with. Make the selection based on the capability that you want to use and the licensing model that you are using.
  - If you are using the agent for performance testing with PVU licenses, select the DevOps Test Performance Test Server (PVU mode) radio button
  - If you are using the agent for performance testing with token licenses, select the DevOps Test Performance Test Server (Simultaneous Session mode) radio button
  - If you are using the agent to only run probes, you do not require any licenses. Select the This Agent will only run probes radio button.
  Attention: Agent mode enables support for token licensing. Select this option only if you have purchased token licenses. Contact the support team to check your entitlement if required.
- Select the installation type, access list and security model. Click Next.
On the Summary page, review your choices before you install the product package. Click Install to install the package. A progress indicator shows the percentage of the installation that is completed. When the installation process is complete, a message confirms the completion of the process.
Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
In the Install Package wizard, select whether to start the product when you exit.
Click Finish to start the selected package. The Install Package wizard closes and you are returned to the launchpad program.

Results

The product software is installed.

What to do next

In step 11, if you installed or upgraded the agent software and selected the Agent mode option to enable support for token licensing, you must configure the agent to point to a single domain. Then, start the agent.