icon-zapp.svg
Client Connector

Reverting Zscaler Client Connector to the Previous Version

If a recent upgrade wasn't successful for some users (e.g., they have issues connecting to Zscaler Client Connector), they can revert to the previous version. This feature applies to Zscaler Client Connector version 3.9 and later for Windows and Zscaler Client Connector version 4.1 and later for macOS.

Only admins can enable this option. If you're not a Zscaler Client Connector admin, contact your organization's support team about enabling this option.

After this feature is enabled, users can revert to the previous version in Zscaler Client Connector.

The revert option is not supported for non-persistent virtual desktop infrastructure (VDI).

Enabling the Revert Option in the Zscaler Client Connector Portal

  • Enable this option before installing Zscaler Client Connector version 3.9 or later for Windows.

    1. Verify that auto-update to the latest version is not enabled. If it is enabled, disable it. To learn more, see Configuring Update Settings for Zscaler Client Connector.
    2. In the Zscaler Client Connector Portal, go to App Profiles > Windows.
    3. Click Add Windows Policy.
    4. Click Enable Zscaler Client Connector Revert.
    5. If you want to require users to enter a password to revert to the previous version, add a password in the Revert Password field.
    6. To run the revert process in unattended mode and require a password, configure a revert password in platform settings. To learn more, see Configuring Passwords for Access in Unattended Mode.
    Close

  • Enable this option before installing Zscaler Client Connector version 4.1 or later for macOS.

    1. Verify that auto-update to the latest version is not enabled. If it is enabled, disable it. To learn more, see Configuring Update Settings for Zscaler Client Connector.
    2. In the Zscaler Client Connector Portal, go to App Profiles > macOS.
    3. Click Add macOS Policy.
    4. In the General section, click Enable Zscaler Client Connector Revert.
    5. If you want to require users to enter a password to revert to the previous version, add a password in the Revert Password field.
    Close

Reverting to a Previous Version in Zscaler Client Connector

  • There are two ways users can revert to the previous Zscaler Client Connector version for Windows:

    • In Zscaler Client Connector, click More. In the Troubleshoot menu, click Revert App.
    • On the CLI, enter one of the following commands depending on your system:
      • 32-bit system: %ProgramFiles(x86)%\Zscaler\RevertZcc\<previous version installer> --revertzcc 1 --exportLogs 1 --mode unattended
      • 64-bit system: %ProgramFiles(x64)%\Zscaler\RevertZcc\<previous version installer> --revertzcc 1 --exportLogs 1 --mode unattended

    For <previous version installer>, make sure to use the path of the version before the upgrade. On devices that are upgraded, there are two installers in the \Zscaler\RevertZcc folder. One installer is the upgraded version. The other installer is the version before the upgrade. If you configured a revert password for access in unattended mode, add --revertPasswordCommandLine <revert password> to the command and replace <revert password> with the generated revert password in platform settings.

    When users revert to a previous version, Zscaler Client Connector does the following with updates made since the most recent upgrade:

    • Retains configuration files for any users and partner tenants that have been added.
    • Retains any changes to service entitlements.
    • Removes configuration files for any deleted or logged-out users and any deleted partner tenants.
    • Retains the ZPA certificate if an updated certificate has been uploaded.
    • Retains any certificates and keys that have been set up for authenticating machine tunnel access.
    Close

  • There are two ways users can revert to the previous Zscaler Client Connector version for macOS:

    • In Zscaler Client Connector, click More. In the Troubleshoot menu, click Revert App.
    • On the CLI, enter the following command:

    sudo sh /Applications/Zscaler/RevertZcc/<previous version installer>/Contents/MacOS/installbuilder.sh --revertzcc 1 --exportLogs 1 --mode unattended

    Close
Related Articles
Understanding Zscaler Client Connector App DownloadsConfiguring Zscaler Client Connector for Microsoft 365 Cloud PCsCustomizing Zscaler Client Connector with Install Options for MSICustomizing Zscaler Client Connector with Install Options for EXECustomizing Zscaler Client Connector with Install Options for macOSCustomizing Zscaler Client Connector with Install Options for LinuxCustomizing Zscaler Client Connector with Install Options for AndroidCustomizing Zscaler Client Connector with Install Options for iOSDeploying Zscaler Client Connector with Active Directory for WindowsDeploying ZDX With Workspace ONE UEM for iOSDeploying ZDX with Jamf Pro for iOSDual Tunnel Feature Configuration with Jamf Pro for iOSDual Tunnel Feature Configuration with Microsoft Intune for iOSDeploying Zscaler Client Connector with MaaS360 for AndroidDeploying Zscaler Client Connector with MaaS360 for iOSDeploying Zscaler Client Connector with Microsoft Intune for AndroidDeploying Zscaler Client Connector with Microsoft Intune for macOSDeploying Zscaler Client Connector with Microsoft Intune for iOSDeploying Zscaler Client Connector with Google WorkspaceDeploying Zscaler Client Connector with MobileIron for iOSDeploying Zscaler Client Connector with MobileIron for AndroidDeploying Zscaler Client Connector with JAMF Pro for macOSDeploying Zscaler Client Connector with Jamf Pro for iOSDeploying Zscaler Client Connector with Workspace ONE UEM for AndroidDeploying Zscaler Client Connector with Workspace ONE UEM for iOSBlocking LAN AccessBest Practices for Zscaler Client Connector DeploymentBest Practices for Updating Latest Versions of Zscaler Client Connector ApplicationUninstalling Zscaler Client ConnectorReverting Zscaler Client Connector to the Previous VersionUpgrading Zscaler Client Connector