Starting and stopping HCL Quality Server

You can start HCL Quality Server to enable users to log in by using a web browser. If the server is installed as a service, you can configure it for automatic startup on boot or for manual startup on demand.

About this task

On Windows systems, the server is, by default, configured to be installed as a service, and for automatic startup on boot. If you cleared these selections during the installation, then use the Modify option of IBM® Installation Manager to update the installation. See Starting and stopping on Windows systems.

On non-Windows systems, after installation, you must manually configure the server as a service. See the following procedures for non-Windows systems:

Starting and stopping on Windows systems

Procedure

Starting and stopping the server from the Windows command line:

  • Start the server from the command line. Run the startup.bat file from the default location C:\Program Files\HCL\HCLProducts\QualityServer\bin.
  • Stop the server from the command line. Run the shutdown.bat file from the default location C:\Program Files\HCL\HCLProducts\QualityServer\bin.

Starting and stopping the server if the server was installed as a Windows service:

  • Start the service from the Start menu. Click HCL OneTest > Start HQS.
    Note: By default, the server is configured to start automatically on boot.
  • Stop the service from the Start menu. Click HCL OneTest > Stop HQS.

Modifying the Windows service from automatic startup to manual startup:

  • Follow these steps to change from automatic startup to manual startup:
    1. Go to Control Panel, and select System and Security > Administrative Tools > Services.
    2. Double-click HCL Quality Server.
    3. Change the startup type from Automatic to Manual. Click OK.
      Tip: You can also use this Control Panel option to start or stop the service.

Starting and stopping on non-Windows systems

Before you begin

Ensure that you have root permissions.

About this task

You can use either an init shell script or a systemd script to start HCL Quality Server.

Procedure

  • Start the server from the command line by using a start-up script (init shell script or systemd script) that you can find in /opt/HCL/HCLProducts/QualityServer. Run the init shell script named startup.sh from the default location or run the systemd script named hqs.service from an Administrator command prompt. If you want to run the systemd script, follow these steps:
    1. Install the file and set permissions:
      sudo cp hqs.service /etc/systemd/system/hqs.service
      sudo chmod 644 /etc/systemd/system/hqs.service
    2. Start the service:
      sudo systemctl start hqs

      For more information about systemd, see the systemd documentation.

Stopping on non-Windows system:

  • Run the shutdown.sh file from the default location: /opt/HCL/HCLProducts/QualityServer.

Configuring automatic start on boot on non-Windows systems:

  • Follow these steps to configure automatic start on boot for the init shell script:
    1. Add the startup.sh script to the path /etc/init.d.
    2. Create symbolic links to the script in the run-level folders, for example, /etc/rc3.d.
      Tip: For automatic shutdown, copy the shutdown.sh script to the path /etc/init.d, and create a symbolic link in the run-level folders, for example, /etc/rc0.d.
    3. Open a command prompt and run the following command:
      sudo update-rc.d startup.sh defaults 
  • Follow these steps to configure automatic start on boot for the systemd script:
    1. Enable automatic startup:
      sudo systemctl enable hqs
    2. Check the status:
      sudo systemctl status hqs

Configuring automatic start on boot on RedHat Linux systems

Before you begin

Ensure that you have root permissions.

About this task

The steps for RedHat Linux systems are different from those for non-Windows systems.

Procedure

  1. Add the startup.sh script to the path /etc/init.d.
  2. Create symbolic links to the script in the run-level folders, for example, /etc/rc3.d.
  3. Edit startup.sh (located at both /etc/init.d and /etc/rc3.d) by using the following command: nano startup.sh.
  4. Replace the following lines:
    #!/bin/sh 
    . /opt/HCL/QualityServer/bin/setenv.sh 
    /opt/HCL/QualityServer/bin/server start defaultServer
    with the following:
    #!/bin/sh 
    #chkconfig: 345 99 01 
    #description: startup.sh 
    . /opt/HCL/QualityServer/bin/setenv.sh 
    /opt/HCL/QualityServer/bin/server start defaultServer

    This adds startup.sh to chkconfig.

  5. Run the following command: ntsysv.

    This command runs startup.sh automatically on boot.

Feedback