Installing HCL OneTest™ API Agent in the console mode

You can install HCL OneTest™ API Agent by using the command line on a console.

Before you begin

You must have installed Installation Manager. For information about installing Installation Manager, see Installing and using Installation Manager in the Installation Manager Knowledge Center.

You must download and extract the HCL OneTest™ API Agent installation image from IBM Passport Advantage to a temporary directory. This directory containing the image gets added as a repository to Installation Manager.

About this task

You can install HCL OneTest™ API Agent in the console mode. In console mode installation, the graphical installation wizard is replaced by options displayed in the command line interface. The options are presented as a numbered list or as shortcut keys. Review the options and enter a number or a shortcut key to select an option and to navigate to the next option. For more information about console mode installation, see Working in console mode in the Installation Manager Knowledge Center.

Procedure

  1. From the command line, go to the Installation Manager tools directory:
    1. On Windows systems the location can be:

      C:\Program Files [(x86)]\IBM\Installation Manager\eclipse\tools

    2. On Linux systems the location can be:

      /opt/IBM/InstallationManager/eclipse/tools

  2. Run the following command to start Installation Manager in console mode:
    1. On Windows systems, run:

      imcl.exe -c

    2. On Linux systems, run:

      ./imcl -c

    The following steps are common for the Windows and Linux systems.
  3. To add the HCL OneTest™ API Agent repository to Installation Manager, complete the following steps:
    1. Enter P to select the preferences option.
    2. Enter 1 to select the repositories option.
    3. Enter D to add a repository.
    4. Enter the location of the configuration file. For example, it can be:

      C:\TEMP\Agent_SETUP\disk1\diskTag1.inf in Windows

      /root/tmp/Agent_SETUP/disk1/diskTag1.inf in Linux

    5. Enter A to apply changes.
    6. Return to the installation menu.
  4. Enter 1 to install the software packages.
    The software packages that you can install are displayed along with the option to enter to select the required package.
  5. Enter the number for the HCL OneTest™ API Agent package.
  6. Enter the option to select the version of HCL OneTest™ API Agent to install.
  7. Verify that the HCL OneTest™ API Agent package is selected, then enter N.

    You can read the license agreement by entering A. Follow the instructions on the screen to return to the install menu. Continue to the next step.

  8. Enter 1 to accept the license agreement.
  9. Verify that the acceptance of the license agreement is selected, then enter N to continue to the next step.
  10. Enter N to continue to the next step.
    If you want to modify the location of the Shared Resources Directory, follow the instructions on the screen to enter the location of the Shared Resources Directory and return to continue with the installation.
  11. If you want to change the location of the installation location, follow the instructions on the screen, else enter N to continue with the installation.
  12. Select the translation language if you want to install other than the default selected, else enter N to continue with the installation.
  13. Continue to enter N on the command prompt to proceed with the installation task.
  14. Select the option from the displayed list to configure the licensing operation of HCL OneTest™ API Agent.
    The selection of the mode depends on the type of license you have procured for your product.
  15. Enter N on the command prompt to proceed with the installation task.
  16. Enter I to install the software package.
    If you want to generate an Installation response file, follow the instructions on the screen and return to continue with the installation.

    The installation progress is displayed.

  17. Enter F to complete the installation task.

    You can view the message details of the installation procedure by selecting the option displayed.

Results

You have installed HCL OneTest™ API Agent by using the command line on a console.

What to do next

If you have installed HCL OneTest™ API Agent before you have installed HCL® Quality Server, you must proceed to install HCL® Quality Server and then configure it so that HCL OneTest™ API Agent can connect to HCL® Quality Server.

If you have installed HCL OneTest™ API Agent on a system that does not support a GUI, you must generate a configuration file to use with Library Manager. See Generating a configuration file for HCL OneTest API for the instructions.