How to Uninstall and Offboard ConnectWise Automate Agents

Automate Agents are specialized software components designed to perform automated tasks and manage various aspects of IT operations, often used by Managed Service Providers (MSPs) to enhance efficiency and reliability. These agents can handle routine maintenance, monitor system performance, and execute scheduled tasks, freeing up valuable time for IT staff and ensuring consistent system management.

In today’s IT landscape, where businesses heavily rely on robust technological support, choosing the right MSP is crucial. However, when clients opt for a different MSP or need to cancel services, it can be a challenging process. Properly managing and offboarding Automate Agents is vital in such scenarios to ensure a smooth transition and to maintain a positive relationship with the client. By following the correct procedures for uninstalling and offboarding these agents, you not only avoid potential disruptions but also leave a good impression, demonstrating professionalism and care in handling client transitions.

In this article, we’ll walk through the essential steps to effectively uninstall and offboard Automate Agents, helping you navigate this process with ease and ensuring a seamless experience for both you and your clients.

Preparing to Uninstall Automate Agents

A well-planned approach is essential for a seamless and efficient uninstallation of Automate Agents. By adhering to a structured pre-uninstallation checklist, you can minimize disruptions and safeguard important data and configurations. Follow these crucial steps:

Backup Essential Data and Configurations

Protecting key information, settings, and customizations is vital to prevent data loss during the uninstallation. Backing up ensures you can restore your system if issues arise or if you need to reinstall the agent in the future.

Steps to Follow:

  • Data Backup: Identify all data managed by the Automate Agent, such as system logs, user data, and performance metrics. Use reliable backup solutions to create copies of this information.
  • Configuration Backup: Document or export configurations, including scheduled tasks, scripts, and other custom settings. Maintain a clear record of these configurations for future reference.

Inform Team Members and Stakeholders

Effective communication helps prevent unexpected disruptions and ensures that everyone is informed about the upcoming changes. Keeping all relevant parties updated facilitates coordination and manages expectations.

Steps to Follow:

  • Internal Communication: Notify your IT team and any other relevant staff about the uninstallation schedule and its implications. Provide details on how it might affect their work and any actions they need to take.
  • External Communication: If the Automate Agent affects client-facing services, inform clients or external stakeholders about the planned uninstallation. Make them aware of the timeline and any potential impact on their services.

Review and Adjust Permissions

Reviewing permissions and access rights is crucial to prevent unauthorized access or accidental modifications during the uninstallation. Properly managing these permissions ensures a smooth process and prepares you for any future actions or reinstalls.

Steps to Follow:

  • Access Review: Check the permissions and access levels associated with the Automate Agent. Verify which users or systems have the authority to interact with or alter the agent.
  • Adjust Permissions: Modify permissions if needed to limit access during the uninstallation. Ensure that only authorized personnel can make changes or perform related tasks.

By carefully preparing and following these steps, you can ensure a smooth uninstallation of Automate Agents, minimizing operational impact and effectively managing data and stakeholder expectations.

Methods to Uninstall Automate Agents

  • Manual
  • Offboarding Scripts
  • Custom Automation

Let’s break these down in order of difficulty to accomplish:

Manual Uninstallation Methods

Manual uninstallation involves directly removing Automate Agents from individual machines, typically using a provided uninstaller tool. This method can be effective for small-scale environments but may be impractical for larger setups.

To start with manual uninstallation methods, you can download the uninstaller from ConnectWise’s repository here. Once downloaded, you can run this tool on each machine to remove the Automate Agent.

This approach is most suitable if the business has 5 or fewer machines and you have the ability to remotely access these systems. If you can complete the process within 15-20 minutes, manual uninstallation can be a straightforward solution. However, for environments with more machines, or if the remote access time is significantly longer, manual uninstallation should be considered only as a last resort. In such cases, it’s advisable to use offboarding scripts wherever possible to automate and streamline the process.

If manual uninstallation becomes necessary, consider informing the client with a template email to explain the situation and any potential impacts.

Offboarding Scripts

Offboarding scripts are an efficient way to handle the removal of Automate Agents from multiple systems. These scripts automate the uninstallation process, reducing the manual effort required and ensuring consistency across all machines.

Let’s review the default offboarding script and explore how it works before we get into the pros and cons. By default, the offboarding script performs several key actions:

  • Resets Windows Update Settings: It restores the Windows update settings to their default state, ensuring that no custom configurations are left behind.
  • Uninstalls ConnectWise Control: The script removes the ConnectWise Control application, which is often used in conjunction with Automate Agents.
  • Queues the Uninstall of the Automate Agent: It schedules the Automate Agent for uninstallation, streamlining the removal process.
  • Moves the Agent to the Retired Assets Tab: Finally, it updates the status of the agent to “retired,” indicating that it is no longer active.

However, there are some caveats to be aware of: The offboarding script does not uninstall or remove any third-party software that may be present on the system, nor does it delete sessions in ConnectWise Control. Additionally, the retirement of the agent may fail if the script is not marked for ‘offline agent,’ potentially leading to errors before the agent is successfully retired.

While offboarding scripts are a powerful tool, they may require additional steps to fully remove all components of your MSP stack from the agent. Running the script manually can help address any remaining issues, but be prepared to take extra actions to ensure a complete and thorough offboarding process.

Automate’s Default Offboarding Script
Automate’s Default Offboarding Script

Custom Automation for Offboarding

Custom automation is crucial when you need to address specific requirements that go beyond what the default offboarding script can handle. This approach allows you to tailor the uninstallation process to fit unique needs and ensure that all elements of your system are properly managed.

Custom Automation comes into play here for anything you’ve done outside of the default offboarding script. For instance, ProVal has developed a custom script that interacts with ConnectWise Control. During the uninstall phase, this script not only removes ConnectWise Control from the endpoint but also ends any active sessions in ConnectWise Control, helping to keep your environment clean and organized.

You can take the default offboarding script as a template and modify it to fit your specific needs. This includes adding logic to uninstall additional components of your MSP stack or handling other custom requirements. However, be mindful of certain challenges:

  • Uninstallation of Third-Party Software: Some antivirus (AV) and anti-malware programs may not have straightforward uninstallation methods outside of their proprietary tools. Your custom script may need to account for these exceptions.
  • Fail-Safes and Alerts: Incorporate fail-safes in your custom script to handle errors effectively. Set up alerts or create tickets if the script encounters issues, particularly if it fails before completing the final uninstallation. This approach promptly addresses any problems, preventing incomplete removal of the Automate Agent.

By customizing your offboarding automation, you can achieve a more comprehensive and controlled uninstallation process, tailored to the specific needs of your environment. This not only improves efficiency but also helps maintain a clean and well-managed IT infrastructure.

Documenting Your Offboarding Process

Proper documentation of your offboarding process is crucial for a smooth transition when clients leave your services. A clear, documented procedure ensures consistency, enhances efficiency, and minimizes errors.

To effectively manage offboarding, create a comprehensive checklist that includes every step from script execution to final system checks. Ensure your team can easily access and use this detailed checklist.

Here’s how to document and manage your offboarding process efficiently:

  1. Develop a Checklist: Outline all steps, including notifications, data backup, and system verifications. Include both automated and manual tasks.
  2. Use PSA or Project Management Tools: Integrate your checklist into Professional Services Automation (PSA) or Project Management software to automate tasks, track progress, and ensure completion.
  3. Assign Responsibilities: Clearly define roles and delegate tasks to appropriate team members to cover all aspects of the process.
  4. Appoint a Central Overseer: Designate a person or team to monitor progress, address issues, and ensure adherence to the documented process.
  5. Update Regularly: Review and revise your documentation as needed to reflect any changes in procedures or client needs.

A well-documented and automated offboarding process ensures a structured client transition, reducing errors and enhancing efficiency. This approach demonstrates professionalism and improves client relationship management.

How ProVal Can Assist You With Offboarding Automate Agents

ProVal’s team of engineers and consultants is adept at streamlining your offboarding process to ensure maximum efficiency. We understand that clients often have unique requirements and time constraints, and we’re here to automate and manage these processes for you.

Our expertise includes designing offboarding solutions that meet specific needs, such as scheduling scripts or implementing monitoring systems that automatically handle machine deactivations based on predefined criteria. We have established numerous offboarding methods, from automated script executions to real-time monitoring solutions. We can tailor our approach to meet your precise requirements, making the offboarding process seamless and effective.

Written by: Alex Ramsbey – Business Operations Consultant

They truly act as an extension of our team, providing the right consulting support exactly when we need it.

ProVal brings deep, hands-on knowledge of how ConnectWise PSA really works, combined with a thoughtful, consultative approach that sets them apart.

They listen first—both to understand our environment and who we are as an organization—and focus on finding the right solutions rather than pushing products. With strong command of best practices and experience across many MSP environments, they truly act as an extension of our team, providing the right consulting support exactly when we need it.

michael-lafond
Michael LaFond
ConnectWise Program Manager
New Charter Technologies

How to Uninstall and Offboard ConnectWise Automate Agents

2

I truly view ProVal as a partner and extension of my team, not as one of my vendors

When our NOC Manager left last fall we wanted to replace the position with an outsourced NOC to reduce headcount, and bring in an expert to both Labtech and our backup solutions. Bringing in ProVal Technologies was one of the best decisions we made last year and has paid for itself.During our first few monthly recurring Labtech admin meetings the ProVal team discovered incorrect settings and policies that were not applying correctly in our Labtech server. Things that we thought were automated and working were not. For example, there were multiple scripts and policies running but set to do nothing such as disk cleanup scripts. Cisco Umbrella was not configured correctly. Server alerting was not set right and the list went on.The backup team sends daily and weekly reports and updates that reduce my technicians time that we used to spend on backup or antivirus tickets that took forever and were tedious.ProVal also brings in great insights to our business and really cares about our success. They will frequently mention to me in meetings what new scripts they can import to make us more efficient or will schedule upgrades to our backups, Labtech, etc so I don’t have to worry. I truly view ProVal as a partner and extension of my team not as one of my vendors.

Chris-Warnick-Headshot
Chris Warnick
Vision Computer Solutions
Northville, MI

They will quickly become an extension of your team and your ROI will reflect the results

We have been a long time user of Labtech and had tried for many years to manage the product internally with no real success at the level we needed to make our solutions more efficient for our customers. Once we hired Vikram and his team at ProVal, it solved all our pain points with the product and we really felt like we were leveraging the tool as it was designed. If this sounds like you and it’s keeping you up at night, then you need these guys. They will quickly become an extension of your team and your ROI will reflect the results.

Bryan-Wolff-Headshot
Bryan Wolff
CEO, Wolff Logics LT Managed & Admin Services
Cedar Park, Texas

They work well, fast and on budget

We met Vikram from ProVal Tech at Gary Pica’s Shnizzfest a year ago. Vikram explained the advantage of having trained, certified personnel take care of our recent Automate implementation. Even though we had taken an implementation package from ConnectWise to start up the program, we felt many custom configurations we needed for our business were lacking. We hired ProVal Tech after Automate was installed to help us with this task. From sales to technicians everyone was professional and knowledgeable. Onboarding was simple, and well documented. Tools on the web were supplied while we did the work, and they allowed us to track what was done, and see the improvements in the environment. It was easy to reach any of the team members, for any concern or question – all answered with courtesy and smile. Once the work was finished, we were given some training and explanations, add to that documentation, about the work and the scripts and features added to the program. We have been happily working with Automate since then. We can only recommend this efficient team of people for any work into Automate: they work well, fast and on budget.

Ben-Prevost-Headshot
Ben Prevost
FarWeb IT
Sherbrooke, Canada
Copy link