1.2 Install Agent for Windows

RoboShadow Agent Deployment Guide for IT Managers

Introduction

This guide provides IT Managers with detailed steps and considerations for deploying the RoboShadow Agent on Windows machines. It is designed to ensure a smooth and successful rollout by addressing critical elements such as the OrganisationID, deployment strategies, and best practices for various scenarios.

Key Considerations

OrganisationID

• Importance: The OrganisationID is crucial for the agent to report data correctly to the RoboShadow portal. Without it, no data will be displayed.

• Planning: Plan the organisational structure before deployment. Changing organisations post-deployment is complex due to the DeviceId and public key being tied to the initial OrganisationID.

Deployment Methods

Golden Image Deployment

1. Recommendation:

   • Do not install the RoboShadow Agent on the golden image. Deploy the agent post-cloning to avoid issues with OrganisationID, DeviceId, and Public Key.

2. If Installing on Golden Image:

   • Follow these steps to clean the image before running sysprep:

     • Ensure Updater is Installed: Verify that the updater component of RoboShadow is installed.

     • Delete OrganisationID Registry Key:

       • HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Rubicon\Agent\OrganisationId

       • HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Control\OrganisationId

     • Delete DeviceId Registry Key:

       • HKEY_LOCAL_MACHINE\Software\RoboShadowLtd\Control\DeviceId

     • Delete Public Key:

       • C:\ProgramData\RoboShadow\Rubicon\Control\Data\PublicKey

Intune Deployment

o   Navigate to https://portal.roboshadow.com/devices and select the organisation you wish to deploy the RoboShadow Agent via InTune, using the organisation drop down menu.

o   Click the “Deploy RoboShadow With InTune”

o   Follow the on-screen setup guide.

RMM Deployment

• To deploy the agent via RMM with an ORGID variable use the following PowerShell script:

# Set a flag to indicate if OrgID is set
$haveSetOrgId = $True

# Attempt to retrieve the version from the registry
$version = (Get-ItemProperty -Path "HKLM:\SOFTWARE\RoboShadowLtd\Rubicon\Agent" -Name "Version" -ErrorAction SilentlyContinue).Version

# Check if OrgID is set and if the version is not found or less than 4
if ($haveSetOrgId -and (-not $version -or [int]($version -split '\.')[0] -lt 4)) {
    # Define the arguments for msiexec
    $arguments = @(
        "/i", "https://cdn.roboshadow.com/GetAgent/RoboShadowAgent-x64.msi",
        "/qb", "/norestart", "ORGANISATION_ID=$OrgID"
    )

    # Start the process to install the RoboShadow agent
    Start-Process -FilePath "C:\Windows\System32\msiexec.exe" -ArgumentList $arguments -Wait
}

When you run the script it will ask for the ORGID to be entered

MSI-Based Installation

1. Preparation:

   • Ensure you have the correct OrganisationID.

   • Plan your organisational structure in advance.

2. PowerShell Installation:

   • Download the installation PowerShell script:

   • https://raw.githubusercontent.com/roboshadow/RolloutScripts/master/DeployAgent/deploy.ps1

   • Replace YOUR_ORGANISATION_ID with the organisationID from the correct organisation in the Portal. Note changing this after install is not trivial.

   • Organisation ID can be found here: https://portal.roboshadow.com/account/organisations

   • Set $haveSetOrgId to $True

   • Save and run the PowerShell Script

Summary

By following these guidelines, IT Managers can ensure a successful deployment of the RoboShadow Agent across their Windows environments. Proper planning and adherence to the recommended practices will mitigate common issues and enhance the effectiveness of the rollout.