Citrix Workspace App Installer & Uninstaller Error Codes and Their Meanings
Article ID: CTX695019
Updated On:
Description
Understanding Installer and Uninstaller Exit Codes
When the Citrix Workspace app installer or uninstaller encounters an issue, it often returns an "exit code" or "error code." These codes are numerical values that indicate the specific reason for the failure. By identifying the error code, you can pinpoint the problem and take appropriate troubleshooting steps.
Common Error Codes
The following table lists the common error codes and their meanings:
|
Error Code |
Meaning |
|
40001 |
Installation error: Citrix has already been installed by an administrator. |
|
40002 |
Installation error: A previous installation of Citrix exists. Uninstall and remove the existing app and try the installation again. |
|
40003 |
Installation error: The cleanup utility code cannot be found. Try again, and if the issue persists, contact your system administrator. |
|
40004 |
Installation canceled |
|
40005 |
Installation error: The command line cannot be initialized. Try again, and if the issue persists, contact your system administrator. |
|
40006 |
Installation error: The application mutex object cannot be created. Try again, and if the issue persists, contact your system administrator. |
|
40007 |
Installation error: Citrix does not support the current operating system. |
|
40008 |
Install latest version: A more recent version of the app is available. We recommend installing the latest version. |
|
40009 |
Installation error: The app cannot be initialized. Try again, and if the issue persists, contact your system administrator. |
|
40010 |
Installation error: The resource base path cannot be retrieved. Try again, and if the issue persists, contact your system administrator. |
|
40011 |
Installation error: The resource manager cannot be initialized. Try again, and if the issue persists, contact your system administrator. |
|
40012 |
Installation error: The global document path cannot be retrieved. Try again, and if the issue persists, contact your system administrator. |
|
40013 |
Installation error: The localized document path cannot be retrieved. Try again, and if the issue persists, contact your system administrator. |
|
40014 |
Installation error: The configuration manager cannot be initialized. Try again, and if the issue persists, contact your system administrator. |
|
40015 |
Installation error: The component manager cannot be initialized. Try again, and if the issue persists, contact your system administrator. |
|
40017 |
Installation canceled |
|
40018 |
Installation error: This version of Windows Installer does not meet the minimum installation requirements. |
|
40026 |
Installation error: Unable to stop the processes or drivers. Reboot and retry installation. |
|
40026 |
Failed to uninstall: Unable to stop the processes or drivers. Reboot and retry installation. |
|
40027 |
Update in progress: A Citrix update is in progress. Wait for the update to complete, then try again. |
|
40028 |
Insufficient permissions: Administrator permissions are required to install Citrix app. Contact your system administrator. |
|
40032 |
Installation error: Your Citrix app is already up to date. |
|
40033 |
Installation error: Unable to parse and initialize the command line because of the store parameter. Try again, and if the issue persists, contact your system administrator. |
|
40034 |
Installation error: A Microsoft Installer installation failed. Try again, and if the issue persists, contact your system administrator. |
|
40036 |
Installation error: Uninstall Citrix HDX RealTime Media Engine and try again. |
|
40035 |
Uninstallation error: A Microsoft uninstallation failed. Try again, and if the issue persists, contact your system administrator. |
|
40037 |
Partial installation success: Citrix workspace installation success with all mandatory components. |
|
50001 |
Installation error: Cannot install Citrix Workspace App. The installer detects that a client already exists and it can be modified only by an administrator. To upgrade that client, run the package with administrator privileges. |
|
50002 |
Installation error: Upgrade path is unsupported. |
In addition to the error codes mentioned in the table above, MicroSoft specific error codes may appear. The following links should be viewed to get an understanding for Microsoft specific error codes.
- https://learn.microsoft.com/en-us/windows/win32/msi/windows-installer-error-messages
- https://learn.microsoft.com/en-us/windows/win32/msi/error-codes
General Troubleshooting Steps
If you encounter an installation or uninstallation error:
- Check the Error Code: Identify the specific error code from the error message or installation/uninstallation logs.
- Refer to this KB: Use the table above to understand the meaning of the error code.
- Run as Administrator: Always try running the installer/uninstaller with administrative privileges. Right-click the executable and select "Run as administrator."
- Restart Your Computer: A simple restart can often resolve pending operations, clear temporary issues, or stop processes that are interfering (especially relevant for codes like 40026).
- Check System Requirements: Ensure your operating system and hardware meet the minimum requirements for the Citrix Workspace app version you are installing.
- Temporarily Disable Security Software: Antivirus or firewall software can sometimes interfere with installations/uninstallations. Temporarily disable them with caution and retry the operation. Remember to re-enable them immediately afterward.
- Re-download the Installer: If the issue persists and isn't clearly explained by the error code, download a fresh copy of the installer from the official Citrix website.
- Review Event Viewer: For more detailed information, check the Windows Event Viewer (Applications and System logs) for related errors around the time of the failure.
Issue/Introduction
This Knowledge Base article provides a comprehensive list of common error codes you might encounter during the installation or uninstallation of the Citrix Workspace app, along with their respective meanings. Understanding these codes can help in diagnosing and resolving issues more efficiently.
Additional Information
Where to Get Further Help
If you continue to experience issues after following these steps, please:
- Consult Citrix Documentation: Refer to the official Citrix Workspace app documentation for your specific version.
- Contact Your IT Administrator: If you are an end-user in an organizational environment, reach out to your IT support team.
- Contact Citrix Support: If you are an administrator and require further assistance, contact Citrix Support, providing them with the error code, relevant logs, and details of the steps you have already taken.
