This document describes steps to deploy Exium Agent Remotely to Windows using Connectwise Automate framework.
Step 1:
Login to the CW Automate portal and go to Automation section. Then Click on Scripts -> View Scripts. As shown below.
Step 2:
It will Open the Scripts tab. Then click on System Automation -> Deployment then Click on Add
Step 3:
It will open Script page/tab. Enter the details Name, Notes and Target. Under Then Right click then click onAdd
Step 4:
It will open Edit script step 1. Select the details as shown in following screenshot.
Download the Installation script from here. Open the downloaded script, copy all and paste the contents inside the script to execute box.
If you want to just install agent and does not want configure for tunnels for user, Please Click on Save button (This option is useful for one script deployment to multiple Systems)
However, if you want to deploy agent to specific system and configure tunnels for that user, That information needs to be passed in script parameters. On the script page, Select the tab name “Globals and Parameters”. On the right side, we can see the Parameters section. In the white box enter the parameter name “token” and then click on add and similarly add “workSpace and “userName” also. We can see all parameters will appear inside the below box.
We defined parameters on top, to pass the same parameters to script. Enter Script parameters inside the Script parameters box in order (space seprated) with syntax @token @workSpace@ @userName@ . Then Click on Save button
After saving, Close the panel.
Click on Create to create the script.
Step 5:
We can see the script under Deployment section below. Now go to the Top Right-side corner and click on beside the User Icon. It will open drop down menu. Select Reload System Cache. It will update the system cache
Step 6:
Now go back to the Main page. Now Select Computer then Right Click on it and select the script to deploy as shown below. You can select the script you created earlier.
Step 7:
It will show 2 options, Run Now and Later (Scheduled). Also, you can see parameter names which we added. Now Click on Next
It will open pop-up windows where it will ask you to enter a value for parameters
Enter token, workSpace, userName. Then Click on Save button, Click on Run . Please see section “Get Token from workspace” to get Secret TOKEN.
Step 8:
Once you click on Run It will show message like below. If you Selected Run now It will start deploying Immediately. For Schedule deployment, it will deploy as per scheduled time.
Client Connection ON/OFF
Follow the same steps as the installation for Connection ON/OFF, except for Step 4, which is described below.
Step 4 for ON/OFF:
This PowerShell script is used to connect/disconnect clients on Remote systems. It works in toggle mode. If client is connected and when script is executed, it will disconnected and vice versa.
- Download ON/OFF Script from here
- Copy content from script
- Paste the copied contents into the execution box of the script.
- Click the Save and Create button
Continue from Step 5 and follow the remaining steps as described for execution.
To uninstall the Exium Client (Windows) using Connectwise Automate, follow these steps:
Follow the same steps as the installation for uninstallation, except for Step 4, which is described below.
Step 4 for Uninstallation:
- Open Edit Script Step 1.
- Download the Uninstallation script from [here].
- Open the downloaded script and copy its contents.
- Paste the copied contents into the execution box of the script.
- Click the Save and Create button
Continue from Step 5 and follow the remaining steps as described for execution.
Get TOKEN from workspace
The MSP IT admin can obtain the secret TOKEN used in the above scripts by following the steps below.
- Log into the partner admin console.
- From the partner admin console, navigate to the client workspace requiring RMM deployment
- Click on the workspace name at the bottom-left (see Figure below) that will open up the profile tab
- Click on the profile tab that will open up the profile details
- Copy the secret TOKEN named “API Token” as shown in the figure below and include it in the RMM deployment script as described above.
ConnectWise Automate
ConnectWise Automate is the RMM solution that gives complete access and control over agent and agentless devices across the entire network. It allows remotely access endpoint devices, either manually or automatically, without disrupting users while resolving performance and/or security-related issues.
Detailed docs at:
https://docs.connectwise.com/ConnectWise_Automate