Citrix Virtual Apps and Desktops

VDA Meta Installer Helper Tool

1. Introduction

The VDA Meta Installer helper tool includes a set of tools to assist with VDA installation via SCCM task sequences, and a utility for analyzing installation logs and identifying potential issues.

With a simple MSI installation and an intuitive user interface, Meta Installer helper tool offers several essential features:

  • Check SCCM task sequence: This tool assists in reviewing and validating existing SCCM task sequences to ensure compatibility with VDA installation requirements.

  • Generate task sequence reference: This tool automatically creates a reference task sequence to help integrate VDA installation into SCCM deployment workflows with minimal manual configuration.

  • VDA Installation Log Analyzer: This tool helps review installation logs to identify errors, warnings, or failures. The tool generates a report highlighting root causes, possible resolutions, and recommendations for successful deployments.

2. Installation

  1. Download Citrix Virtual Apps and Desktops product ISO from Citrix Virtual Apps and Desktops Downloads page

  2. Find Citrix.MetaInstallerHelperTool_x64.msi from \Support\Tools\MetaInstallerHelperTool folder.

    Meta installer helper tool

  3. Double-click the Citrix.MetaInstallerHelperTool_x64.msi to install the tool.

    Note:

    This tool is not part of the VDA. You can install it on a VDA or on any local device.

  4. After installation, launch the application as an Administrator by searching for “MetaInstallerHelperTool” in the Start Menu.

    Admin Meta Installer Helper Tool

3. User Interface (UI) Overview

Upon launching the application “MetaInstallerHelperTool”, the main user interface will appear, designed for intuitive navigation and ease of use.

The “Home” section provides descriptions of the guides in the “How to” section and functional descriptions of the tools for checking SCCM sequences, generating task sequence templates, and analyzing VDA installation log.

You can access these guides and tools by selecting the corresponding tabs from the left-hand navigation panel.

Meta Installer Home

The “How to” section provides guides for exporting task sequences, installing VDAs using SCCM, and importing reference templates with screenshots and steps.

  • See “How to export task sequences” to obtain SCCM task sequence for use with the “Check SCCM task sequence” tool.
  • See “How to install VDAs using SCCM” to install VDAs. “Check SCCM task sequence” tool and “Generate task sequence template” tool will also refer to this guide.
  • See “How to import reference template” to import the template generated by the “Generate task sequence template” tool into your SCCM environment as a reference template.

The Check SCCM task sequence, Generate task sequence template, and VDA Installation Log Analyzer sections let you perform the core tasks of the Meta Installer Helper Tool.

4. Tools

  1. Check SCCM task sequence

    Upload the task sequence exported from your SCCM environment for review and validation.

    The tool will check if the uploaded file is a zip file and contains the required SCCM Task Sequence folder structure, the required object .xml file, and a valid task sequence definition. It will also do command-line parameter analysis and installation condition analysis based on the task sequence.

    Meta installer check SCCM

  2. Generate task sequence reference

    This tool generates a task sequence template following Citrix’s official guidelines for VDA installation via SCCM.

    You can import it into your SCCM environment as a reference template for incorporating VDA installation into your task sequences.

    Meta installer generate task sequence

  3. VDA Installation Log Analyzer

    Analyze installation logs directly on the VDA using Automatic mode or manually upload a .zip file containing VDA installation logs for analysis.

    Meta installer log analyzer

    When running in Automatic mode on the VDA, the tool automatically detects the log storage path and analyzes the installation logs locally. The analysis results are saved, and all log files and reports are packaged into a single ZIP file.

    Meta installer log analyzer 1

    In Manual mode, you must upload a .zip file that contains the VDA installation logs for analysis. By default, the log files are stored in the following location: %TEMP%\Citrix\XenDesktop Installer

    If the default log path has been modified, you can verify the current location in the Windows Registry at: Computer\HKLM\Software\Citrix\MetaInstall\LogPath

    The tool extracts the uploaded .zip file, analyzes its contents, and saves the analysis results for review.

    Meta installer log analyzer 2

VDA Meta Installer Helper Tool