Category filter

Deploy Windows EXE apps using Hexnode UEM

Microsoft has introduced the MSI (Microsoft Installer) format to streamline the deployment of enterprise software on Windows systems. However, it’s important to note that a substantial number of software publishers opt not to distribute MSI packages for their applications. Instead, they provide EXE (executable) files for installation on Windows devices. These applications encompass a wide variety, including in-house enterprise apps, utility apps, and various other software types. IT admins can now deploy EXE apps with the help of Hexnode UEM, and this help document explains the step-by-step guide on how to upload, configure, and deploy EXE apps on Windows devices.

Disclaimer:


The app installation behavior is dependent on the EXE app package. It is recommended to validate the app deployment on a system before executing the action in bulk.

Add EXE apps to Hexnode app inventory

An enterprise app must first be uploaded to the Hexnode app inventory before its distribution.

  1. Log in to your Hexnode UEM portal.
  2. Navigate to Apps.
  3. Select +Add Apps > Enterprise App.
  4. Choose the platform as Windows.
  5. Provide the App Name.
  6. Select the app category as EXE File.
  7. Select an app category or input a new category by clicking on the + button.
  8. Provide a description for the application and click Add to upload the file.
  9. Specify the app version for the EXE file.
  10. While uploading the app file, you can check the Notify admin via email once app upload succeeds/fails option to receive the email notifications on the app upload status.
  11. Additionally, configure the Success Criteria (at least one is mandatory) and the Uninstallation settings for the app as well.

    Success Criteria

    Disclaimer:

    • The success criteria being configured in Hexnode to determine the app installation status are entirely at the administrator’s discretion. If incorrect values or conditions are set, it could result in issues detecting the app deployment status.
    • The installation behavior depends also on the app package. It’s recommended to validate the app deployment behaviour before executing the action in bulk.

    Defining a success criterion for installation allows administrators to validate specific app parameters after installation and detect inconsistencies. Success criteria include parameters such as app identifiers, registry paths, and app paths, which confirm whether an app is correctly installed. If the set criteria are met, the app is considered successfully installed, even if discrepancies exist in the enterprise file. Administrators can verify this directly from the console.

    Different success criteria:

    1. App Identifiers: Add one or multiple app/installer identifiers (product codes), separated by a semicolon (;). Once the enterprise app is installed, Hexnode verifies if the installed application contains the specified app identifier. In case of a mismatch, the success criterion will fail.

      For example:

      The App Identifier may be a string of numbers, or a name provided by the app publisher, such as {3456C7D8-2345-6789-ABCD-EFG12345678} or Mozilla Firefox.

      Note:


      The App Identifier can be fetched using any of the following two ways. First, install the specified app manually on a Windows device.

      1. If the chosen Windows device is enrolled in Hexnode, navigate to Manage > Devices > select the specific device. In the Applications tab, search for the specific app and you can find the corresponding App Identifier there.
      2. When an app is installed at the system level, its app identifier resides in the HKLM registry. Conversely, when an app is installed at the user level, its app identifier can be found in the HKCU registry. The app identifier can be fetched from the registry editor using the following methods:
        1. If both the system and app are 64 bits, then search for SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall in the registry editor on the Windows device.
        2. If the system is 64-bit and the app is 32-bit, then search for SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall in the registry editor on the Windows device.
        3. If the system is a 32-bit system, then search for SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
          in the registry editor on the Windows device.

    2. Registry Path: This option allows you to define the path of a registry key to be checked on the target device. This can be any registry key created when the app is successfully installed. If the key does not match, the success criteria will fail.

      There are two components to configure in this option:

      1. Registry Root: This is the top-level directory in the Windows Registry, such as HKLM (HKEY_LOCAL_MACHINE), HKCU (HKEY_CURRENT_USER), HKCR (HKEY_CLASSES_ROOT), HKCC (HKEY_CURRENT_CONFIG), and HKU (HKEY_USERS).
      2. Subkey: This is the specific path within the registry root, such as \SOFTWARE\MyCompany\MyApplication.

      For example:

      In the case of Firefox, the registry key related to the app is ‘HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Mozilla Firefox’.

      From the registry root dropdown, choose HKLM and enter the subkey ‘SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Mozilla Firefox‘.

    3. Install Path: This option can be used to confirm the app’s installation on the device by checking for a specific file present on the target device. The file’s location is indicated in the Path field, which should contain the path of any file created upon successful app installation.

      For example:

      In the case of Mozilla Firefox, the path of the file is most likely to be in the following format:

      C:\Program Files\Mozilla Firefox\firefox.exe

  12. Later, the administrators can select one of these parameters to assign it as the success criteria when deploying an enterprise app to the devices.

    Uninstallation settings

    You must configure at least one of the following options:

    1. App Identifier: Enter the app identifier.
      • Note that the app identifier cannot be modified or configured from the Required Apps policy.

    2. File Path
      : Provide the exact file path (e.g., C:\Program Files\Hexnode UEM\uninstall\helper.exe).
      • If the app requires specific uninstallation commands, check Add uninstallation commands and provide the necessary parameters.
    3. User Scope: Choose whether the scope applies to All user accounts or the Current user account.
    4. Configure Uninstallation Settings when distributing Windows enterprise apps to devices

  13. Click Add to upload the file.

Deploy EXE apps via the Install Application action

The EXE apps added to the Hexnode app inventory can be distributed to the devices using the Install Application remote action. Follow the given steps for the deployment of EXE apps.

  1. On your Hexnode UEM portal, navigate to Manage > Devices.
  2. Click on the device.
  3. On the device summary page, click Actions > Install Application.
  4. Select the app.
  5. Click Configure to specify the installation settings.
  6. Click Install.

Deploy EXE apps via Policy

  1. On your Hexnode UEM portal, navigate to Policies.
  2. Create a new policy with the New Policy button or select an existing policy.
  3. From Windows > App Management, select Required Apps.
  4. Click on Configure and +Add button to either add an app or a group of apps from the app inventory.
  5. Select the required app(s) and click Configure under Custom Installation to set up installation and uninstallation settings.

    Configure EXE app installation settings

    For EXE apps, Hexnode UEM enables administrators to configure various installation settings during app deployment.


    Tab showing option to configure the EXE app
    • Install silently: The administrator can install apps silently on Windows devices with the help of this option. By default, this option is enabled, and it allows the installation of applications without prompting the user. If unchecked, the user will get a pop-up to allow the app installation manually.

    • Pop-up on the device requesting permission for the installation of the EXE application

      If the user selects the Not Now option from the installation pop-up, then the app installation message will appear under the Notifications section of the Hexnode UEM app. Users can grant permission for installing the app from here in case they selected the Not Now option. This app installation prompt will appear under the Notifications section of the Hexnode UEM app only if the administrator checks the Retry if the installation fails option while configuring the app installation settings.


      Notifications section of the Hexnode UEM app displaying a prompt for app installation
      Note:

      • Only applications that support silent installation, consisting of the command-line parameter “/s” (case-sensitive) inside the EXE package will be installed silently.
      • Hexnode has already configured the command-line parameter “/s” (case-sensitive) by default to initiate silent app installation on Windows devices (when the Install silently option is selected). If the application has silent installation command-line parameters other than “/s“, it is recommended to specify it in the Specify the parameters field under Add Installation commands option.
      • If the administrator doesn’t set up the command-line parameter correctly in the Specify the parameters field, the application installation action will fail.
      • The silent app installation process may take a couple of minutes, depending on the app size and network connectivity.
    • Install app at system level: Installing an app at the system level refers to making the app available to all users of a computer, rather than just one user. By default, this option is checked. Unchecking this option will lead to the app installation at the currently logged-in user level only.
    • Note:


      Some EXE app packages may not support system-level installation and can only be installed at the user level. For such apps, uncheck this option to install the app at the user level. Selecting the Install app at system level option for an application that supports user-level installation or vice versa will result in the failure of the app installation action.

    • Force device restart after app installation: When this option is selected, the device automatically restarts upon successful installation of apps.
    • Add Installation commands: Admins can specify installation parameters by checking this option. These command-line parameters help admins modify the installation process and other related operations on the device.
    • Note:

      • All the command-line arguments are dependent on the EXE packaging. Hence, specify the arguments accordingly.
      • When you include one or more parameters, separate them using space.
      • For example, /s /norestart.

      • As you add more parameters, make sure they do not conflict with each other. Adding conflicting parameters may lead to unintended behavior on the device.
    • Installation timeout (minutes): If the app installation process is not complete within the specified time duration, it will be forcefully terminated. The minimum and maximum time duration is 10 and 60 minutes, respectively.
    • Note:


      The configured timeout period considers only the app installation process that begins after the EXE file has been deployed from the Hexnode UEM server.

    • Success Criteria: You can choose one of the validation criteria defined during the enterprise app upload to the Hexnode app inventory here. The installed application must meet the selected criterion for the installation action to be successful. The three available options are:
      1. App exists: This option uses the App identifiers parameter as the success criterion.
      2. Path exists: This option uses the Install path as the success criterion. It can be edited or updated directly from the Installation Settings.
      3. Registry exists: This option uses the Registry path as the success criterion.

      Note:


      Administrators cannot define success criteria during app deployment. To set success criteria, navigate to the Apps tab, select the desired application, and define or edit the necessary parameters as mentioned earlier.


      After app deployment, administrators can verify the success criteria status from the Action History tab of the device in the Hexnode portal. Select the app status corresponding to the initiated action to view detailed information.


      Hexnode portal showing app installation Success Criteria status under the Action History tab
    • Retry if the installation fails: This option allows the app installation process to automatically re-attempt if the initial installation attempt fails. The number of tries can be selected from the Maximum number of retries option. The minimum and maximum number of retries are 1 and 5 times, respectively.
    • Retry: Administrators can specify when to retry the app installation process. The available options are:
      • immediately
      • after 1 minute
      • after 2 minutes
      • after 5 minutes
      • after 10 minutes
      • after 15 minutes
      • after 30 minutes
      • after 60 minutes

    Configure EXE app uninstallation settings

    You must configure at least one of the following options:

    1. App Identifier: Enter the app identifier.
      • Note that the app identifier cannot be modified or configured from the Required Apps policy.

    2. File Path
      : Provide the exact file path (e.g., C:\Program Files\Hexnode UEM\uninstall\helper.exe).
      • If the app requires specific uninstallation commands, check Add uninstallation commands and provide the necessary parameters.
    3. User Scope: Choose whether the scope applies to All user accounts or the Current user account.
    4. Configure Uninstallation Settings when distributing Windows enterprise apps to devices

  6. Click Done when finished.
  7. For EXE apps, configuring the installation and uninstallation settings is mandatory before adding them to Required Apps. These settings can later be edited after adding them.
    Note:

    Configuring the correct Uninstallation Settings is necessary when deploying EXE files as required apps if the “Remove apps from the device on policy removal” option is selected. Otherwise, the app will not uninstall after policy removal.

  8. Click Save.
  9. Next, associate the policy with the target devices by navigating to the Policy Targets tab.
  10. Select the required Devices/Device Groups/Users/User Groups/Domains to which the policy is to be associated.
  11. Click on Save.

By following the steps mentioned in this help document, IT administrators can seamlessly add EXE apps to the Hexnode app inventory, customize various app installation and uninstallation settings to suit their organization’s requirements, and deploy these applications to devices with ease.

  • Deploying and Managing Apps