Troubleshoot: Windows Agent Freezes During Install

A device can't be managed in JumpCloud until the agent has been successfully installed. If you encounter issues, use the following suggestions to get the agent installed.

Installation Stalls After Connect Key is Entered

The Windows Agent installation can stall after entering the connect key. After you type or paste in the connect key and click Next, the agent installation process stops responding.

If the agent installation wizard becomes unresponsive, complete the following steps:

1. Force the installation to stop using Task Manager:
   1. Press the Ctrl + Alt + Delete keys at the same time.
   2. Select Task Manager.
   3. Click on the agent installation application.
   4. Click End task.
2. Reboot the device.
3. Log in to the Admin Portal and go to DEVICE MANAGEMENT > Devices. If the device is listed with a red checkmark, is inactive, is blank or shows no information, delete the device.

After following these steps, you can try to install the agent again using the installation application. If you continue to have issues, try to install the agent using the command line. See Install or Reinstall the Agent with PowerShell.

Installer Freezes During Uninstall or Reinstall

Symptoms

When uninstalling and reinstalling the JumpCloud Agent on a Windows device, the installer freezes during the setup or installation steps with a “Please wait while Windows configures JumpCloud Agent v[version]“ message.

You may also see an error pop up within Windows asking for the location of the missing installation package or MSI with the message “The feature you are trying to use is on a network resource that is unavailable. Click OK to try again, or enter an alternate path to a folder containing the installation package ‘jcagent-msi-signed.msi’ in the box below.” This error may appear even though the MSI is within the C:\Windows\Temp directory indicated.

Cause

If the JumpCloud Agent is having issues installing or reinstalling and freezes or asks for an alternative path for the installation, this may be because:

• the device has been offline for some time;
• certificates have expired; or
• the Agent could not update to the latest version.

Resolution

To resolve either of these issues, download and run the following script in an elevated PowerShell prompt on your Windows device to remove the necessary registry keys, files, and Windows service to allow the JumpCloud Agent to be reinstalled: UninstallWindowsAgent.ps1.

The following data are removed by this script:

• Registry Keys:
  • HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Products<JumpCloud Agent GUID>
  • HKCR:\Installer\Products<JumpCloud Agent GUID>
  • HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall<JC MSI Installation ID>
  • HKLM:\Software\JumpCloud
  • HKLM:\SOFTWARE\Classes\Installer\Products<JumpCloud Agent GUID>
• Files and Folders:
  • C:\Program Files\JumpCloud
    • The folder ‘cpoidc’ is not removed.
    • The file ‘JumpCloudCredentialProvider-X.XXX.X.dll’ is not removed.
• Services:
  • The JumpCloud Agent service and the associated executable are removed.