Skip to content
This repository has been archived by the owner on Nov 7, 2023. It is now read-only.

Commit

Permalink
4.0.3: TROUBLESHOOTING.md added new sections on check command and vCe…
Browse files Browse the repository at this point in the history
…nter
  • Loading branch information
DrDonk committed Oct 22, 2022
1 parent 7ba4187 commit 99501f5
Showing 1 changed file with 45 additions and 2 deletions.
47 changes: 45 additions & 2 deletions TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,49 @@
# Troubleshooting Notes

## Patch checker
It is important to re-patch ESXi after any upgrade or patches have been deployed. The status of the unlocker patches
can be checked using the `check` command in the unlocker folder.

If the patch is installed and matches the current ESXi version, the output would look like this but the version numbers
may differ on your host depending on any patches installed.
```
VMware ESXi Unlocker 4.0.3
==========================
(c) 2011-2022 David Parsons
Checking unlocker...
Current version of ESXi: VMware ESXi 7.0.3 build-20328353
Patch built for ESXi: VMware ESXi 7.0.3 build-20328353
Checking VMTAR loaded...
apple.v00 loaded
Checking vmx vSMC status...
/bin/vmx
/bin/vmx-debug
/bin/vmx-stats
vmx patched
Checking smcPresent status...
smcPresent = true
```
If the patch is installed and does _*NOT*_ match the current ESXi version, the output would look like this and an error
is displayed. You must relock, reboot and unlock the host to ensure patches are applied to the correct version.

```
VMware ESXi Unlocker 4.0.3
==========================
(c) 2011-2022 David Parsons
Checking unlocker...
Current version of ESXi: VMware ESXi 7.0.3 build-20328353
Patch built for ESXi: VMware ESXi 7.0.3 build-20036589
>>> ERROR: Mis-matched files please relock/unlock to update patches <<<
```

## VMware vCenter
The unlocker from 4.0.3 should allow macOS guests to be started from vCenter on the patched host. If you get an error
in vCenter you may need to do the following:
1. Disconnect and reconnect the ESXi host in vCenter
2. Remove and re-add the ESXi host in vCenter

## Set a specific macOS Guest resolution

Installing the VMWare Tools should allow different video modes to be selected. If you have already installed them and still does not change resolution you can try this. Open Terminal and run:
Expand All @@ -10,7 +54,7 @@ where width and height are the pixel size you want. For example to get 1440x900:

`sudo /Library/Application Support/VMware Tools/vmware-resolutionSet 1440 900`

### AMD CPUs
## AMD CPUs
A patched macOS AMD kernel must be used to run on older AMD systems, but there is a workaround if you have a modern
AMD Ryzen CPU. The unlocker cannot patch this but we can recommend settings for the VMX file that allows macOS to
run on recent AMD CPUs. The tests are being recorded in this issue, and it would be useful if more can report
Expand All @@ -35,4 +79,3 @@ vpmc.enable = "FALSE"
3. Make sure there are no duplicate lines in the VMX file or the guest will not start and a dictionary error will
be displayed by VMware.
4. You can now install and run macOS as a guest.

0 comments on commit 99501f5

Please sign in to comment.