Create Installation Tasks for Mac Devices from ConnectWise RMM

The WatchGuard Agent is responsible for the deployment of the WatchGuard product software. To facilitate this in ConnectWise RMM, you can use automation tasks to create installation tasks for the WatchGuard Agent on your Mac devices. Complete one of these procedures:

• Create a Task to Install the WatchGuard Agent on Mac Devices
• Create a Task to Install the WatchGuard Agent on Mac Devices Manually Mapped in the Onboarding Application

After you create the task, you schedule it. For more information, go to Schedule the Installation Task.

Create a Task to Install the WatchGuard Agent on Mac Devices

Before you begin, make sure that you have configured the WatchGuard Agent plug-in to automatically map ConnectWise RMM companies with WatchGuard Cloud accounts. You must also have the runner_shell.sh script, available from the downloaded ConnectWiseRMM.ZIP file. The provided script is used to automate agent installation when the account mapping is completed in the WatchGuard Agent onboarding application or you have manually mapped accounts to the specified custom fields.

To create a task to install the WatchGuard Agent on Mac devices, from ConnectWise RMM:

1. Go to Automation > Tasks.

2. In the upper-right, click Add > Script Editor.
3. In the Name box, type WatchGuard Agent - Install agent on macOS.
4. In the Description box, type This script installs WatchGuard Agent on Mac devices.
5. From the Category drop-down list, select Setup.
6. In the Script Editor section, click Add Row.

7. Add a pre-defined variable for the WatchGuard Account ID:
   1. From the drop-down list, select Function.
   2. Select Set Pre-defined Variable.
   3. In the dialog box that opens, in the Variable Name text box, type AccountID.
   4. Select Custom Field.
   5. Select WatchGuard Account ID.
      
   6. Click Save.
   7. From the Operating System drop-down list, select MacOs.
8. Add a pre-defined variable for the WatchGuard Token:
   1. Click Add Row.
   2. From the drop-down list, select Function.
   3. Select Set Pre-defined Variable.
   4. In the dialog box that opens, in the Variable Name text box, type Token.
   5. Select Custom Field.
   6. Select WatchGuard Token.
   7. Click Save.
   8. From the Operating System drop-down list, select MacOs.
9. Add a user variable to run the Bash script runner_shell.sh:
   1. Click Add Row.
   2. From the drop-down list, select Function.
   3. Select Set User Variable.
   4. In the dialog box that opens, in the Variable Name text box, type ScriptAction.
   5. In the Value text box, type installv2.
      
   6. Click Save.
   7. From the Operating System drop-down list, select MacOs.

10. Add a bash script:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Bash Script.
    4. Copy and paste the bash script runner_shell.sh into Script.
    5. Click Save.
    6. From the Operating System drop-down list, select MacOs.
11. Define a script log message to include the script results:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Script Log.
    4. In the Script Log Message box, type %output%.
    5. Click Save.
    6. From the Operating System drop-down list, select MacOs.

12. In the upper-right corner, click Save.
    You can now Schedule the Installation Task.

Create a Task to Install the WatchGuard Agent on Mac Devices Manually Mapped in the Onboarding Application

Before you begin, make sure that you have manually mapped the ConnectWise RMM and WatchGuard Cloud accounts. Complete the procedure in this section to create an installation task when you did not configure the API integration between ConnectWise RMM and WatchGuard Cloud. You must also have the runner_shell.sh script available from the downloaded ConnectWiseRMM.ZIP file. The provided script is used to automate agent installation when the account mapping is completed in the WatchGuard Agent onboarding application or you have manually mapped accounts to the specified custom fields.

To create a task to install the WatchGuard Agent on Mac devices manually mapped, from ConnectWise RMM:

1. Go to Automation > Tasks.

2. In the upper-right corner, click Add > Script Editor.
3. In the Name box, type WatchGuard Agent - Install agent on macOS with manual options.
4. In the Description box, type This script installs the WatchGuard Agent on Mac devices.
5. From the Category drop-down list, select Setup.
6. In the Script Editor section, click Add Row.

7. Add a pre-defined variable for the WatchGuard Account ID:
   1. From the drop-down list, select Function.
   2. Select Set Pre-defined Variable.
   3. In the dialog box that opens, in the Variable Name text box, type AccountID.
   4. Select Custom Field.
   5. Select WatchGuard Account ID.
      
      
   6. Click Save.
   7. From the Operating System drop-down list, select MacOs.
8. Add a pre-defined variable for the WatchGuard Token:
   1. Click Add Row.
   2. From the drop-down list, select Function.
   3. Select Set Pre-defined Variable.
   4. In the dialog box that opens, in the Variable Name text box, type Token.
   5. Select Custom Field.
   6. Select WatchGuard Token.
   7. Click Save.
   8. From the Operating System drop-down list, select MacOs.
9. Add a pre-defined variable for the WatchGuard Client Company ID:
   1. Click Add Row.
   2. From the drop-down list, select Function.
   3. Select Set Pre-defined Variable.
   4. In the dialog box that opens, in the Variable Name text box, type ClientId.
   5. Select Custom Field.
   6. Select WatchGuard Client Company ID.
   7. Click Save.
   8. From the Operating System drop-down list, select MacOs.
10. Add a pre-defined variable for the WatchGuard Deployment ID:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Set Pre-defined Variable.
    4. In the dialog box that opens, in the Variable Name text box, type DeploymentSetting.
    5. Select Custom Field.
    6. Select WatchGuard Deployment ID.
    7. Click Save.
    8. From the Operating System drop-down list, select MacOs.
11. Add a user variable to run the Bash script runner_shell.sh:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Set User Variable.
    4. In the dialog box that opens, in the Variable Name text box, type ScriptAction.
    5. In the Value text box, type installv2.
       
    6. Click Save.
    7. From the Operating System drop-down list, select MacOs.

12. Add a bash script:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Bash Script.
    4. Copy and paste the bash script runner_shell.sh into Script.
    5. Click Save.
    6. From the Operating System drop-down list, select MacOs.
13. Define a script log message to include the script results:
    1. Click Add Row.
    2. From the drop-down list, select Function.
    3. Select Script Log.
    4. In the Script Log Message box, type %output%.
    5. Click Save.
    6. From the Operating System drop-down list, select MacOs.

14. In the upper-right corner, click Save.
    You can now Schedule the Installation Task.

Schedule the Installation Task

After you create the task, you can schedule it to run now, when the RMM agent next connects with ConnectWise, or at a specific scheduled time.

To schedule the installation task in ConnectWise RMM:

1. Go to Automation > Tasks
2. Select the task you want to schedule.
3. Click the in the row for the task.
4. Select a Schedule Mode.
5. To select the target resources (companies and sites), click Select Targets.

6. Click Run.

View the Task Results

After the task runs, you can view the history and execution results in the Scheduled Tasks section.

To view the history and execution results in ConnectWise RMM:

1. Go to Automation > Scheduled Tasks.
2. Select the scheduled task that you want to view the history for.

3. To view the execution results, in the Resource Name column, select the endpoint of the executed task.
4. Select the task name.
   The Task Output dialog box opens.

Related Topics

Configure the WatchGuard Cloud and ConnectWise RMM Connection

Create Installation Tasks for Windows Devices from ConnectWise RMM