diff --git a/docs/cwa/monitors/uninstall-datto-backup-tool.md b/docs/cwa/monitors/uninstall-datto-backup-tool.md new file mode 100644 index 000000000..47549b6b8 --- /dev/null +++ b/docs/cwa/monitors/uninstall-datto-backup-tool.md @@ -0,0 +1,50 @@ +--- +id: '34ba8b59-6973-43e5-8729-d821f669a00c' +slug: /34ba8b59-6973-43e5-8729-d821f669a00c +title: 'Uninstall Datto Backup Tool' +title_meta: 'Uninstall Datto Backup Tool' +keywords: ['datto', 'cloud', 'continuity'] +description: 'This monitor detects the online Windows agent where the Datto Windows Agent or Datto Cloud Continuity is installed and uninstalls it' +tags: ['datto'] +draft: false +unlisted: false +--- + +## Summary +This monitor runs every hour to check for the online Windows agents , to uninstall the Datto backup tools where the client EDF `Uninstall Datto Backup tool` option are selected, and location/computer-level exclusion EDF `Exclude Datto Backup tool Removal` are not checked. + +It also ensures the agent has the Datto Windows Agent or Datto Cloud Continuity installed. + +It has an alert template "△ Custom - Execute Script - Uninstall Datto Backup Tool" applied. + +## EDFs +| Name | Level | Type | Section | Description | +| --------- | --------- | ------------ | --------- | -------------------------------------------- | +| `Uninstall Datto Backup tool` | Client | Drop-down | Datto | This dropdown allows to select the `Datto Windows Agents` or `Datto Cloud Continuity` or `All` for uninstallation ![Client-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image7.webp)| +| `Exclude Datto Backup tool Removal` | Location | Checkbox | Exclusions | This excludes the location from the uninstallation of Datto Windows Agents or Cloud Continuity ![Location-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image9.webp)| +|`Exclude Datto Backup tool Removal` | Computer | Checkbox | Exclusions | This exclude the computer from the uninstallation of Datto Windows Agents or Cloud Continuity ![Computer-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image8.webp)| + +## Dependencies + +- [Script - Uninstall Datto Backup Tool](/docs/c3ad2c46-6bae-4df4-980a-f937faf56dbc) +- **Alert Template** `△ Custom - Execute Script - Uninstall Datto Backup Tool` +- [Solution - Uninstall Datto Backup Tool](/docs/cd3e8104-0edb-4bcf-933c-eb8d6e3b5022) + +## Target + +Windows OS + +## Implementation + +- Import the monitor from the ProSync plugin +- Set the **Alert Template** `△ Custom - Execute Script - Uninstall Datto Backup Tool`. +- Select the option from the client level-EDF `Uninstall Datto Backup Tool` where the Datto Windows Agent or Datto Cloud Continuity is required to uninstall. + ![Client-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image7.webp) + +- If the location or any computer required to be excluded from the detection of the monitor to perform the uninstallation of Datto Windows Agent or Datto Cloud Continuity, then check the location/computer level exclusion EDF `Exclude Datto Backup tool Removal` + + ![Location-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image9.webp) + + ![Computer-EDF](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image8.webp) + +- Once EDFs are set, the monitor will detect 50 online Windows agents every hour where the Datto Windows Agent or Datto Cloud Continuity are installed and perform the uninstallation by triggering the script [Uninstall Datto Backup Tool](/docs/c3ad2c46-6bae-4df4-980a-f937faf56dbc) using **Alert Template** `△ Custom - Execute Script - Uninstall Datto Backup Tool`. \ No newline at end of file diff --git a/docs/cwa/scripts/uninstall-datto-backup-tool.md b/docs/cwa/scripts/uninstall-datto-backup-tool.md new file mode 100644 index 000000000..34943c5e3 --- /dev/null +++ b/docs/cwa/scripts/uninstall-datto-backup-tool.md @@ -0,0 +1,53 @@ +--- +id: 'c3ad2c46-6bae-4df4-980a-f937faf56dbc' +slug: /c3ad2c46-6bae-4df4-980a-f937faf56dbc +title: 'Uninstall Datto Backup Tool' +title_meta: 'Uninstall Datto Backup Tool' +keywords: ['datto', 'cloud', 'continuity'] +description: 'This script uninstalls the Datto Windows Agent or Datto Cloud Continuity or both, depending on the option selected at the "Uninstall Datto Backup Tool" client-level EDF. It then grabs the quietuninstallstring from the registry of the installed application.' +tags: ['datto', 'backup'] +draft: false +unlisted: false +--- + +## Summary +This script uninstalls the Datto Windows Agent or Datto Cloud Continuity or both, depending on the option selected at the `Uninstall Datto Backup Tool` client-level EDF. It then grabs the quietuninstallstring from the registry of the installed application. + +## File Hash + +- **File Path:** `C:\ProgramData\_automation\script\DattoUninstall\DattoUninstall.ps1` +- **File Hash (SHA256):** `80E436DEA2AF5FFE4EF8141CD4595BAAA305519EF265B9EEC663CF24F074BF62` +- **File Hash (MD5):** `0DAFD4820F6D5871A28357EC7A980195` + +## Sample Run + +**First Run:** Execute the script with the user parameter `SetEnvironment` as 1 to import the EDFs needed for the script. +![Sample Run](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image5.webp) + +**Regular Run:** +![Sample Run](../../../static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image6.webp) + + +## Dependencies + +[Solution - Uninstall Datto Backup Tool](/docs/cd3e8104-0edb-4bcf-933c-eb8d6e3b5022) + +## EDFs + +| Name | Level | Section | Description | +|-------------------------------|---------|---------|-------------------------------------------------------------------------------------------------------| +|Uninstall Datto Backup Tool | Client | Datto | Select the application to uninstall.
Available Options:
- Datto Windows Agent
- Datto Cloud Continuity
- All | +|Exclude Datto Backup Tool Removal |Location |Exclusions |This excludes the location from the uninstallation of Datto Windows Agents or Cloud Continuity. | +|Exclude Datto Backup Tool Removal | Computer | Exclusions | This excludes the device from the uninstallation of Datto Windows Agents or Cloud Continuity. | + + +## Process + +- It checks if the agent has `Datto Windows Agent` or `Datto Cloud Continuity` or both installed, depending on the option selected at the `Uninstall Datto Backup Tool` client-level EDF. +- If detected, then it writes a PS1 on the agent with file hashes (shown above) that can be used to whitelist if any third-party blocking application is installed in the environment that can restrict the PowerShell execution. +- The PS1 fetches the quiet uninstall command from the application registry and executes it using the system account, and uninstalls the application. +- It includes proper error handling + +## Output + +- Script Log \ No newline at end of file diff --git a/docs/solutions/uninstall-datto-backup-tool.md b/docs/solutions/uninstall-datto-backup-tool.md new file mode 100644 index 000000000..4cabd7ff5 --- /dev/null +++ b/docs/solutions/uninstall-datto-backup-tool.md @@ -0,0 +1,30 @@ +--- +id: 'cd3e8104-0edb-4bcf-933c-eb8d6e3b5022' +slug: /cd3e8104-0edb-4bcf-933c-eb8d6e3b5022 +title: 'Uninstall Datto Backup Tool' +title_meta: 'Uninstall Datto Backup Tool' +keywords: ['datto', 'cloud', 'continuity'] +description: 'This solution contains the contents that perform the Datto Windows Agent or Datto Cloud Continuity uninstallation' +tags: ['datto'] +draft: false +unlisted: false +--- + +## Purpose + +This solution contains the contents that perform the Datto Windows Agent or Datto Cloud Continuity uninstallation on CW Automate. + +## Associated Content + +| Content | Type | Function | +|-----------------------------------------------------|-----------------------------------------------------------|--------------------------------------------------------| +| [Uninstall Datto Backup Tool](/docs/c3ad2c46-6bae-4df4-980a-f937faf56dbc) | Script | This script uninstalls the Datto Windows Agent or Datto Cloud Continuity or both, depending on the option selected at the `Uninstall Datto Backup tool` client-level EDF. | +| [Uninstall Datto Backup tool](/docs/34ba8b59-6973-43e5-8729-d821f669a00c) | Internal Monitor | This monitor runs every hour to check for the online Windows agents, where the client EDF `Uninstall Datto Backup tool` option are selected, and location/computer-level exclusion EDF `Exclude Datto Backup tool Removal` are not checked, to uninstall the application. | +| △ Custom - Execute Script - Uninstall Datto Backup Tool | Alert Template | This alert template triggers the [Script - Uninstall Datto Backup Tool](/docs/c3ad2c46-6bae-4df4-980a-f937faf56dbc) on the detected agents of the monitor to perform the uninstallation of the Datto Windows Agent or Datto Cloud Continuity | + +## Implementation + +- Import the [Script - Uninstall Datto Backup Tool](/docs/c3ad2c46-6bae-4df4-980a-f937faf56dbc) +- Import the [Monitor -Uninstall Datto Backup tool](/docs/34ba8b59-6973-43e5-8729-d821f669a00c) +- Import the **Alert Template** `△ Custom - Execute Script - Uninstall Datto Backup Tool` +- Follow the [Monitor -Uninstall Datto Backup tool](/docs/34ba8b59-6973-43e5-8729-d821f669a00c) documentation to enable its implementation. \ No newline at end of file diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image.webp new file mode 100644 index 000000000..9fbc07cf8 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image2.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image2.webp new file mode 100644 index 000000000..b0a82f545 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image2.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image3.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image3.webp new file mode 100644 index 000000000..cacc51749 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image3.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image4.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image4.webp new file mode 100644 index 000000000..c7f48d222 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image4.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image5.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image5.webp new file mode 100644 index 000000000..c362fd44f Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image5.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image6.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image6.webp new file mode 100644 index 000000000..4594fc894 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image6.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image7.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image7.webp new file mode 100644 index 000000000..db6f4a3ef Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image7.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image8.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image8.webp new file mode 100644 index 000000000..cc7392e1d Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image8.webp differ diff --git a/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image9.webp b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image9.webp new file mode 100644 index 000000000..77cea8654 Binary files /dev/null and b/static/img/docs/955123e8-cb90-480c-8de5-8ac81d41bdd6/image9.webp differ