Subscribe to Help Center RSS FeedThis article outlines how to gather JumpCloud Agent logs from Mac in macOS Recovery. This may be required if the user is locked out of the device and only macOS Recovery is accessible.
You'll need an external USB storage device like a flash drive or external hard drive. Without an external drive, you won't be able to copy the log files off of the device's internal storage.
To copy agent logs in macOS Recovery Mode:
If you've enforced the Recovery Lock policy, you'll need to enter the Recovery Lock password to access macOS Recovery. See Create a Mac Recovery Lock Policy to learn more.
- Boot the Mac into Recovery Mode. See Apple's Intro to macOS Recovery.
- Launch Disk Utility from the menu options and then mount the Macintosh - Data volume.
- If the disk has FileVault enabled you'll be prompted to unlock it.
- Quit Disk Utility.
- In the top menu bar select Utilities > Terminal.
- Enter the following command in Terminal to display the names of all the mounted volumes:
ls /Volumes- You can find the name of your external USB drive here. Ensure you remember the name or write it down as you'll need this for step 8 to copy the log files off to the drive.
- To change into the directory holding the logs, type in the following into terminal:
cd /Volumes/Macintosh\ HD\ -\ Data/private/var/log - Then display all of the files under this folder by typing in the following into terminal:
ls - Copy the log files by entering the following command:
cp jcagent.log /Volumes/YOURDRIVENAME - Check that the file successfully copied by typing:
ls /Volumes/YOURDRIVENAME
You can then review the jcagent.log for any issues or submit the jcagent.log and a description to our JumpCloud Support Team to help triage the cause of the lockout or other issues.
Learn More