Top
Install the Whatfix Desktop Player
  • 09 Oct 2024
  • 7 Minutes To Read
  • Dark
    Light
  • PDF

Install the Whatfix Desktop Player

  • Dark
    Light
  • PDF

Article summary

Choose an installer

Whatfix provides distinct installers for the Whatfix Desktop Player based on the following criteria:

Installation methods

There are three methods of installation for the Whatfix Desktop Player.

1. User Level Installation

The Whatfix Player is installed for a particular user on a system. For example, if a system has three different user profiles, only the user who installs it gets the Player. This method is best suited for individuals looking to install the Player themselves, including end users and content creators.

2. System Level Installation

The Whatfix Player is installed for all users currently in the system. This installation method requires administrator privileges and is best suited for when you need to install Player on a virtual machine such as Citrix or Azure Virtual Desktop.

3. System Level Distributor

A distributor file is installed at the system level, triggering the installation of the Whatfix Player after a user in the system logs in, if they don't already have it. This ensures that users added to the system later automatically get the Player. It also ensures that the Player is reinstalled for a user if it gets uninstalled. Administrator privileges are required in this installation method.


Auto-update of the Player

Whatfix provides the capability to automatically update the Player whenever there is a new version. This capability is available for the User Level Installation and the System Level Distributor Installation methods, but not for the System Level Installation method. For more information, see Auto-update of the Whatfix Desktop Player.

Comparison of installation methods

User Level System Level System Level Distributor
Ideal usage By individuals such as end users or content creators By IT admins installing the Player on virtual machines such as Citrix or Azure Virtual Desktop By IT Admins installing the Player in bulk for all users.
Who can use this method? Anyone System administrators System administrators
Auto updates Available Not available Available

Your browser does not support Svg.click here to download

Underlying application

Whatfix provides a 64-bit and 32-bit installer for the Whatfix Player. The 64-bit installer is the default installer and can be used on almost all applications.

Only when you are using Whatfix Desktop on a 32-bit SAP application you need to install the 32-bit installer.

Whatfix account region

There are separate installers for Whatfix accounts based in the US and the EU.

Download the installer

Based on the installer criteria, download the required installer from the following tables:

Default Installer (64-bit Player) Installer for 32-bit SAP applications (32-bit Player)
User Level Installation US / EU US / EU
System Level Installation US / EU US / EU
System Level Distributor US / EU US / EU

Install the Player

The Player can be installed in two ways:

  • Use the Installation Wizard: Only User Level and System Level installation can be done this way.
  • Use the command prompt: All installation methods, including virtual machine installation, can be done this way.
Use the Installation Wizard

  1. Open the downloaded installer file to launch the installation wizard.

  2. Click Next to continue the installation.
    installation 1.png

  3. In the Destination Folder window, click Next to install the file in the default location or click Change... to choose a different location.
    dest_player_change.png

  4. In the Player Arguments window, enter your ORG ID, and then click Next.
    Installation 3.png

your title goes here
  • To get the ORG ID, contact your Whatfix Representative.
  • ORG ID is case-sensitive.
  1. On the Ready to install Whatfix Player dialog box, click Install to finish the installation.
    Installation 4.png

  2. On the Whatfix Player Setup window, click Finish
    Installation 5.png

Use the Command Prompt

  1. Open Windows Command Prompt and use the following command to change the current directory to the downloaded folder:
    cd {Path to downloads directory}
    cmd-downloadfolder DT

  2. Depending on the installation method you chose, run the following command to install Whafix Player:

User Level Installation
msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" HP="{HOSTED_PATH}" DD="{DEV_DOMAIN}" PORT="{PORT_NUMBER}" INSTALLPATH="{INSTALL_PATH}" /q

The following table explains the various parameters and values used in the command. Those that are not mandatory can be omitted and their default values are used. Replace the parameter values within quotes with the necessary values.

Description Mandatory?
{FILE_NAME} The file name of the downloaded installer. Yes
ORG Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. Yes
HP The hosted path (HP) parameter is the URL of your hosting environment. By default, it points to https://cdn.whatfix.com. In case you are using a Self Hosted mode of deployment, replace {HOSTED_PATH} with your own host URL. No
DD The development domain (DD) is the URL of the server where the installer is built. By default it is https://whatfix.com. Replace {DEV_DOMAIN} with your own URL. No
PORT The port number is used for debugging. By default, it is empty. Replace {PORT_NUMBER} with your preffered port number. No
INSTALLPATH This is the location where the Player is installed on your desktop. By default, it is in your local app data folder. Replace {INSTALL_PATH} with your preferred install location. No
/q This parameter ensures that the installation of the Player is done silently on your desktop. No
System Level Installation / Virtual Machine Installation

System Level Installation

msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" HP="https://cdn.whatfix.com" DD="https://whatfix.com" PORT="49999" INSTALLPATH="{INSTALL_PATH}" /q

Virtual Desktop Installation

msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" APP="{PATH_TO_APPLICATION}" ENV="Citrix"
Description Mandatory?
{FILE_NAME} The file name of the downloaded installer. Yes
ORG Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. Yes
HP The hosted path (HP) parameter is the URL of your hosting environment. By default, it points to https://cdn.whatfix.com. In case you are using a Self Hosted mode of deployment, replace {HOSTED_PATH} with your own host URL. No
DD The development domain (DD) is the URL of the server where the installer is built. By default it is https://whatfix.com. Replace {DEV_DOMAIN} with your own URL. No
PORT The port number is used for debugging. By default, it is empty. Replace {PORT_NUMBER} with your preffered port number. No
INSTALLPATH This is the location where the Player is installed on your desktop. By default, it is in your local app data folder. Replace {INSTALL_PATH} with your preferred install location. No
/q This parameter ensures that the installation of the Player is done silently on your desktop. No
APP The APP parameter is the complete path of the required application in the server machine. For example, C:\Program Files\Windows NT\notepad. Replace {PATH_TO_APPLICATION} with the path to your underlying application. Yes
ENV The environment (ENV) is the virtual workspace where the Player needs to be deployed. It is Citrix for both Citrix and AVD Yes
System Level Distributor
msiexec.exe /i {FILE_NAME} ORG="{ORG_ID}" /q /l*v out.txt
Description Mandatory?
{FILE_NAME} The file name of the downloaded installer. Yes
ORG Your Organization ID. Contact your Whatfix Representative to get your Organization ID, then replace {ORG _ID} with it. Yes
/q This parameter ensures that the installation of the Player is done silently on your desktop. No
/l*v These are the installer logs. No
  1. Press the Enter key.
Note

If there is no error message, the installation is successful.
playe_install.png

  1. When the installation is complete, open the desktop app to view Whatfix content.
    ms_teams_preview.png

Note
  • If the Whatfix Desktop Player was installed in your system prior to March 11, 2021, you must uninstall the older Whatfix Desktop Player. For more information on how to uninstall Whatfix Desktop Player, see Uninstalling Whatfix Desktop Player.
  • For User Level and System Level Distributor installation methods, the Whatfix Desktop Player is auto-updated at regular intervals. However, for System Level installation, auto-updates are not applicable. For more information on the Whatfix Desktop Player auto-updates, see Auto-update of Whatfix Desktop Player.

Validate the installation

After you have finished the Player installation process, check whether it has been installed in your system in the following ways:

  • Use file location: This method can be used to validate the Player's installation for all installation methods
  • Use the registry: This method can be used to validate the Player's installation for all methods except User Level Installation.
Use the registry

This is a standard method of validation wherein IT Admins can use the Windows Registry to check whether the Player's distributor file has been installed, even if they do not have access to end-user registry. This method does not require accessing the user's profile.

  1. Go to your computer's Registry Editor.
  2. Under HKEY_LOCAL_MACHINE, click SOFTWARE.
    Snag_275a18.png
  3. Depending on the installation method, verify whether the following file exists:
System Level Installer

Double-click the Whatfix folder to see the Registry Entry of the Player.
reggit_sli.png

System Level Distributor

The PlayerBulkManager file is present under a folder titled Whatfix.
Snag_27b037.png

Double-click PlayerBulkManager to see the Registry Entry of the Player.
Snag_675f80.png

Use file location

Depending on the installation method, verify whether the following folder exists to validate whether the installation was successful:
User Level Installation
AppData > Local > Whatfix Player

System Level Installation
Program Files > Whatfix > Whatfix Player

System Level Distributor
Program Files > Whatfix > Player MSI Manager

Troubleshooting

If you face issues with installation, see Unable to install Whatfix Desktop Studio or Player.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.