Installation Methods

You can install the software by using the stand-alone installer in one of the three methods such as the GUI mode, the silent mode, and the console mode. You can select the installation method that works best for your environment.

You can use the GUI mode to install the software from electronic images or downloaded packages. Alternatively, you can use the silent mode to install the software on multiple systems as a non-interactive method. You have to generate the properties file first to install the software in the silent mode. The console mode installation is well suited for the workstations that use Ubuntu platform where GUI mode is not supported.

Installing the software by using the stand-alone installer in GUI mode

You can use the GUI mode in the stand-alone installer program to install HCL OneTest™ Server from electronic images or downloaded packages.

Before you begin

You must have completed the following tasks:

  • Completed the tasks given in the Prerequisites section.
  • Deleted the installer.properties file generated from the previous installation process if it is present in the same directory where you are installing a newer version of the product.

Procedure

  1. Download the HCL OneTest Server software package from the FlexNet portal.
  2. Extract the downloaded software package.
  3. Run the executable file that is present within the extracted folder. To run the executable file, log in as a root user and enter the following commands:

    cd /root/Downloads/

    ./HCL-OneTest-Server-LINUX-X64.bin

    The GUI window is launched.
  4. On the Introduction page, read through the details and click Next.
  5. On the License Agreement page, review the licensing information and select the I accept check box. Click Next.
  6. On the Server Name page, enter the host name with the domain name. For example, <host name>.<domain name>.
    Note: If your DNS server is unable to resolve your host name, you can enter the IP address. For example, <IP address>.nip.io.
  7. On the License Server page, enter the license server details such as license server ID and server URL. .
  8. On the Destination Folder page, browse and select a folder where you want to install the server. Alternatively, you can install the server in the default location /opt/HCL/OneTest-Server.
  9. On the Restore User Data page, select Yes if you want to restore the backed-up user data, select the snapshot file. Otherwise, select No to skip restore and continue with the installation.
    Note: By default, the backed-up user data is available at C:\ProgramData\HCL\Snapshot.

    If you do not find the ProgramData folder while you browse to select the back up file, you have to first include the hidden files in the directory.

  10. On the Pre-Installation Summary page, read the details about the installation. Check the disk space on your system. If your system does not have the required space for installing the server, make enough space and then click Install. On the Starting Server page, the URL for accessing the server is displayed.
  11. Click Next to complete the installation.

    On successful installation, the server starts automatically. The URL of the server is displayed on the Starting Server page. You can use this URL to access the server. Alternatively, you can obtain the URL details of the server from the file located at <install-dir>/Logs. You can obtain the URL of the server from the file startup.txt file.

    After you have installed the software, a message is displayed about the installation status.

  12. To check for errors that occurred during installation, access the log file available at <install-dir>/Logs.

Installing the software by using the stand-alone installer in silent mode

You can install the software automatically without manual intervention in the silent mode installation method. This method is helpful when you want to deploy the software in a large network.

Before you begin

You must have completed the following tasks:

  • Completed the tasks given in the Prerequisites section.
  • Deleted the installer.properties file generated from the previous installation if you are installing a newer version of the product.
  • Created the properties file that has to be passed during the installation process. For more information, see Creating the properties file.

About this task

When you provide the command for silent mode installation, you have to pass the properties file that contains inputs and parameters required to complete the installation process.

Procedure

To install the software in the silent mode, perform the following steps:

  1. Log in as a root user.
  2. Change to the directory where you have downloaded the zip file. Enter the following command to change the directory:

    cd Downloads/<directory path>
    For example, cd Downloads/

  3. Extract the downloaded file. To extract the downloaded file, enter the following command:

    unzip <zip file name>
    For example, unzip HCL-OneTest-Server-LINUX-X64.bin_10.0.0.v20190528_0302.zip

  4. Enter the following command to install the software on your machine:

    ./HCL-OneTest-Server-LINUX-X64.bin -i silent -f <path of properties file/properties file name>

Installing the software by using the stand-alone installer in console mode

You can use the console mode installation method to install HCL OneTest Server on the workstations that use the Ubuntu platform, specifically where the GUI mode is not supported. The console mode provides an interactive and text-based mode of installation method.

Before you begin

You must have completed the following tasks:

  • Completed the tasks provided in the Prerequisites section.
  • Deleted the installer.properties file generated from the previous installation if you are installing a newer version of the product.

Procedure

  1. Download the software package HCL OneTest Server from the portal.
  2. Log in to the Ubuntu system as a root user.
  3. Open the terminal and change the directory from root to the directory where you have downloaded the zip file. Enter the following command to change the directory:

    cd <directory path of the downloaded folder>
    For example, cd Downloads/

  4. Extract the downloaded file by entering the following command:

    unzip <software package name>
    For example, unzip HCL-OneTest-Server-LINUX-X64.bin_10.0.1.v20190828_0302.zip

  5. Enter the following command to initiate the installation process in the console mode.

    ./<filename.bin> -i console
    For example, ./HCL-OneTest-Server-LINUX-X64.bin -i console

    Restriction: Enter -i option in the command only when GUI is supported in your workstation. Otherwise, enter the command without -i.
  6. Review the license agreement by typing the appropriate number to view license information:
    1. Press any key along with the Enter key to continue reading the license agreement or press 0 (zero) along with the Enter key to go to the end of the license agreement.
    2. At the end of the license agreement, enter Y to accept the license agreement and continue with the installation.
      Note: If you enter N, the installation is canceled.
  7. Enter the server name. The server name is the combination of the host name and domain name. For example, <host name>.<domain name>.
    Tip: If your DNS server is unable to resolve your host name, you can enter the IP address. For example, <IP address>.nip.io.
  8. Enter the license server details such as the license server ID and then the server URL.
  9. Provide the path where you want to install the software:
    • To install the software in the default path /opt/HCL/OneTest-Server, press Enter.
    • To install the software in a new directory path, enter the complete path of the directory and press Enter.
  10. Optionally, select from the following options to restore the user data on the Docker volumes:
    • To restore the user data, select Yes and press Enter.
    • To proceed with the installation without restoring the data, select No and press Enter.
  11. Review the pre-installation summary. Press Enter to continue with the installation process.
    Warning: The installation might get terminated if there is insufficient disk space.
    Note: To check the errors that occurred during the installation, you can access the start_up.txt file available at the location: /opt/HCL/OneTest. You must resolve the errors and run the installation process again to get the server URL.
    On successful installation, the URL to access the server is displayed.
  12. Press Enter to exit the installer.

Results

On successful installation of HCL OneTest Server, a URL to access the server is displayed.

What to do next

You can start HCL OneTest Server UI by using the browser.

Feedback