Installing HCL® Quality Server by using IBM® Installation Manager

You can use IBM® Installation Manager to install HCL® Quality Server from the HCL OneTest™ Studio, HCL OneTest™ Virtualization, or HCL OneTest™ API package.

Before you begin

You must have completed the following tasks:

Procedure

  1. Open IBM® Installation Manager on your computer.

    The IBM® Installation Manager dialog is displayed.

  2. Add repositories to point to the location of the extracted installation files in Installation Manager by clicking File > Preferences > Repositories.
  3. Click Apply and then OK for Installation Manager to use the selected repository.
  4. Click Install to start the installation.

    The IBM® Installation Manager install packages dialog is displayed.

  5. Clear or retain the products selected for installation. Ensure that you select HCL® Quality Server to be installed.

    If you already installed an earlier version of the product, you are prompted about the existing installation and you need to opt if you want them to be upgraded to the version you downloaded. Updates that have dependencies are automatically selected and cleared together.

    To view all updates that are found for the available packages, select Show all versions and click Check for Other Versions, Fixes, and Extensions. You require your HCL® License & Delivery portal login credentials to view and install any newer packages or updates to the selected version of the software.

  6. Click Next.
  7. Read the license agreement for HCL® Quality Server, and then click I accept the terms in the license agreement.
  8. Click Next.
  9. Select the package group into which HCL® Quality Server is to be installed and either retain the default location or enter the location where the installation files are created.

    The shared resources directory is the location to which installation artifacts that can be used by one or more package groups are written. To change the shared resources directory, uninstall all the installed packages and then reinstall them in to the new directory location.

  10. Click Next.
  11. Select the translation packages to install, and then click Next.
  12. For Windows. On the Features page, select HCL Quality Server and the HTTP/TCP Proxy features to install. To install HCL® Quality Server or HTTP/TCP proxy as a service and start it whenever the computer boots, select the options Install as Service and select the Start on boot option.
    Note: To set up multiple proxies or to install the proxy behind a certain firewall so that the software under test can connect to it, install the HTTP/TCP component on a computer that is different from the location where you install HCL® Quality Server. You must also run the installer on that computer and select only the HTTP/TCP proxy component.
  13. If you are installing HCL® Quality Server, enter the following information in the HCL® Quality Server Configuration Panel and click Next.
    1. In the Standard Configuration page, enter the HCL® Quality Server HTTPS Port where HCL® Quality Server listens for all communications. The default port is 5443 and is provided for you.
      Note: You can change the port number after installation and also enable plain HTTP.
    2. Enter the path to the HCL® Quality Server workspace, which is used for storing published stubs, audit and activity logs, and user information.
    3. Enter the name of a default domain. To enable the publishing of stubs, HCL® Quality Server requires at least one domain. You can create an initial domain while installing the package. Alternatively, if you have not yet decided the number and the names of the domains that you will need, you can use HCL® Quality Server (after it is installed) or HCL OneTest™ API (if it is installed) to add one or more domains.
    4. In the Server Details section, enter the hostname where you are installing HCL® Quality Server. This information is used to create a connection URL for other products to connect to HCL® Quality Server. The default values are provided for you.
      Note: Specify a fully-qualified hostname, for example, example.host.ibm.com.
    5. In the Networking section, specify either the Internet Protocol version 4 or 6 (IPv4 or IPv6) as the networking environment preference for HCL® Quality Server. HCL® Quality Server uses this preference when it installs the HTTP proxy.
      For more information, see Installation considerations for HCL Quality Server.

      Click Next.

    6. In the Advanced Configuration page, enter the port number to use for communications between HCL® Quality Server and HCL OneTest™ API. This port is used for the Topology Discovery feature in HCL OneTest™ API. The default port is 7883 and is provided for you.
    7. In the HQS Security Configuration page, select an authentication type and enter the security details. To disable security, select None. Click Next.
      Note: You can modify the security settings after the installation. For more information, see Modifying security model settings after installation.
  14. If you are installing only the HTTP/TCP component, the Register with HCL® Quality Server page is displayed. To register HCL OneTest™ API proxy with HCL® Quality Server:
    1. Specify the HCL® Quality Server URL.
    2. Specify the HCL® Quality Server user name and password.
      Note: This step is applicable only when the Domain-level security is enabled. You can enable domain-level security only after starting HCL® Quality Server.
    3. Click Next.
  15. On the Summary page, review your choices before you install the product package and click Install.
    A progress indicator shows the percentage of the installation that is completed. When the installation process is complete, a confirmation message is displayed.
  16. 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.

    Alternatively, in Installation Manager, go to File > View Log to verify if the installation was successful.

  17. Click Finish to start HCL® Quality Server or return to IBM® Installation Manager.

What to do next

You can configure HCL® Quality Server. See Configuring HCL Quality Server.