Share this page

# Generate ALM client MSI files

Use ALM Client MSI Generator to generate an ALM client MSI file. You 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.

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

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

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

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

4. In the Server Address field, fill in the URL of the ALM server machine for which you want to 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.

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

6. 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.

7. 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, see Installation and upgrade.
   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, see Set configuration parameters. This feature is not supported on workstations using ALM Explorer.

8. 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.

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

Next steps:

- Run ALM client MSI files

https://admhelp.microfocus.com ALM 8942
Tips to improve your search results... ALM Help Center ALM Help Center ALM Help 16.00-16.0.1 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: