For customers needing to move Roaming Clients between organizations within DNSFilter, here’s a step-by-step guide. This can help ensure a smooth transition and avoid any disruptions.

Steps to migrate Roaming Clients

1. Manual Reinstallation: If you’d prefer a manual approach, you can uninstall and reinstall the Roaming Clients. After reinstallation, restart the "DNSFilter Agent" service for the clients to resume normal functionality without requiring a full system reboot.
2. Use of a Script: Alternatively, DNSFilter provides a script to handle the removal and reinstallation of Roaming Clients. You will just need to configure the $nkey variable with your Site Secret Key:

#Make sure PS is in Admin/elevate mode.

if (!([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) { Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs; exit }

Write-Host "DNS Filter Removal and Install Tool"

# Temp Directory 
$TempDir = 'C:\Temp\DNS_Filter_Install' 
 
# Checks to See if Temp Directory Exists & if not, create one.
if ((Test-Path $TempDir) -eq $false) {
    New-Item -Path $TempDir -ItemType Directory
}
 
#pass a network key into the install msiexec command
$nkey = Read-Host "Enter Network Key/Secret Site Key"
 
 
# Downloads 
$InstallerDownload = 'https://download.dnsfilter.com/User_Agent/Windows/DNS_Agent_Setup.msi' # Download for DNS Filter 
$InstallerFile = 'DNS_Agent_Setup.msi'
 ß
# Download Agent 
Invoke-WebRequest -Uri $InstallerDownload -OutFile ('{0}\{1}' -f $TempDir, $InstallerFile)
 
# Remove DNS Filter ---
Write-Host "Uninstalling..."
function Uninstall-App {
    Write-Output "Uninstalling $($args[0])"
    foreach($obj in Get-ChildItem "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall") {
        $dname = $obj.GetValue("DisplayName")
        if ($dname -contains $args[0]) {
            $uninstString = $obj.GetValue("UninstallString")
            foreach ($line in $uninstString) {
                $found = $line -match '(\{.+\}).*'
                If ($found) {
                    $appid = $matches[1]
                    Write-Output $appid
                    start-process "msiexec.exe" -arg "/X $appid /qb" -Wait
                }
            }
        }
    }
}
Uninstall-App "DNSFilter Agent"
Uninstall-App "DNS Agent"
 
start-sleep 4
 
Write-Host "Removing Registry Keys..."
 
Remove-Item -Path "HKLM:\Software\DNSFilter" -Recurse
Remove-Item -Path "HKLM:\Software\DNSAgent" -Recurse
Remove-Item "C:\Program Files\DNSFilter Agent\" -Recurse
Remove-Item "C:\Program Files\DNS Agent\" -Recurse

 
# Wait 5 Secconds 
start-sleep 5
 
 
# Install Agent
Write-Host "Installing..."
 msiexec.exe /qn /i $TempDir\$InstallerFile NKEY="$nkey"

#wait 10 seconds then cleanup.
start-sleep 10

#Remove-Item -Recurse -Force $TempDir

Troubleshooting Common Issues

• Missing DNS Resolution: If Roaming Clients aren’t resolving post-migration, restarting the agent service or the devices may be necessary

If you've managed internal Roaming Client migrations in alternative ways, you're welcome to share any insights below!