How to Fix Apple Remote Desktop that was Broken by Apple’s Recent Security Update: Reinstall RemoteDesktopClient 3.9.3 on Client Machines Using SSH

2018-05-20 • SEND FEEDBACK |
Related: Apple, Apple Core Rot, command line, How-To, security, Terminal.app

Apple’s recent security update broke Apple Remote Desktop client machines (machines being remotely managed). Installing it on those machines corrupts the setup somehow, making the machine unreachable by the management application.

The problem is particularly egregious when physical access to the machine is not available. For me that would mean a bare minimum of 5 hours with security checks with an escort into a server room accompanied by a representative from my ISP—not exactly the way I would want to spend my day, nor easy to arrange quickly.

Why a security update by Apple would not also install the required RemoteDesktopClient software is best explained by failure to test the update properly—standard practice at Apple these days—witness recent macOS releases and security bugs of the worst kind (exposing passwords). The software testing and release process at Apple has set new lows in quality metrics in the recent 6 months.

Installing RemoteDesktopClient remotely via ssh

It’s actually quite simple once the hours are spent on the internet searching for the solution.

Fix the problem by updating RemoteDesktopClient to version 3.9.3. Lacking physical access to the machine, that means using ssh into the Mac for a remote shell. You did enable ssh didn’t you?

Definition: the “client machine” is the machine being managed remotely by Apple Remote Desktop. Use ssh to get a shell on this machine.

#1 see what software is available. In this case, RemoteDesktopClient must be reinstalled, and version 3.9.3 is what is needed.

# see what software is available
diglloyd $ sudo softwareupdate -l
Software Update Tool
Copyright 2002-2015 Apple Inc.
Finding available software
Software Update found the following new or updated software:
* RemoteDesktopClient-3.9.3
Remote Desktop Client Update (3.9.3), 8587K [recommended]
* iTunesX-12.7.4
iTunes (12.7.4), 272816K [recommended]

#2 Install the update.

diglloyd $ sudo softwareupdate -i RemoteDesktopClient-3.9.3
Software Update Tool
Copyright 2002-2015 Apple Inc.
Downloading Remote Desktop Client Update
Downloaded Remote Desktop Client Update
Installing Remote Desktop Client Update
Done with Remote Desktop Client Update
Done.