Prerequisites for installing the software

Before you can install the software you must complete certain tasks such as checking the system requirements, setting up licensing, and setting up the Docker environment.

Reviewing system requirements

Before you begin the installation, you must verify that your hardware and software meet the minimum requirements. You must have set up a system, which includes setting up the Docker, with the following minimum requirements:

  • 20 GB disk space
  • 16 GB RAM
  • 6 CPUs
Note: For a complete list of system requirements, see the HCL Support portal.

Setting up licensing

You do not require a separate license to use HCL OneTest™ Server, but you must have runtime licenses available to run tests from the server. You must also have a product license to run any tests and Virtual Users pack floating license to run performance tests and AFT tests on more than 5 channels.

Before you install and use HCL OneTest Server, you must enable the license based on the type of product license that you have acquired. For details about HCL OneTest Studio licenses and how to enable licenses, see License descriptions.

You must have the following details before you start the installation process:

Setting up other software

On your computer, you must have installed and enabled the following software:
  • Git for Windows

    For more information about downloading and installing Git for Windows, see Git for Windows.

  • Hyper-V
  • OpenJDK 8 along with JVM OpenJ9 or later

    To download them, go to the OpenJDK portal. The JDK format might vary based on the operating system.

Complete the following prerequisite task as required:

Setting up and enabling the Docker environment

As a prerequisite to installing the software, you must set up and enable the Docker environment.

Before you begin

You must have installed the appropriate version and system requirements related to the Docker Desktop. For more details about the Docker version, see HCL Support portal.

Procedure

  1. Download Docker Desktop for Windows from the Docker docs portal. You must follow the link and complete steps there to install Docker.
  2. After installing Docker on your machine, allocate 12 GB to Docker memory. To allocate Docker memory, perform the following:
    1. Right-click the Docker icon Docker_icon in the system tray.
    2. Click Settings > Advanced > Memory.
    3. Enter 12288 in the RAM text box and set 4 or more in the CPUs slide.
    4. Click OK.
  3. Verify if the Docker is up and running by entering the following command in the terminal:
    $ docker run hello-world
  4. After you have installed and set up Docker, you must share your drive to allow Docker to access the files on the host machine. To provide Docker access, perform the following:
    1. Right-click the Docker icon.
    2. Select the drive and click Apply.
    3. Click Settings > Shared Drives.

Creating the properties file

To install HCL OneTest Server in the silent mode, you must first generate a properties file that contains the data required to install the software. Alternatively, you can download and use the properties file provided in the table.

Before you begin

Before you generate the properties file, you must be aware of the restore option that you want to be written in the properties file. When you install in the silent mode by using the properties file, the option for restore is selected based on the value in the properties file. For example:
  • If you want to install the software with the restore option, perform the following tasks in the properties file:
    • Set the RESTORE_1 parameter to 1.
  • If you want to install the software without the restore option, perform the following tasks in the properties file:
    • Set the RESTORE_1 parameter to 0.
    • Delete the snapshot file location specified in the properties file.

About this task

You can create the properties file either by generating or by writing the contents of the sample properties file in your properties file. To generate the properties file, you must use the stand-alone installer. When you generate the properties file, you can directly use the file for initiating the silent installation process. If you create the properties file, you must enter appropriate values according to your requirement before using in it the silent installation process.

Procedure

Generate or create the properties file by following the appropriate procedure.
  • Generate the properties file by entering the command in the terminal:
    ./HCL-OneTest-Server-LINUX-X64.bin -r <destination path/file name>
  • Create your properties file based on the following sample properties file:
    • Use the following sample properties file when you want to restore the user data.
      #Server Name
      #-----------
      SERVER_NAME=<Hostname>
      #License Server
      #--------------
      HCL_ONETEST_LICENSING_1=<License id>
      HCL_ONETEST_LICENSING_2=<License url>
      #Installation Folder
      #-------------------
      USER_INSTALL_DIR=/opt/HCL/OneTest-Server
      #Restore User Data
      #-----------------
      RESTORE_1=1
      SNAPSHOT=/root/onetest_backup/<snapshot file>
    • Use the following sample properties file when do not want to restore the user data.
      #Server Name
      #-----------
      SERVER_NAME=<Hostname>
      #License Server
      #--------------
      HCL_ONETEST_LICENSING_1=<License_id>
      HCL_ONETEST_LICENSING_2=<License_url>
      #Installation Folder
      #-------------------
      USER_INSTALL_DIR=/opt/HCL/OneTest-Server
      #Restore User Data
      #-----------------
      RESTORE_1=0

Results

You have created the properties file.

Feedback