Installing ALM Lab Service

This task describes how to install ALM Lab Service.

Note: To modify or repair your ALM Lab Service installation, see Modify or Uninstall ALM Lab Service.

  1. Download the ALM Lab Service MSI installation file from the ALM Add-ins page. Select the installation path that matches your operating system.

    Note: Lab Service and the ALM server to which you are connecting must be of the same version in order to be compatible. If your version of Lab Service is not the same as the ALM server, the Hosts/Testing Host grid displays your testing host as Unavailable.

  2. Run the MSI installation file. The ALM Lab Service - Installation Wizard launches on the Welcome screen.

    Note:  

    • Administrator permissions are required on the machine.

    • User Access Control (UAC) must be disabled.

    Click Next.

  3. The Destination Folder screen opens.

    Specify in which folder you want to install Lab Service. To change the destination folder, click Change.

    Note: You must have read/write permissions to the destination folder.

    To install to the folder displayed, click Next.

  4. The Custom Setup screen opens.

    You can enable Lab Service's Auto Login feature at this stage in the installation. Click the Auto Login check box icon and select Enable this feature. For details about Auto Login, see Auto Login.

    Click Next.

  5. The Confirm Settings screen opens.

    To review or change any settings, click Back.

    To accept the settings and start the installation process, click Next.

    The Installation page opens and the Micro FocusALM Lab Service files are installed on your machine.

  6. After the installation completes, the ALM Lab Service Settings dialog box opens along with the Finish screen.

    You can enter your host settings into the Lab Service Settings dialog box and click OK. For user interface details about the Lab Service Settings Page, see ALM Lab Service Agent.

    Note:

    • We recommend you configure the Lab Service settings at this stage, but you can configure it later as well. The agent will not function until the settings are configured.
    • If you enabled Auto Login during the installation, you will be prompted to restart your computer. Make sure to enter your details into the Lab Service Settings page before restarting.

    The Lab Service installation is complete. Click Finish on the Finish screen. The Lab Service tray icon appears on the Windows taskbar.

From the command line, enter the Microsoft MSI silent installation command:

msiexec /i "<msi-location>/HpAlmLabService_x64.msi" /quiet SERVERNAME=http://<server_name>:<port>/qcbin HOSTUSERNAME=<user_name>

Note:  

  • Administrator permissions are required on the machine.
  • User Access Control (UAC) must be disabled.

The following ALM-specific parameters are available:

Parameter (A - Z)

Description
HOSTUSERDOMAIN=<domain> Required when Auto Login is enabled. Specifies the login user's domain.
HOSTUSERNAME=<user_name>

Required parameter. Specifies the user that must be logged in when running tests on the testing host.

Note: The user you select must have the following permissions:

  • Create global objects.
  • All COM permissions.

  • Read/write permissions to the destination folder.

  • All permissions needed to run tests of the desired type. For example, if you intend to run UFT One tests from ALM, the selected user must have all permissions needed to run UFT One tests. For details about the permissions required per testing tool, see the user guide for the appropriate testing tool.
HOSTUSERPASSWORD=<password> Required when Auto Login is enabled. Specifies the login user's password.
ISAUTOLOGIN=1 Enables the Auto Login feature. If Auto Login is enabled, you must use the HOSTUSERDOMAIN and HOSTUSERPASSWORD parameters. For details about Auto Login, see Auto Login.
LOGLEVEL=<log-level>

Configures the level (<log-level>) at which Lab Service will write logs. Supports the following log levels: Error, Off, Warning, Info, Verbose. For details about log levels, see ALM Lab Service Agent.
LOGLOCATION="<log-directory>" Configures the location (<log-directory>) in which the Lab Service logs will be written.
REGISTER=1 Automatically sends a registration request to the ALM server after the installation completes.
SERVERNAME=http://<server_name>:<port>/qcbin

Required parameter. The URL of the ALM server.

Example: SERVERNAME=http://almserver1:8080/qcbin

Additional standard MSI parameters are available. Type msiexec /? from the command line for more information.