Generating ALM Client MSI Files

Use the ALM Client MSI Generator to generate an ALM Client MSI file.

Generate a new MSI version each time the ALM server or database schemas are updated. This includes the following cases:

  • A patch is installed.

  • An extension is installed.

  • A new test type is created.

  • ALM server configurations are changed

To generate an ALM Client MSI file:

  1. Log on with administrator privileges.

  2. Note: You must run the ALM Client MSI Generator locally, and not over a network.

  3. Close any open instances of the ALM Client MSI Generator, and of Internet Explorer.

  4. Run the ALM Client MSI Generator. The Generate Client MSI for ALM Server page opens.

    Alternatively, you can execute the ALM Client MSI Generator from the command line using command line arguments. For more information, execute “ClientMSIGenerator.exe/?” from the command line. 

  5. In the Server Address field, fill in the URL of the ALM server machine for which you want to a create a client MSI. Use the following format:

    http://<ALM server name>[<:port number>]/qcbin

    Note: Only HTTP and HTTPS protocols are supported.

    If you are generating an updated MSI file, from the dropdown list, select a server address that you previously entered.

    External Authentication users. Use http://localhost:<port>/qcbin in the Server Address field.

  6. To change the proxy settings, click Proxy Settings.

  7. Fill in the following fields:

    Field Description
    MSI Language Select a language for the MSI user interface.
    MSI Name

    The MSI file name. The MSI file name includes the following elements:

    ALM server address. As entered in the Server Address box.

    MSI version number. The version number increases automatically each time you create an MSI file for the same server address.

    Save MSI in

    The output folder in which the MSI file is saved. It is recommended to save the MSI file outside the ALM Client MSI Generator program directory.

  8. Select one of the following options:

    Field Description
    Include Component Registration

    Select this option if you want to register ALM client components on the workstations. ALM clients must be registered to enable users to work with other Micro Focus testing tools as well as third-party and custom tools. For more information, refer to the Micro Focus Application Lifecycle Management Installation and Upgrade Guide.

    Use Shared Deployment Mode Select this option if you want to deploy ALM client components on a shared location of a client machine. This is useful for users on virtual environments such as Citrix and VMware accessing the same location.
    Skip Prerequisites Check

    Select this option to instruct the MSI to bypass checks for system prerequisites on client machines. This is useful on mass distribution systems, which will deploy client components even if prerequisites are missing.

    Note: To enable this feature, you must define the SKIP_CLIENT_PREREQUISITES_CHECK site parameter, and set its value to “Y”. For more information, refer to the Micro Focus Application Lifecycle Management Administrator Guide. This feature is not supported on workstations using ALM Explorer.

  9. To generate the MSI, click Generate MSI.

    For Single-Sign-On users:

    1. If the user discovery page is displayed, add your user name or email address as specified in ALM. Click Submit.
    2. In the IDP page, add your IDP credentials. Click the log in button.

    The Progress dialog box opens, displaying the progress of the MSI generation. This may take several minutes. Click Show Details to display log details of the MSI generation.

    Note: You can also view the log file of the MSI generation in the <ALM Client MSI Generator installation directory>/log directory.

  10. After the MSI is generated, in the Progress dialog box, click Goto MSI to open the folder in which the MSI file is saved.