Installing DevOps Test Integrations and APIs Agent by using the launchpad program

You can use the launchpad program to install IBM® DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) when you want to use the IBM DevOps Test Virtualization (Test Virtualization) or IBM DevOps Test Performance Test Server (Test Performance Test Server) package.

You must have completed the following tasks:
  • 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 selecting the wrong license mode will cause the agent to not work. For information about the license modes, see Licenses for DevOps Test Virtualization.
  • Review the information in Installation planning for DevOps Test Integrations and APIs Agent, if you are uninstalling an older version and installing a new version.

Download all 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.

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.
  1. 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.

      • For Windows. launchpad.exe or launchpad64.exe (for 64-bit systems)
      • For Linux. launchpad.sh
  2. Open the location on your computer where you downloaded the software package.
  3. Open the launchpad application.
  4. Select the operating system on which you want to install the software.
  5. Select a language in which to run the launchpad and Installation Manager.
  6. Select IBM DevOps Test Virtualization (Test Virtualization) from the launchpad menu. The Install Packages window opens.
  7. Select the Launch the IBM Installation Manager option.

    The IBM Installation Manager installation dialog is displayed with all products in the package as selected for installation.

  8. 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:
    • IBM DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent)
    • IBM DevOps Test Virtualization Control Panel (Test Virtualization Control Panel)

    To view all updates that are found for the available packages, click Show all versions.

    Note:
    For Installation Manager to search the predefined IBM 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.
  9. Select the product package and any updates to the package to install. Updates that have dependencies are automatically selected and cleared together. Click Next.
  10. 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.
  11. 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.
  12. Select the translation packages to install, and then click Next.
  13. 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.
  14. Select from the following options that depend on the server with which you want to register the agent:
    • To register the agent with IBM DevOps Test Virtualization Control Panel (Test Virtualization Control Panel), go to Step 15.
    • To register the agent with IBM DevOps Test Hub (Test Hub), go to Step 16.
  15. Perform the following steps when you want the agent to register with Test Virtualization Control Panel:
    1. Enter the URL of the Test Virtualization Control Panel instance.
    2. Enter the username and password for the Test Virtualization Control Panel server.

      This step is applicable only if you configured Test Virtualization Control Panel for security.

    3. 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.
    4. Go to Step 17.
  16. Perform the following steps when you want the agent to register with Test Hub:
    1. Enter the URL of the Test Hub instance.

      The Test Hub option is displayed as selected.

    2. Enter the team space alias or id in the Team Space field.
    3. Enter the Offline user token that you generated on Test Hub in the Security Token field.
    4. Click Next.
    5. Go to Step 17.
  17. Review the server configuration, and then click Next.
  18. Select your action based on the descriptions for the options displayed:
    Option Description
    Run as Local Service Runs Test Integrations and APIs Agent as a service.
    Run as existing user Runs Test Integrations and APIs Agent with a user authenticated with a user name and password.
    Note:
    You must provide a user name and a password.
  19. Click Next.
  20. Select the bundle that the agent is to be installed. Make the selection based on the capability and the licensing model that you want to use.
    • If you are using the agent for service virtualization with PVU licenses, select the DevOps Test Virtualization (PVU mode) option.
    • If you are using the agent for service virtualization with token licenses, select the DevOps Test Virtualization (Simultaneous Session mode) option.
    • If you are using the agent for service virtualization with concurrent virtual services token licenses, select the DevOps Test Virtualization (CVS mode) option.
    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.
  21. Click Next.
  22. Click Install to install the package.

    A progress indicator displays the progress of the installation.

  23. Select your action from the following options:
    • Retain the Library Manager (Agent) option, and then click Finish to open the Library Manager.
    • Click the None option, and then click Finish to close the installation window.

You have installed Test Integrations and APIs Agent.

You can perform the following tasks: