ConnectWise Automate for Agent Deployment

CyberCNS Agent Deployment for Windows using ConnectWise Automate RMM

Table of Contents

Overview

CyberCNS agents can be rapidly deployed using your ConnectWise Automate RMM by using a combination of EDFs and Scripting. Using this method you will enable a Client-based EDF that is enabled with a checkbox; screenshot below. This will push the CyberCNS agent to all computers in that Client location once enabled based on what Group and Scheduling you configure.

CyberCNS EDF Overview

CyberCNS Automate Deployment Script Requirements

  1. ConnectWise Automate (hosted or on-premise versions are supported)

  2. Permission to import a script

  3. Download our XML script from the .zip file below.

  4. Login to your ConnectWise Automate Control Center desktop application

  5. Select System > General > Import > XML Expansion and choose the file download from below.

CyberCNS Automate XML Script Download

 

 

Steps XML Expansion import

6. Browse to the Labtech Expansion (.xml) file you downloaded from Step 3 above and choose Open.

7. Choose YES when prompted

After the XML script is imported, it is recommended to check the EDF ‘ClientSecret’ to confirm it is still selected as a ‘masked’ field.

To check these settings, navigate in Automate Control Center desktop application to System > Configuration > Dashboard

Then from the System Dashboard choose Config (1) > Configurations (2) > Additional Fields (3) and click on the Clients (4) tab and locate ‘CyberCNSSeceret' (5) and confirm the ‘Masked text’ (6) box is selected.

Deployment Prerequisites

  1. Before you can use any of the methods described below, you must upload the ‘cybercnsagent.exe' to your LTShare located on your Automate server at the following path: ‘LTShare\Transfer\CyberCNS\cybercnsagent.exe’

The download location for ‘cybercnsagent.exe’ will come from the company level; steps below.

If you are using hosted Automate (domain.hostedrmm.com) then you will need to setup WebDAV access to upload to your LTShare. Here is the link from ConnectWise Documentation on how to set this up: https://docs.connectwise.com/ConnectWise_Automate_Documentation/020/010/080

2. You must setup each Automate client with their ‘CyberCNS CompanyID’ and ‘Cyber CNS Client Secret’ from your CyberCNS portal. This comes when you use the ‘Probe/Agent’ download button at the Company level. Each company must have their own unique installer information.

Using the CyberCNS Automate Deployment Script

Three Deployment Methods

  1. Manual: Computer Level Install

  2. Manual: Client Level Install (all computers at the Client level)

  3. Automated: Search/Group based auto installs by scheduled script

Method 1 and 2 - Manual: Computer Level Install or Manual: Client Level Install

Both manual methods (1 and 2) use the same steps outlined below

  1. Right-click on any computer with an Automate agent installed and choose 'Scripts > ConnectSecure > ConnectSecure Agent Installer - PSA Tickets Enabled

Once the script is selected, you will be prompted for additional parameters, see below:

Once you set your options and choose OK the agent should start installation based on the parameters chosen in the above screenshot.

Method 3 - Automated: Using Search, EDF, Groups, and Scheduled Script

Configuring Search in Automate

  1. From Automate Control Center desktop application, browse to Automate > Searches > View Searches

2. Tap the +Add button to create a new search

Tap on the to start and then click on ‘Computer.Antivirus.DefinitionFileAge.Days’ and then select Computer (2), Client (3), Extra Data Field (4), CyberCNS (5), and CyberCNS-Daily10AMDeploy (6)

Once the selection is made, give this Search a name (1) and choose save (2).

Search is completed and you can close out any of the ‘Search’ windows.

Configuring EDF in Automate

  1. From Automate choose Browse > Clients

  2. Double tap on the Client you wish to enable CyberCNS agent deployment (1)

  3. Choose the Info tab (2)

  4. Choose the CyberCNS tab (3) and use the checkbox options to enable auto deployment (4).

 

Navigate to your Client in CyberCNS (1), choose the ‘Probes/Agents’ menu (2) and select the download button (3) from the toolbar.

Once the agent parameters screen is displayed you will have your unique ‘CompanyID’ and ‘Client Secret’ needed for the Automate EDF’s.

Copy these values and paste them into your EDF fields as displayed below and choose Save (3) once you are finished.

Configuring Group in Automate

  1. Navigate to Browse > Groups tab > right-click on Groups and select ‘Create Group’

2. Give the Group a name (1), associate your Search with the Group (2), check the ‘Limit to Search’ checkbox (3), and then Create button (4).

Once you save you can proceed to setup the script scheduler using your preferences.

Configuring Scheduled Scripts in Automate

  1. From within the ‘Group’ created above, choose Computers (1) > Scheduled Scripts (2) > choose the ‘ConnectSecure\ConnectSecure Agent Installer - PSA Tickets Enabled’ script (3) > set the Daily schedule option (4) > and the target start time (5).

Then choose the Advanced Settings link

Validate the ‘Skip Offline Agents’ (1) and ‘Stagger Scripts’ (2) is configured to avoid any performance or network issues.

Tap the Add (3) button when completed.

You should see the script show in the multi-line preview below once saved.

If you have any issues or need assistance with the script steps please contact our Support Team by emailing support@cybercns.com and we will get in touch with technical support.