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 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 versions and system requirements related to Docker-CE and Docker-Compose. For more details about the Docker version, see the HCL Support portal.

Procedure

  1. Install Docker-CE and Docker-Compose on your machine. Download Docker-CE from the Docker-CE link and Docker-Compose from the Docker-Compose link. You must follow the links and complete the steps to install Docker.
  2. Verify if the Docker is up and running by entering the following command in a terminal:
    $ docker run hello-world

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 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 versions and system requirements related to Docker-CE and Docker-Compose. For more details about the Docker version, see the HCL Support portal.

Procedure

  1. Install Docker-CE and Docker-Compose on your machine. Download Docker-CE from the Docker-CE link and Docker-Compose from the Docker-Compose link. You must follow the links and complete the steps to install Docker.
  2. Verify if the Docker is up and running by entering the following command in a terminal:
    $ docker run hello-world

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