Bulk agent installation: Deploying WorkDrive TrueSync via Group Policy Object (GPO) for Windows OS

Bulk agent installation: Deploying WorkDrive TrueSync via Group Policy Object (GPO) for Windows OS

Group Policy Object (GPO) offers system administrators the ability to configure and manage applications, software operations, and user settings across an organization. This guide demonstrates how to utilize Group Policy to deploy the WorkDrive TrueSync application to client computers and users effectively.

Important:
  1. If you've set up a GPO-based installation for WorkDrive TrueSync on client computers and users, it will only install the application during the computer startup and will be available to all assigned users upon logon. The installation will only be completed when a user runs the program for the first time.
  2. If a user in your organization is restricted from using desktop TrueSync via the Admin Console, the app will still install, but they won't be able to log in and use it.

Prerequisites

  1. System requirements: Windows Server 2012 R2 or above.

  2. Supported Operating System: Windows 10 and Windows 11.
    Note: Support for WorkDrive TrueSync on older Windows versions (7, 8, and 8.1) will soon be discontinued. Learn more about why we have discontinued app support for older Windows versions

  3. Group Policy Management Console (GPMC): This tool must be installed and accessible.

  4. Administrator rights: You must have administrative privileges in your Active Directory (AD) environment.

  5. Network type: Ensure that the network has a Domain-based setup and not a Workgroup setup. A domain-based setup allows network admins to control all assets within the domain, while a workgroup-based setup that uses LAN only enables you to share resources.

Step 1: Create a secure distribution point via network share for the TrueSync .msi installation file

The initial step is to establish a secure network share folder for the MSI installation file (ZohoWorkDriveTS.msi) to ensure accessibility for users and client computers. The MSI files do not get copied to computers; instead the installation will run from a network share.
  1. Create a folder in a location where you want to store the TrueSync installation files and to share them via network share.
  2. Put the Windows Installer package (ZohoWorkDriveTS.msi file) that you want to distribute in the created shared network folder.
  3. Right-click the created folder and select Properties in the context menu. The Properties dialog box will appear.
  4. Select the Sharing tab and click the Advanced Sharing button.
  5. In the Advanced Sharing dialog box, mark the Share this folder checkbox.


  6. Provide the share name and click the Permissions button. The Share permission screen will appear; the network share option will be Everyone by default.



  7. If you want to share the folder with specific people, remove the Everyone option and add the specific users.
  8. Click Ok to get back to the Properties page.
  9. Click the Sharing tab and make a copy of the network path as shown below:



    The network share folder configuration is now complete.

Step 2: Create a Group Policy Object (GPO) to deploy TrueSync application to domain computers or users

  1. Press the keyboard shortcut Windows + R to open the run command.
  2. Enter gpmc.msc and press the Enter key to open the Group Policy Management.
  3. Right-click on your domain in the console tree and select the Create a GPO policy in this domain, and Link it here... option.



  4. Enter a name for the new GPO, (e.g. Sync TS Agent). Once the new GPO is created, you can see it in the GPM console in the left navigation pane, under Group Policy Objects.
    Note: This option is only available if you have a domain controller set up in your network. Workgroup wouldn't have this option.

    By default, the GPO created will be applied to all the users of the particular domain. If the admin wants to apply it to specific computers/users, follow these steps:
    1. Click Add under the Security Filtering tab.



    2. Add specific users/computers/group names and click Ok.

  5. Create a start-up task to execute the deployment and installation of the Windows Agent. To do this:
    1. Right-click the new GPO, then select Edit to open the Group Policy Management Editor.
    2. Navigate to Computer Configuration → Policies → Software Settings → Software Installation.

    3. Right-click on the Software installation, choose New → Package, and enter the full network path of the package file (Universal Naming Convention (UNC) path).
      Note: You need to enter the full UNC path instead of using the Browse path option (e.g. \\shared_computer\shared_folder\ZohoWorkdriveTS.msi)



    4. Select Assigned and click Ok.





    5. Close the Group Policy Management Editor.

  6. The TrueSync application will be installed for selected domain users during their next startup.

Best practices to avoid installation breakage

  1. Confirm the endpoint has access to the share where the MSI files are stored.

  2. Enable the Always wait for the network at computer startup and logon option. To do this,
    1. Press the keyboard shortcut Windows + R to open the run command.
    2. Enter gpmc.msc and press the Enter key to open the Group Policy Management.
    3. Locate and right-click on the created GPO and choose Edit to open the Group Policy Management Editor.
    4. Navigate to Computer Settings → Policies→ Administrative Templates→ System→ Logon.
    5. Enable the Always wait for the network at computer startup and logon option.
These steps should help in ensuring a smoother installation process and reduce the chances of breakage.

To update the TrueSync package via GPO

Important: The assigned domain computers will receive auto updates regularly. We encourage users to adhere to our standard auto update cycle, like all other customers, to ensure a seamless user experience. Learn more about the WorkDrive desktop sync apps auto update cycle.

In case, if you want to update to the latest version, please follow the steps provided below:
  1. Place the newer version package (.msi file) into a network shared folder.
  2. Press the keyboard shortcuts Windows + R to open the run command.
  3. Enter gpmc.msc and press Enter key to open the Group Policy Management.
  4. Locate and right-click on the existing GPO that you want to update and select Edit.
  5. Navigate to Computer Configuration → Policies → Software Settings → Software Installation.

  6. Right-click on the Software installation, choose New → Package, and enter the full network path of the newer version package.
    Note: You need to enter the full UNC path instead of using the Browse path option (for e.g., \\shared_computer\shared_folder\ZohoWorkdriveTS.msi)

  7. Right-click the newly added package, select Properties, and go to the Upgrades tab. 
  8. Select Add. The Add Upgrade Package dialog box will appear.



  9. In the Add Upgrade Package dialog box, select Choose a package from Current Group Policy Object (GPO).
  10. Review the list of packages under Package to upgrade, which lists all of the other packages that are assigned within the selected GPO.

  11. Click the package that you want to upgrade, and select Package can upgrade over the existing package.
  12. Click Ok. The newer version of the app will be installed on domain computers or for users upon their next startup.

To remove an existing group policy for the assigned TrueSync application

  1. Press the keyboard shortcut Windows + R to open the run command.
  2. Enter gpmc.msc and press Enter key to open the Group Policy Management.
  3. Locate and right-click on the existing GPO that you want to remove and select Edit.

  4. Expand the Software Settings container that contains the software installation item that you used to deploy the package.
  5. Click the software installation container that contains the package.
  6. In the right-pane of the Group Policy window, right-click the program, point to All Tasks, then click Remove.

  7. Perform one of the following actions:
    1. Click Immediately uninstall the software from users and computers, then click Ok.
    2. Click Allow users to continue to use the software but prevent new installations, then click Ok.

  8. Close the Group Policy Management Editor.

Troubleshooting

When troubleshooting Group Policy processing issues, it's important to identify whether the problem is localized to a single machine or if it's affecting multiple machines.



If only one machine is experiencing the issue, it's likely due to a malfunction or misconfiguration on that specific machine. In such cases, it's recommended to run a GP update. Follow the steps below on machines where the app is not installed after the group policy is applied:
  1. Right-click on the Start button.
  2. Select Command Prompt (Admin) to open the CMD window with administrative privileges.
  3. Enter the command gpupdate/force in the command prompt and press Enter. Allow it to process.



  4. Running this command ensures that any potential failures caused by temporary network issues are ruled out.
If the issue is more widespread with more computers, the problem may exist on a Domain Controller (DC) or in Active Directory (AD) itself.

For any questions or assistance during GPO deployment, please don't hesitate to reach out to WorkDrive support for further details and assistance.

WorkDrive support info:
  1. EU region: support@eu.zohoworkdrive.com
  2. All other regions: support@zohoworkdrive.com

Supportive GPO troubleshooting articles:
  1. Applying Group Policy troubleshooting guidance
  2. Use Group Policy to install software

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                    You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                        Manage your brands on social media

                                          Zoho Desk Resources

                                          • Desk Community Learning Series


                                          • Digest


                                          • Functions


                                          • Meetups


                                          • Kbase


                                          • Resources


                                          • Glossary


                                          • Desk Marketplace


                                          • MVP Corner


                                          • Word of the Day


                                            Zoho Marketing Automation

                                              Zoho Sheet Resources

                                               

                                                  Zoho Forms Resources


                                                    Secure your business
                                                    communication with Zoho Mail


                                                    Mail on the move with
                                                    Zoho Mail mobile application

                                                      Stay on top of your schedule
                                                      at all times


                                                      Carry your calendar with you
                                                      Anytime, anywhere




                                                            Zoho Sign Resources

                                                              Sign, Paperless!

                                                              Sign and send business documents on the go!

                                                              Get Started Now




                                                                      Zoho TeamInbox Resources



                                                                              Zoho DataPrep Resources



                                                                                Zoho DataPrep Demo

                                                                                Get a personalized demo or POC

                                                                                REGISTER NOW


                                                                                  Design. Discuss. Deliver.

                                                                                  Create visually engaging stories with Zoho Show.

                                                                                  Get Started Now









                                                                                                      • Related Articles

                                                                                                      • WorkDrive TrueSync - Release Notes

                                                                                                        Download the latest TrueSync app (Windows & Mac OS) Supported OS versions: For Windows: Windows 7 & above For Mac: OS X 10.14 and above Important: Only the stable version of the Desktop TrueSync app will be deployed for auto-update. Subsequent ...
                                                                                                      • WorkDrive Sync - Installation Errors for Windows users

                                                                                                        The below mentioned errors are some rare cases where the 'WorkDrive Sync installation in Windows OS' may fail due to system configurations.   Error code 2738 This error is most likely caused due to an improper system setting. To resolve this: ...
                                                                                                      • Install and set up WorkDrive Sync for Windows

                                                                                                        Before attempting to install WorkDrive Sync on your device, please ensure that your OS is Windows 7 or higher. Download the WorkDrive Sync app for the Windows OS (Download Link). Important: Please make sure to read the License Agreement and Privacy ...
                                                                                                      • WorkDrive TrueSync - Overview

                                                                                                        WorkDrive TrueSync app lets you create a virtual drive of your WorkDrive account in computer to access all your files without actually downloading any of your files. This saves your storage space on the computer. TrueSync also lets you sync files in ...
                                                                                                      • Uninstall Zoho WorkDrive TrueSync

                                                                                                        Follow the uninstallation steps below based on your OS. You’ll still be to access your WorkDrive files from the web app after uninstallation. For Windows Click the WorkDrive TrueSync icon in the taskbar or system tray. The popup menu will open. Click ...
                                                                                                        Wherever you are is as good as
                                                                                                        your workplace

                                                                                                          Resources

                                                                                                          Videos

                                                                                                          Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                          eBooks

                                                                                                          Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                          Webinars

                                                                                                          Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                          CRM Tips

                                                                                                          Make the most of Zoho CRM with these useful tips.



                                                                                                            Zoho Show Resources